Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenVerwenden Sie Managed Payments
Präsenzzahlungen
Zahlungsmethoden
Zahlungsszenarien
Mehr als Zahlungen

Eine Affirm-Zahlung annehmen

So akzeptieren Sie die "Jetzt kaufen, später bezahlen"-Zahlungsmethode Affirm.

Hinweis

Diese Anleitung hilft Ihnen dabei, Affirm in Ihren Online-Bezahlvorgang zu integrieren. Für persönliche Zahlungen mit Stripe Terminal besuchen Sie Zusätzliche Zahlungsmethoden.

Vorsicht

Stripe kann Ihren Kundinnen und Kunden automatisch die relevanten Zahlungsmethoden anzeigen, indem Währungen, Einschränkungen der Zahlungsmethode und andere Parameter ausgewertet werden.

  • Befolgen Sie den Leitfaden Eine Zahlung akzeptieren, um eine Checkout-Integration zu erstellen, die dynamische Zahlungsmethoden verwendet.
  • Wenn Sie keine dynamischen Zahlungsmethoden verwenden möchten, befolgen Sie die folgenden Schritte, um die Zahlungsmethoden in Ihrer Checkout-Integration manuell zu konfigurieren.

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.

Hinweis

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

Hinweis

Dieser Leitfaden beruht auf der grundlegenden Checkout-Integration für die Annahme einer Zahlung.

Das führt Sie durch die Aktivierung von Affirm und zeigt die Unterschiede zwischen dem Akzeptieren von Zahlungen mit dynamischen Zahlungsmethoden und dem manuellen Konfigurieren von Zahlungsmethoden.

Affirm als Zahlungsmethode aktivieren

Führen Sie bei der Erstellung einer neuen Checkout-Sitzung folgende Schritte aus:

  1. Fügen Sie affirm der Liste der payment_method_types hinzu.
  2. Stellen Sie sicher, dass alle line_items Ihre Landeswährung verwenden und der Gesamtbetrag die Limits für Transaktionsbeträge von Affirm nicht überschreitet.
  3. Optional können Sie über shipping_address_collection[allowed_countries] angeben, welche Länder Checkout als Versandorte zulässt.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=5000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=affirm \
  -d "shipping_address_collection[allowed_countries][0]"=CA \
  -d "shipping_address_collection[allowed_countries][1]"=US \
  --data-urlencode success_url="https://example.com/success"

Wenn Sie Versandadressen nicht über Checkout erfassen möchten, können Sie die Versandadresse auch über payment_intent_data[shipping] angeben. Dies trägt zur Verbesserung der Kreditbewilligungsquoten bei.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=5000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=affirm \
  -d "payment_intent_data[shipping][name]"="Jenny Rosen" \
  -d "payment_intent_data[shipping][address][line1]"="1234 Main Street" \
  -d "payment_intent_data[shipping][address][city]"="San Francisco" \
  -d "payment_intent_data[shipping][address][state]"=CA \
  -d "payment_intent_data[shipping][address][country]"=US \
  -d "payment_intent_data[shipping][address][postal_code]"=94111 \
  --data-urlencode success_url="https://example.com/success"

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:

EreignisnameBeschreibungNächste Schritte
checkout.session.completedDie 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.succeededDie 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_failedDie 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 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_action 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_action zu requires_payment_method.

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_payment_method.

Anders als bei einer abgelehnten Zahlung muss bei einem Affirm-PaymentIntent mit dem Status requires_action 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_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:

FehlercodeEmpfohlene Maßnahme
payment_intent_payment_attempt_failedEin allgemeiner Fehler, der darauf hinweist, dass der Bezahlvorgang mit Affirm fehlgeschlagen ist. Zusätzliche Informationen können im Grund für das Zahlungsergebnis verfügbar sein.
payment_method_provider_declineAffirm hat die Kundenzahlung abgelehnt. Als nächsten Schritt muss sich der Kunde/die Kundin an Affirm wenden, um weitere Informationen einzuholen.
payment_intent_payment_attempt_expiredDer Kunde/die Kundin hat die Zahlung auf der Zahlungsseite von Affirm nicht abgeschlossen und die Zahlungssitzung ist abgelaufen. PaymentIntents, die nicht erfolgreich autorisiert wurden, lassen Stripe 12 Stunden nach der ersten Erstellung des Bezahlvorgangs automatisch ablaufen.
payment_method_not_availableBei Affirm ist ein Fehler im Zusammenhang mit der Dienstleistung aufgetreten und kann die Anfrage nicht abschließen. Versuchen Sie es zu einem späteren Zeitpunkt erneut.
amount_too_smallGeben Sie einen Betrag innerhalb der Standard-Transaktionslimits von Affirm ein.
amount_too_largeGeben Sie einen Betrag innerhalb der Standard-Transaktionslimits von Affirm ein.

Bei einigen Fehlern können zusätzliche Erkenntnisse im Grund für das Zahlungsergebnis enthalten sein:

ErgebnisursachenWas bedeutet das?
generic_declineDer Standardgrund für das Ergebnis eines Zahlungsfehlers. Dies weist in der Regel darauf hin, dass der Partner die Zahlung abgelehnt hat (z. B. aufgrund unzureichender Deckung), dass die Bank die Zahlung abgelehnt hat, dass die Transaktion einen Kauf mit hohem Risiko beinhaltete oder auf einen ähnlichen Grund. In diesen Fällen erhält Stripe möglicherweise nicht immer einen Ablehnungsgrund.
affirm_checkout_canceledEntweder hat der Kunde/die Kundin den Bezahlvorgang mit Affirm explizit abgebrochen oder Affirm hat den Kreditanspruch des Kunden/der Kundin abgelehnt. Stripe kann den Unterschied zwischen diesen beiden Ereignistypen nicht erkennen.