Hilfe
Einloggen

Adyen auf Shopify verwenden

Adyen ist ein Zahlungs-Gateway für große Unternehmen zur Akzeptanz von Zahlungen. Händler:innen mit einem bestehenden Adyen-Konto können Adyen als Zahlungsabwickler direkt in Shopify verwenden.

Du kannst Shopify einschließlich der Zahlungsdaten von Adyen in deine Software für Enterprise Resource Planning (ERP) integrieren, um eine reibungslosere Datenverwaltung und Synchronisierung zwischen deinen Systemen zu gewährleisten.

Auf dieser Seite

Voraussetzungen für Adyen bei Shopify

Bevor du Adyen bei Shopify verwenden kannst, musst du die folgenden Voraussetzungen erfüllen:

  • Du musst über ein Enterprise-Abo verfügen.
  • Dein Unternehmen muss je nach deiner Region bestimmte Zulassungskriterien erfüllen.
  • Du musst ein bestehendes Adyen-Konto eingerichtet haben, bevor du die Integration aktivieren kannst.
  • Dein Shop muss Shopify Checkout verwenden.

Der Zugang zu Adyen erfolgt nur nach Genehmigung und kann nicht garantiert werden. Um die Aktivierung von Adyen anzufordern, wende dich an deine:n Vertriebsmitarbeiter:in oder Customer Success Manager (CSM) von Shopify. Wenn du keinen Customer Success Manager hast, kannst du den Shopify Support kontaktieren, um dich über die nächsten Schritte zu informieren.

Inkompatible oder nicht verfügbare Funktionen für Adyen bei Shopify

Bestimmte Funktionen sind bei der Integration von Adyen in Shopify nicht verfügbar oder inkompatibel:

  • Klarna und PayPal sind nicht verfügbar: Klarna und PayPal werden über die Adyen-Integration bei Shopify nicht als Zahlungsmethoden unterstützt.
  • Nicht alle lokalen Zahlungsmethoden sind verfügbar: Die lokalen Zahlungsmethoden (LPMs), die über die Adyen-Integration bei Shopify angeboten werden, variieren je nach Region und umfassen möglicherweise nicht alle Methoden, die Adyen direkt anbietet. Die vollständige Liste findest du in der Dokumentation zu den Zahlungsmethoden von Adyen.
  • Shopify-Tools zur Betrugsprävention sind nicht verfügbar: Bei der Verwendung von Adyen hast du keinen Zugriff auf die Betrugs-Tools von Shopify Payments wie die Verwaltung von Streitigkeiten, den Schutz vor Kartentests und Betrugsanalysen. Adyen bietet eigene Tools zur Betrugsprävention an, die möglicherweise gegen eine zusätzliche Gebühr verfügbar sind. Du kannst weiterhin die Betrugsanalyse von Shopify und Shopify Flow verwenden, um benutzerdefinierte Regeln einzurichten.
  • Managed Markets wird nicht unterstützt: Managed Markets (Dienst als eingetragener Händler) erfordert Shopify Payments und kann nicht mit Adyen verwendet werden.
  • Manuelle Zahlungsmethoden unterstützen keine mehreren Währungen: Die Funktion für mehrere Währungen funktioniert nur bei Kreditkarten. Manuelle Zahlungsmethoden wie Überweisung oder Nachnahme verwenden standardmäßig die Shop-Währung.

Adyen bei Shopify aktivieren

Bevor du Adyen aktivieren kannst, musst du die Genehmigung deiner Vertriebsmitarbeiter:in oder deines Customer Success Managers bei Shopify einholen. Nachdem du die Genehmigung erhalten hast, richte ein Konto bei Adyen ein und installiere und aktiviere dann die Zahlungs-App.

Schritte:

  1. Gehe in deinem Shopify-Adminbereich zu Einstellungen > Zahlungen.

  2. Klicke im Abschnitt Shopify Payments auf Verwalten.

  3. Klicke auf Zu einem externen Anbieter wechseln und dann zur Bestätigung erneut auf Zu einem externen Anbieter wechseln.

  4. Wähle Adyen Payments - Credit Cards aus der Liste der verfügbaren Zahlungsanbieter aus. Wenn du nicht für die Nutzung von Adyen zugelassen bist, wird die Option Adyen Payments - Credit Cards nicht in der Liste der Zahlungsanbieter angezeigt.

  5. Klicke auf Konto verwalten.

  6. Gestatte der Adyen-Zahlungserweiterung, falls erforderlich, auf die Daten deines Shops zuzugreifen und diese zu ändern.

  7. Wähle auf der Seite Adyen-Zahlungskonfiguration das Adyen-Konto aus, das du mit deinem Shopify-Shop verwenden möchtest.

  8. Befolge die Anweisungen im Adyen Customer Area, um die Adyen-Zahlungs-App für Shopify zu installieren und deine Integration zu testen.

