Zahlungen per Afterpay oder Clearpay annehmen
Erfahren Sie, wie Sie Zahlungen mit Afterpay annehmen (im Vereinigten Königreich auch unter dem Namen Clearpay bekannt), einer Zahlungsmethode in den USA, CA, UK, AU und NZ.
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.
Wenn Sie weiterhin manuell konfigurieren möchten, welche Zahlungsmethoden Ihren Kundinnen/Kunden mit Checkout angezeigt werden sollen, können Sie sich an diesem Leitfaden orientieren. Aktualisieren Sie andernfalls Ihre Integration, um Zahlungsmethoden im Dashboard zu konfigurieren.
Afterpay ist eine Zahlungsmethode für die einmalige Nutzung mit sofortiger Benachrichtigung, bei der Kundinnen/Kunden ihre Zahlung authentifizieren müssen. Kundinnen/Kunden werden auf die Afterpay-Website weitergeleitet, wo sie den Bedingungen eines Ratenzahlungsvertrags zustimmen. Wenn die Kundinnen/Kundinnen die Bedingungen akzeptieren, garantiert Afterpay, dass die Gelder für den Kunden/die Kundin verfügbar sind und überweist sie auf Ihr Stripe-Konto. Die Kundinnen/Kunden zahlen die Zahlung über eine gewissen Zeitraum direkt an Afterpay zurück.
Notiz
Bevor Sie mit der Integration beginnen, vergewissern Sie sich, dass Ihr Konto für Afterpay 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 Afterpay muss eine Checkout-Sitzung alle folgenden Bedingungen erfüllen:
- Sie können nur einmalige Posten verwenden (wiederkehrende Abonnementpläne werden nicht unterstützt).
- Sie müssen die Preise in Ihrer Landeswährung angeben.
Zahlung annehmen
Notiz
Dieser Leitfaden beruht auf der grundlegenden Checkout-Integration für die Annahme einer Zahlung.
In diesem Leitfaden erfahren Sie, wie Sie Afterpay aktivieren. Er zeigt die Unterschiede zwischen der Annahme einer Kartenzahlung und der Verwendung von Afterpay.
Afterpay als Zahlungsmethode aktivieren
Führen Sie bei der Erstellung einer neuen Checkout-Sitzung folgende Schritte aus:
- Fügen Sie
afterpay_
der Liste derclearpay payment_
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]
Abwicklung Ihrer Bestellungen
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 Kundin/des Kunden ab. |
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 Afterpay als Zahlungsmethode aus und klicken Sie auf die Schaltfläche Bezahlen.
Testen Sie Ihre Afterpay-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, 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_
zu requires_
.
Für die manuelle Erfassung von PaymentIntents im Testmodus läuft der nicht erfasste PaymentIntent 10 Minuten nach erfolgreicher Autorisierung automatisch ab.
Fehlgeschlagene Zahlungen
Afterpay berücksichtigt mehrere Faktoren bei der Entscheidung, ob eine Transaktion akzeptiert oder abgelehnt wird (zum Beispiel die Dauer der Nutzung von Afterpay durch den/die Käufer/in, den ausstehenden Betrag, den der/die Kund/in zurückzahlen muss, oder den Wert der aktuellen Bestellung).
Sie sollten in Ihrem Bezahlvorgang immer weitere Zahlungsoptionen wie card
anbieten, da Afterpay-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_
.
Bei einem Afterpay-PaymentIntent mit dem Status requires_
müssen Kundinnen/Kunden die Zahlung innerhalb von 3 Stunden nach Weiterleitung zur Afterpay-Website abschließen. Wenn nach 3 Stunden keine Aktion erfolgt ist, wird die 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 |
---|---|
payment_ | Ein allgemeiner Fehler, der darauf hinweist, dass der Afterpay-Bezahlvorgang fehlgeschlagen ist. Dabei kann es sich auch um eine Ablehnung handeln, die nicht als Ablehnungsfehlercode angezeigt wird. |
payment_ | Afterpay hat die Kundenzahlung abgelehnt. Als nächsten Schritt muss sich der Kunde/die Kundin an Afterpay wenden, um weitere Informationen einzuholen. |
payment_ | Der Kunde/die Kundin hat die Zahlung nicht auf der Bezahlseite von Afterpay abgeschlossen und die Zahlungssitzung ist abgelaufen. Payment Intents, die nicht erfolgreich autorisiert wurden, lassen Stripe automatisch 3 Stunden nach der Erstellung des Bezahlvorgangs ablaufen. |
payment_ | Bei Afterpay ist ein Servicefehler aufgetreten und die Anfrage kann nicht abgeschlossen werden. Versuchen Sie es zu einem späteren Zeitpunkt erneut. |
amount_ | Geben Sie einen Betrag ein, der innerhalb der Standard-Transaktionslimits von Afterpay für das jeweilige Land liegt. |
amount_ | Geben Sie einen Betrag ein, der innerhalb der Standard-Transaktionslimits von Afterpay für das jeweilige Land liegt. |