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.
Wenn Ihre App Afterpay akzeptiert, wird Kund/innen für die Authentifizierung der Zahlung eine Webansicht angezeigt. Anschließend kehrt der/die Kund/in zu Ihrer App zurück und Sie können sofort bestätigen, ob die Zahlung erfolgreich war oder fehlgeschlagen ist.
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.
Stripe einrichtenServerseitigClientseitig
Zunächst benötigen Sie ein Stripe-Konto. Registrieren Sie sich jetzt.
Serverseitig
Diese Integration erfordert Endpoints auf Ihrem Server, die mit der Stripe-API kommunizieren können. Nutzen Sie diese offiziellen Bibliotheken für den Zugriff auf die Stripe-API von Ihrem Server aus:
Clientseitig
Das Stripe Android SDK ist Open Source und vollständig dokumentiert.
Um das SDK zu installieren, fügen Sie stripe-android
in den Block dependencies
Ihrer app/build.gradle-Datei ein:
Notiz
Details zur aktuellen SDK-Version und zu vorherigen Versionen finden Sie auf der Seite Releases auf GitHub. Um bei Veröffentlichung eines neuen Release eine Benachrichtigung zu erhalten, beobachten Sie Veröffentlichungen für das jeweilige Repository.
Konfigurieren Sie das SDK mit Ihrem veröffentlichbaren Schlüssel von Stripe so, dass dieser Anfragen an die API stellen kann, wie beispielsweise in Ihrer Unterklasse Application
:
Notiz
Verwenden Sie Ihre Testschlüssel beim Testen und Entwickeln Ihrer App und Ihre Live-Modus-Schlüssel beim Veröffentlichen Ihrer App.
Stripe-Beispiele nutzen auch OkHttp und GSON, um HTTP-Anfragen an einen Server zu stellen.
PaymentIntent erstellenServerseitigClientseitig
Ein PaymentIntent ist ein Objekt, das Ihre Absicht, eine Kundenzahlung einzuziehen, darstellt und den gesamten Zahlungsvorgang dokumentiert.
Serverseitig
Erstellen Sie einen PaymentIntent
auf Ihrem Server und geben Sie den einzuziehenden Betrag sowie eine unterstützte Währung an. Wenn Sie bereits eine Integration mit dem Payment Intents API haben, fügen Sie afterpay_
zur Liste der Zahlungsmethoden für Ihren PaymentIntent
hinzu.
Zusätzliche Optionen für Zahlungsmethoden
Sie können einen optionalen Parameter reference
in den Optionen für Zahlungsmethoden für Ihren PaymentIntent
angeben, der eine Bestellkennung für die Zahlung festlegt. Obwohl dies normalerweise weder für das Unternehmen noch für den Verbraucher sichtbar ist, kann das interne Support-Team von Afterpay bei manuellen Supportanfragen darauf zugreifen. Die Kennung ist auf 128 Zeichen begrenzt und darf nur aus Buchstaben, Ziffern, Unterstrichen, umgekehrten Schrägstrichen und Bindestrichen bestehen.
Clientseitig
Im zurückgegebenen PaymentIntent ist ein Client-Geheimnis enthalten, mit dem der Client den Zahlungsvorgang sicher abschließen kann, anstatt das gesamte PaymentIntent-Objekt zu übergeben. Fordern Sie auf dem Client einen PaymentIntent von Ihrem Server an und speichern Sie das zugehörige Client-Geheimnis.
Angaben zur Zahlungsmethode erfassenClientseitig
Für Afterpay sind die Abrechnungsdaten erforderlich, damit die Zahlung durchgeführt werden kann. Erfassen Sie in Ihrer App die erforderlichen Abrechnungsdaten von den Kundinnen/Kunden:
- Vollständiger Name (Vor- und Nachname)
- E-Mail-Adresse
- Vollständige Rechnungsadresse
Erstellen Sie mit diesen Angaben ein PaymentMethodCreateParams-Modell.
Auch wenn keine Versanddaten erforderlich sind, können Sie die Authentifizierungsraten verbessern. Um Versanddaten zu erfassen, erfassen Sie folgende Daten von der Kundin/dem Kunden:
- Vollständiger Name
- Vollständige Versandadresse
Erstellen Sie mit diesen Angaben ein ConfirmPaymentIntentParams.Shipping-Modell.
Zahlung an Stripe sendenClientseitig
Rufen Sie vom in Schritt 2 erstellten PaymentIntent das Client-Geheimnis ab und rufen Sie die Methode PaymentLauncher bestätigen auf. Dies entspricht einer Webansicht, über die die Kund/innen auf der Website der Bank oder über die App die Zahlung durchführen können. Anschließend wird onActivityResult
mit dem Ergebnis der Zahlung aufgerufen.
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. |