Adyen-Einstellungen konfigurieren

Nachdem du Adyen aktiviert hast, kannst du die Einstellungen an deine geschäftlichen Anforderungen anpassen.

Einstellungen für die Zahlungserfassung konfigurieren

Die Zahlungserfassung legt fest, wann Gelder von deiner Kundschaft eingezogen werden.

Schritte:

  1. Gehe in deinem Shopify-Adminbereich zu Einstellungen > Zahlungen.

  2. Klicke im Bereich der Zahlungsanbieter auf Verwalten.

  3. Wähle deine bevorzugte Erfassungsmethode:

    • Automatische Erfassung: Zahlungen werden sofort bei Auftragserteilung erfasst.
    • Manuelle Erfassung: Zahlungen werden autorisiert, aber erst dann eingezogen, wenn du die Erfassung manuell vornimmst.
    • Erfassung bei Ausführung: Zahlungen werden erfasst, wenn du die Bestellung ausführst.

Lokale Zahlungsmethoden installieren

Um lokale Zahlungsmethoden über Adyen anzubieten, muss die App Adyen Payments - Credit Cards als dein primäres Gateway installiert sein. Wenn du die Kreditkarten-App nicht installiert hast, kannst du keine lokalen Zahlungsmethoden installieren.

Nachdem die Kreditkarten-App installiert ist, kontaktiere deinen Customer Success Manager oder deine:n Shopify-Vertriebsmitarbeiter:in, um Zugriff auf lokale Zahlungsmethoden für deine Region zu erhalten.

Ratenzahlungen per Kreditkarte für Brasilien und Mexiko konfigurieren

Wenn du an Kundschaft in Brasilien oder Mexiko verkaufst, kannst du beim Checkout Ratenzahlungen per Kreditkarte anbieten.

Bevor du Ratenzahlungen konfigurierst, überprüfe, ob die folgenden Voraussetzungen erfüllt sind:

  • Für Brasilien muss dein Markt die Währung BRL (Brasilianischer Real) verwenden.
  • Für Mexiko muss dein Markt die Währung MXN (Mexikanischer Peso) verwenden.
  • Die App Adyen Payments - Credit Cards muss als dein primäres Gateway installiert sein.

Schritte:

  1. Gehe in deinem Shopify-Adminbereich zu Einstellungen > Zahlungen.

  2. Klicke im Bereich Adyen Payments - Credit Cards auf Verwalten.

  3. Klicke auf Weitere Aktionen und dann auf Verwalten.

  4. Füge in der Adressleiste deines Browsers ?credit_card_installments=1 ans Ende der URL hinzu und drücke dann die Eingabetaste auf deiner Tastatur.

  5. Die Konfigurationsoptionen für Ratenzahlungen werden unten auf der Seite angezeigt.

  6. Konfiguriere die maximale Anzahl von Raten und die Mindestzahlung pro Rate. Für Ratenzahlungen in Brasilien können 2 bis 12 Raten konfiguriert werden. Für Ratenzahlungen in Mexiko können 3, 6, 9, 12 oder 18 Raten konfiguriert werden.

  7. Klicke auf Speichern.

Adyen mit Shopify Markets verwenden

Adyen ist mit Shopify Markets kompatibel. Wenn Shopify Markets aktiviert ist, werden Transaktionen in der Währung verarbeitet, die Shopify an Adyen sendet.

Um mit Adyen in mehreren Währungen zu verkaufen, stelle sicher, dass die folgenden Anforderungen erfüllt sind:

  • Die Währungen deiner Märkte müssen auch in deinem Adyen-Konto konfiguriert sein.
  • Wenn die Währung zu den Abrechnungswährungen von Adyen für deine Region gehört, rechnet Adyen das Guthaben in derselben Währung ab.

Integration mit Testbestellungen überprüfen

Bevor du Live-Zahlungen akzeptierst, teste deine Adyen-Integration mithilfe von Bestellentwürfen, um sicherzustellen, dass Zahlungen korrekt verarbeitet werden.

