Eine Affirm-Zahlung annehmen
So akzeptieren Sie die "Jetzt kaufen, später bezahlen"-Zahlungsmethode Affirm.
Vorsicht
Stripe passt die den Kundinnen/Kunden angezeigten Zahlungsmethoden automatisch an Währung, geltende Einschränkungen und andere Parameter an. Wir empfehlen Ihnen, Ihre Zahlungsmethoden im Dashboard zu konfigurieren und sich dabei an dem Artikel Zahlungen annehmen zu orientieren.
If you want to continue manually configuring the payment methods you present to your customers with Checkout, use this guide. Otherwise, update your integration to configure payment methods in the Dashboard.
Affirm ist eine Zahlungsmethode für die einmalige Nutzung mit sofortiger Benachrichtigung, bei der Kundinnen/Kunden ihre Zahlung authentifizieren müssen. Kundinnen/Kunden werden an die Affirm-Website weitergeleitet, wo sie den Bedingungen eines Ratenzahlungsvertrags zustimmen. Wenn die Kundinnen/Kunden die Bedingungen akzeptieren, werden die Gelder garantiert und auf Ihr Stripe-Konto überwiesen. Die Kundinnen/Kunden zahlen die Gelder über eine gewissen Zeitraum direkt an Affirm zurück.
Notiz
Bevor Sie mit der Integration beginnen, vergewissern Sie sich, dass Ihr Konto für Affirm geeignet ist. Dies können Sie in Ihren Einstellungen für Zahlungsmethoden prüfen.
Kompatibilität bestimmen
Für die Unterstützung von Zahlungen per Affirm muss eine Checkout-Sitzung alle folgenden Bedingungen erfüllen:
- Sie können nur einmalige Posten verwenden. Affirm unterstützt keine wiederkehrenden Abonnementpläne).
- Geben Sie alle Preise in Ihrer Landeswährung an.
Zahlung annehmen
Notiz
Dieser Leitfaden beruht auf der grundlegenden Checkout-Integration für die Annahme einer Zahlung.
In diesem Leitfaden erfahren Sie, wie Sie Affirm aktivieren. Er zeigt die Unterschiede zwischen der Annahme einer Kartenzahlung und der Verwendung von Affirm.
Affirm als Zahlungsmethode aktivieren
Führen Sie bei der Erstellung einer neuen Checkout-Sitzung folgende Schritte aus:
- Fügen Sie
affirm
der Liste derpayment_
hinzu.method_ types - Stellen Sie sicher, dass für alle Ihre
line_
Ihre Inlandswährung verwendet wird.items - Wir empfehlen, Versandadressen zu erfassen, indem Sie Ihr Land zu
shipping_
hinzufügen. Wenn Sie die Versandadressen nicht mit Checkout erfassen möchten, können Sie die Versandadresse auch mitaddress_ collection[allowed_ countries] payment_
angeben. Dies ist hilfreich für die Kreditakzeptanzquote.intent_ data[shipping]
Bestellungen abwickeln
Verwenden Sie eine Methode wie Webhooks, um die Ausführung von Bestellungen zu tätigen. Verlassen Sie sich nicht darauf, dass Ihre Kundinnen/Kunden zur Zahlungsstatusseite zurückkehren.
Die folgenden Ereignisse werden übermittelt, wenn sich der Zahlungsstatus ändert:
Ereignisname | Beschreibung | Nächste Schritte |
---|---|---|
checkout.session.completed | Die Kundin/der Kunde hat die Zahlung nach der Übermittlung des Checkout-Formulars erfolgreich autorisiert. | Warten Sie, bis die Zahlung erfolgt oder fehlschlägt. |
payment_intent.succeeded | Die Zahlung der Kundin/des Kunden war erfolgreich. Der PaymentIntent wechselt zu succeeded . | Wickeln Sie die Bestellung der Waren oder Dienstleistungen ab, die der/die Kund/in gekauft hat. |
payment_intent.payment_failed | Die Zahlung der Kundin/des Kunden wurde abgelehnt oder ist aus einem anderen Grund fehlgeschlagen. Die PaymentIntent wechselt wieder zum Status requires_ . | Senden Sie dem/der Kund/in eine E-Mail, um eine neue Bestellung anzufordern. |
Weitere Informationen zur Ausführung von Bestellungen.
Integration testen
Wählen Sie beim Testen Ihrer Checkout-Integration Affirm als Zahlungsmethode aus und klicken Sie auf die Schaltfläche Bezahlen.
Testen Sie Ihre Affirm-Integration mit Ihren Test-API-Schlüsseln, indem Sie die Weiterleitungsseite anzeigen. Sie können die erfolgreiche Zahlung testen, indem Sie die Zahlung auf der Weiterleitungsseite authentifizieren. Der PaymentIntent wechselt von requires_
zu succeeded
.
Um den Fall zu testen, bei dem sich Nutzer/innen nicht authentifizieren können, verwenden Sie Ihre Test-API-Schlüssel und zeigen Sie die Weiterleitungsseite an. Schließen Sie auf der Weiterleitungsseite das Fenster des Affirm-Modals und überprüfen Sie, ob die Zahlung fehlgeschlagen ist. Der PaymentIntent wechselt von requires_
zu requires_
.
Bei einer Weiterleitung an die Affirm-Sandbox fragt Sie Affirm möglicherweise nach den letzten 4 Ziffern Ihrer SSN. Affirm schlägt vor, '0000'
oder '5678'
zu verwenden.
Für die manuelle Erfassung von PaymentIntents im Testmodus läuft der nicht erfasste PaymentIntent 10 Minuten nach erfolgreicher Autorisierung automatisch ab.
Fehlgeschlagene Zahlungen
Affirm berücksichtigt mehrere Faktoren bei der Entscheidung, ob eine Transaktion akzeptiert oder abgelehnt wird (zum Beispiel die Dauer der Nutzung von Affirm durch den/die Käufer/in, den ausstehenden Betrag, den der/die Kund/in zurückzahlen muss und den Wert der aktuellen Bestellung).
Bieten Sie in Ihrem Bezahlvorgang immer weitere Zahlungsoptionen wie card
an, da Affirm-Zahlungen eine höhere Ablehnungsrate haben als viele andere Zahlungsmethoden. In diesen Fällen wird die PaymentMethod getrennt, und der Status des PaymentIntent-Objekts wechselt automatisch zu requires_
.
Anders als bei einer abgelehnten Zahlung muss bei einem Affirm-PaymentIntent mit dem Status requires_
der Kunde/die Kundin die Zahlung innerhalb von 12 Stunden nach Weiterleitung zur Afterpay-Website abschließen. Wird der Kunde/die Kundin innerhalb von 1 Stunde nicht aktiv, wird die Verbindung mit der PaymentMethod getrennt, und der Status des PaymentIntent-Objekts wechselt automatisch zu requires_
.
Teilen Sie Ihren Kund/innen in diesen Fällen mit, dass sie es mit einer anderen Zahlungsoption versuchen sollten, die in Ihrem Bezahlvorgang zur Verfügung gestellt wird.
Fehlercodes
Im Folgenden finden Sie die häufigsten Fehlercodes und die entsprechenden empfohlenen Maßnahmen:
Fehlercode | Empfohlene Maßnahme |
---|---|
invalid_ | Geben Sie einen Betrag innerhalb der Standard-Transaktionslimits von Affirm für das jeweilige Land ein. |
invalid_ | Geben Sie einen Betrag innerhalb der Standard-Transaktionslimits von Affirm für das jeweilige Land ein. |
missing_ | Überprüfen Sie die Fehlermeldung, um weitere Informationen über den erforderlichen Parameter zu erhalten. |
nonexistent_ | Geben Sie einen gültigen ISO-Ländercode mit zwei Buchstaben für die Eigenschaft country in den Versand- und Abrechnungsdetails an. |
payment_ | Geben Sie die korrekte Währung ein. Affirm unterstützt nur Zahlungen in Ihrer Landeswährung. |
payment_ | Geben Sie eine return_ an, wenn Sie einen PaymentIntent mit Affirm bestätigen. |
payment_ | Überprüfen Sie die Fehlermeldung, um weitere Informationen über den Parameter zu erhalten. |