Eine Affirm-Zahlung annehmen
Vorsicht
Stripe passt die den Kund/innen 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.
Wenn Sie weiterhin manuell einstellen möchten, welche Zahlungsmethoden im Bezahlvorgang angezeigt werden, können Sie sich an diesem Leitfaden orientieren (etwa für die Zahlungsannahme im Subscription mode). Ansonsten empfehlen wir unseren Artikel Zahlungsmethoden zum Dashboard migrieren.
Affirm ist eine Zahlungsmethode für die einmalige Nutzung mit sofortiger Benachrichtigung, bei der Kund/innen ihre Zahlung authentifizieren müssen. Kund/innen werden an die Affirm-Website weitergeleitet, wo sie den Bedingungen eines Ratenzahlungsvertrags zustimmen. Wenn die Kund/innen die Bedingungen akzeptieren, werden die Gelder garantiert und auf Ihr Stripe-Konto überwiesen. Die Kund/innen 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 beim Erstellen einer neuen Checkout-Sitzung folgende Schritte aus:
- Fügen Sie
affirm
der Liste derpayment_method_types
hinzu. - Stellen Sie sicher, dass für alle Ihre
line_items
Ihre Inlandswährung verwendet wird. - Wir empfehlen, Versandadressen zu erfassen, indem Sie Ihr Land zu
shipping_address_collection[allowed_countries]
hinzufügen. Wenn Sie die Versandadressen nicht mit Checkout erfassen möchten, können Sie die Versandadresse auch mitpayment_intent_data[shipping]
angeben. Dies ist hilfreich für die Kreditakzeptanzquote.
Bestellungen abwickeln
Verwenden Sie eine Methode wie Webhooks, um Ausführung von Bestellungen durchzuführen. Verlassen Sie sich nicht darauf, dass Ihre Kund/innen 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_payment_method . | Senden Sie dem/der Kund/in eine E-Mail, um eine neue Bestellung anzufordern. |
Weitere Informationen zur Abwicklung 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_action
zu succeeded
.
Um den Fall zu testen, in dem Nutzer/innen sich nicht authentifizieren können, verwenden Sie Ihre Test-API-Schlüssel und zeigen Sie die Weiterleitungsseite an. Klicken Sie auf der Weiterleitungsseite auf Fail test payment (Testzahlung fehlschlagen lassen). Der PaymentIntent wechselt von requires_action
zu requires_payment_method
.
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_payment_method
.
Anders als bei einer abgelehnten Zahlung wird bei einem Affirm-PaymentIntent mit dem Status requires_action
erfordert, dass die Kundin/der Kunde die Zahlung innerhalb von 12 Stunden nach Weiterleitung zur Afterpay-Website abschließt. Wird der/die Kund/in innerhalb 1 Stunde nicht aktiv, wird der PaymentMethod getrennt, und der Status des PaymentIntent-Objekts wechselt automatisch zu requires_payment_method
.
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_amount_too_small | Geben Sie einen Betrag innerhalb der Standard-Transaktionslimits von Affirm für das jeweilige Land ein. |
invalid_amount_too_large | Geben Sie einen Betrag innerhalb der Standard-Transaktionslimits von Affirm für das jeweilige Land ein. |
missing_required_parameter | Überprüfen Sie die Fehlermeldung, um weitere Informationen über den erforderlichen Parameter zu erhalten. |
nonexistent_country | Geben Sie einen gültigen ISO-Ländercode mit zwei Buchstaben für die Eigenschaft country in den Versand- und Abrechnungsdetails an. |
payment_intent_invalid_currency | Geben Sie die korrekte Währung ein. Affirm unterstützt nur Zahlungen in Ihrer Landeswährung. |
payment_intent_redirect_confirmation_without_return_url | Geben Sie eine return_url an, wenn Sie einen PaymentIntent mit Affirm bestätigen. |
payment_method_invalid_parameter | Überprüfen Sie die Fehlermeldung, um weitere Informationen über den Parameter zu erhalten. |