Schritte:

  1. Gehe in deinem Shopify-Adminbereich zu Bestellungen > Entwürfe.

  2. Klicke auf Bestellung erstellen.

  3. Füge ein Produkt und Kundeninformationen hinzu.

  4. Klicke auf Zahlung erfassen und wähle dann deine bevorzugte Zahlungsmethode aus.

  5. Schließe den Zahlungsvorgang ab und überprüfe, ob die Bestellung sowohl in Shopify als auch in deinem Adyen-Portal korrekt angezeigt wird.

Bestellungen bei Verwendung von Adyen abgleichen

Wenn eine Bestellung über Adyen bezahlt wird, sendet Shopify für diese Transaktion eine merchantReference-Nummer an Adyen. Die merchantReference-Nummer ist eine eindeutige ID, die du zum Abgleichen von Bestellungen verwenden kannst.

Die merchantReference-Nummer besteht aus zwei Teilen:

  • Shopify-Shop-ID: Der erste Teil der Nummer identifiziert deinen Shopify-Shop.
  • Zahlungs-ID: Der zweite Teil ist die Zahlungs-ID für die jeweilige Transaktion.

Zum Beispiel könnte die merchantReference-Nummer als 12345-67890 angezeigt werden. In diesem Beispiel ist 12345 die Shopify-Shop-ID und 67890 die Zahlungs-ID.

Die Zahlungs-ID für eine Transaktion wird in der Bestellchronik in deinem Shopify-Adminbereich angezeigt.

Um Transaktionen abzugleichen, suche in deinem Shopify-Adminbereich nach dem Zahlungs-ID-Teil der merchantReference-Nummer. Die Suchfunktion liefert die mit der Zahlungs-ID verknüpfte Bestellung.

Überlegungen zum Bestellabgleich

Wenn du die Bestellchronik und die Zahlungs-ID verwendest, um Bestellungen mit Transaktionen in Adyen abzugleichen, beachte die folgenden Hinweise:

  • Autorisierungsschlüssel einer Bestellung finden: Der Autorisierungsschlüssel wird in der Bestellchronik in deinem Shopify-Adminbereich nicht aktualisiert, wenn eine Transaktion über Adyen abgeschlossen wird. Um den Autorisierungsschlüssel einer Bestellung abzurufen, rufe dein Adyen-Konto auf.
  • Ausstehender Zahlungsstatus: Die Verarbeitung von Zahlungen kann mehrere Tage dauern. Wenn keine Antwort vom Zahlungsanbieter eingeht, werden Zahlungen möglicherweise als Ausstehend angezeigt. Wenn sich der Zahlungsstatus zu Bezahlt ändert, kannst du die Bestellung ausführen.
  • Abgelaufener Zahlungsstatus: Wenn sich der Zahlungsstatus zu Abgelaufen ändert, bestätige, dass die Zahlung nicht in deinem Adyen-Konto eingegangen ist, bevor du die Zahlung erneut bei deiner Kundschaft anforderst. Der Zahlungsstatus ändert sich in Abgelaufen, um anzuzeigen, dass die Zahlung nicht verarbeitet werden konnte.

Häufige Adyen-Probleme beheben

Wenn du Probleme mit deiner Adyen-Integration hast, sieh dir die folgenden häufigen Probleme und Lösungen an.

Dies ist das erwartete Verhalten bei lokalen Zahlungsmethoden (Local Payment Methods, LPMs) wie AliPay und WeChat Pay. Die Zahlung geht in einen ausstehenden Status über, bis die Zahlung aufseiten des Zahlungsverarbeiters erfolgreich ist. Nachdem die Zahlung bestätigt wurde, wird der Status sowohl in Adyen als auch in Shopify aktualisiert.

Was zu tun ist: Warte, bis die Zahlung verarbeitet wurde. Die meisten Zahlungen werden innerhalb weniger Minuten aktualisiert, manche können jedoch bis zu 10–15 Minuten dauern.

Dies kann passieren, wenn ein:e Kund:in eine Zahlung initiiert, die eine 3D Secure-Verifizierung erfordert, den Vorgang jedoch abbricht oder Probleme auftreten, die außerhalb der Kontrolle von Shopify liegen.

Was zu tun ist:

  1. Überprüfe dein Adyen-Portal, um zu bestätigen, dass die Zahlung erfasst wurde.
  2. Wenn die Zahlung erfasst wurde, erstelle einen Bestellentwurf in Shopify.
  3. Markiere den Bestellentwurf als bezahlt und führe ihn entsprechend aus.
  4. Wenn die Zahlung nicht erfasst wurde, ist keine Aktion erforderlich.

Dies kann auftreten, wenn ein:e Kund:in die 3D Secure-Verifizierung abschließt, aber nicht ordnungsgemäß zu Shopify zurückgeleitet wird. Auf dem Kontoauszug der Kundschaft sind dann möglicherweise zwei Autorisierungsversuche zu sehen.

Was zu tun ist:

  1. Überprüfe in deinem Adyen-Portal, wie viele Zahlungen tatsächlich erfasst wurden.
  2. Wenn nur eine Zahlung erfasst wurde, weise die Kundschaft darauf hin, dass es sich bei der zweiten Belastung um eine ausstehende Autorisierung handelt, die von der Bank automatisch freigegeben wird.
  3. Wenn zwei Zahlungen erfasst wurden, erstatte die doppelte Transaktion in deinem Adyen-Portal zurück.

Wenn Adyen für die Verarbeitung einer abgelehnten Zahlung länger als erwartet braucht, ändert sich der Zahlungsstatus möglicherweise in „Ausstehend“ und die Bestellung wird in Shopify erstellt.

Was zu tun ist:

  1. Überprüfe den Zahlungsstatus sowohl in deinem Shopify-Adminbereich als auch in deinem Adyen-Portal.
  2. Wenn die Zahlung fehlgeschlagen ist, kannst du die Bestellung entweder stornieren oder die Zahlung erneut von der Kundschaft anfordern.

Dies kann auftreten, wenn eine Sitzung für eine lokale Zahlungsmethode abläuft, der/die Kund:in in Adyen jedoch weiterhin autorisiert ist.

Was zu tun ist:

  1. Warte 10 bis 15 Minuten, bis der Zahlungsstatus zwischen Adyen und Shopify synchronisiert ist.
  2. Wenn die Zahlung in Adyen als abgeschlossen angezeigt wird, die Bestellung in Shopify aber nach 15 Minuten immer noch nicht erstellt wurde, erstelle einen Bestellentwurf und markiere diesen manuell als bezahlt.

Dieser Fehler weist normalerweise darauf hin, dass dein Shop die Berechtigungsvoraussetzungen für die Nutzung von Adyen nicht erfüllt.

Was zu tun ist:

  1. Überprüfe, ob dein Shop über ein Enterprise-Abo verfügt.
  2. Wende dich an deinen Merchant Success Manager (CSM) oder deine:n Shopify-Vertriebsmitarbeiter:in, um die Berechtigung und Aktivierung zu besprechen.
  3. Wenn du keinen Merchant Success Manager hast, kontaktiere den Shopify Support, um Hilfe zu den nächsten Schritten zu erhalten.

Wenn deiner Kundschaft keine lokalen Zahlungsmethoden angezeigt werden, stelle sicher, dass die folgenden Anforderungen erfüllt sind:

  • Die App Adyen Payments - Credit Cards muss als dein primäres Gateway installiert sein. Ohne sie kannst du keine lokalen Zahlungsmethoden verwenden.
  • Die Lieferadresse der Kundschaft muss sich in einer Region befinden, in der die lokale Zahlungsmethode verfügbar ist.
  • Die Checkout-Währung muss von der lokalen Zahlungsmethode unterstützt werden.

Was zu tun ist:

  1. Bestätige, dass die App Adyen Payments - Credit Cards installiert und aktiv ist.
  2. Überprüfe, ob deine lokalen Zahlungsmethoden in deinem Adyen-Konto korrekt konfiguriert sind.
  3. Teste den Checkout mit einer Adresse der Kundschaft in der Zielregion.

Wenn Kreditkartenraten für Kund:innen in Brasilien oder Mexiko nicht angezeigt werden, überprüfe, ob die folgenden Anforderungen erfüllt sind:

  • Für Brasilien muss der Markt die Währung BRL (Brasilianischer Real) verwenden.
  • Für Mexiko muss der Markt die Währung MXN (Mexikanischer Peso) verwenden.
  • Die App Adyen Payments - Credit Cards muss als dein primäres Gateway installiert sein.
  • Raten müssen über den URL-Parameter aktiviert werden.
  • Shop-Guthaben und externe Zahlungs-Apps für Gutscheine werden nicht verwendet (diese sind nicht mit Raten kompatibel).

Häufig gestellte Fragen

Nein. Um lokale Zahlungsmethoden mit Adyen zu verarbeiten, muss die App Adyen Payments - Credit Cards als dein primäres Gateway installiert sein. Adyen verlangt diese Konfiguration und überwacht die Nutzung, um eine teilweise Integration zu verhindern.

Nein. Die Payment Service Provider (PSP)-Referenz von Adyen wird in Shopify nicht gespeichert. Die Shopify-Transaktionsreferenz wird jedoch als Teil des Felds „merchantReference“ in deinem Adyen-Portal gespeichert, welches du für den Abgleich verwenden kannst.

Ja, die Zahlungs-App von Adyen unterstützt Abonnements über in den Shopify Checkout integrierte Abonnement-Apps. Wenn du bestehende Abonnements zu Adyen migrieren musst, wende dich an deinen Merchant Success Manager (CSM) oder an deine:n Shopify-Vertriebsmitarbeiter:in, um Migrationsoptionen zu besprechen.

Ja, Apple Pay (für iOS) und Google Pay (für Android) sind über die Adyen-Integration verfügbar.

Ja, die Adyen-App unterstützt Post-Purchase-Upselling über die Post-Purchase-Checkout-Erweiterung. Weitere Informationen zu Einschränkungen und Besonderheiten von Post-Purchase-Checkout-Erweiterungen findest du in der Entwicklerdokumentation von Shopify.

Das alte Adyen-Gateway wird nicht mehr unterstützt und kann zu Zahlungsproblemen führen. Wenn du noch das alte Adyen-Gateway nutzt, solltest du umgehend zur neuen Adyen-Zahlungs-App migrieren.

Um zu migrieren, wende dich an den Shopify Support oder an deinen Merchant Success Manager, um Unterstützung beim Migrationsprozess zu erhalten.

Bevor du den Shopify Support zu Adyen kontaktierst

Bevor du dich wegen eines Adyen-Problems an den Shopify Support wendest, solltest du die folgenden Informationen bereithalten, um das Problem schneller zu lösen:

  • Die von dem Problem betroffene Bestellnummer oder die betroffenen Bestellnummern
  • Datum und Uhrzeit des Auftretens des Problems
  • Bildschirmaufnahmen von jeglichen erhaltenen Fehlermeldungen
  • Der Zahlungsstatus, der sowohl in deinem Shopify-Adminbereich als auch in deinem Adyen-Portal angezeigt wird
  • Die „merchantReference“-Nummer von Adyen (falls zutreffend)
  • Eine Beschreibung dessen, was du erwartet hast, im Vergleich zu dem, was tatsächlich passiert ist
  • Schritte, die du bereits aus dem Abschnitt zur Fehlerbehebung versucht hast

Support und Ressourcen für Adyen

Wenn du weißt, an welches Team du dich für Support wenden musst, kannst du deine Erfahrung verbessern und schneller Antworten zur Nutzung von Adyen bei Shopify erhalten.

Zuständigkeiten des Shopify Supports

Für Unterstützung bei der Adyen-Integration auf Shopify, einschließlich Hilfe beim Setup, der Konfiguration und der Fehlerbehebung bei häufigen Problemen, ist der Shopify Support dein erster Ansprechpartner. Der Shopify Support kann bei den folgenden Arten von Problemen helfen:

  • Anfordern von Zugriff und Aktivieren des Adyen-Zahlungs-Gateways auf Shopify
  • Technische Probleme im Zusammenhang mit dem Adyen-Zahlungs-Gateway auf Shopify
  • Fehlerbehebung bei Integrationsproblemen
  • Anleitung zum Konfigurieren und Verwalten von Adyen-Einstellungen innerhalb von Shopify

Zuständigkeiten des Adyen-Supports

Bei Problemen, die spezifisch für dein Adyen-Konto sind, wende dich direkt an den Adyen-Support unter support@adyen.com. Der Adyen-Support bearbeitet die folgenden Arten von Anfragen:

  • Kontoüberprüfung und Händler-Onboarding
  • Einhaltung von Vorschriften
  • Preisgestaltung und Bearbeitungsgebühren
  • Auszahlungszeitpläne, fehlgeschlagene Auszahlungen und andere Fragen zu Auszahlungen
  • Strategien und Tools zur Betrugsprävention
  • Verwaltung von Rückbuchungen und Anfechtungen
  • Detaillierte Berichterstattung und Anforderungen für den Abgleich

Ressourcen

Weitere Informationen zu Adyen und dessen Integration mit Shopify findest du in den folgenden Ressourcen: