Konbini-Zahlungen
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.
Bei Konbini handelt es sich um eine Zahlungsmethode für die einmalige Nutzung, bei der Kund/innen weitere Schritte für die Zahlungsabwicklung unternehmen müssen. Die Kund/innen können die Zahlung in japanischen Minimärkten bar mit einem Zahlungscode und einer Bestätigungsnummer vornehmen. Stripe benachrichtigt Sie, wenn die Zahlung abgeschlossen ist.
Kompatibilität bestimmen
Für die Unterstützung von Zahlungen mit Konbini muss eine Checkout-Sitzung alle folgenden Bedingungen erfüllen:
- Die Preise für alle Posten müssen in der gleichen Währung angegeben werden (JPY).
- Sie können nur einmalige Posten verwenden (wiederkehrende Abonnementpläne werden nicht unterstützt).
Zahlung annehmen
Notiz
Erstellen Sie eine Integration, um mit Checkout Zahlungen anzunehmen, bevor Sie diesen Leitfaden verwenden.
Use this guide to learn how to enable Konbini—it shows the differences between accepting a card payment and using Konbini.
Konbini als Zahlungsmethode aktivieren
Führen Sie beim Erstellen einer neuen Checkout-Sitzung folgende Schritte aus:
- Fügen Sie
konbini
zur Liste derpayment_method_types
hinzu. - Stellen Sie sicher, dass alle
line_items
die Währungjpy
verwenden.
Zusätzliche Optionen für Zahlungsmethoden
Optionen für Zahlungsmethoden können unter dem Schlüssel konbini
in den Optionen für Zahlungsmethoden angegeben werden.
Feld | Wert | Erforderlich | Standardwert |
---|---|---|---|
expires_after_days | Die Anzahl der Kalendertage, nach denen eine ausstehende Konbini-Zahlung abläuft. Gültige Werte liegen zwischen 1 und 60 Tagen. Weitere Informationen finden Sie unter Ablaufdatum. | Nein | 3 |
Ablaufdatum
Ausstehende Konbini-Zahlungen laufen am angegebenen Datum kurz vor Mitternacht (23:59:59 JST) ab. Wenn beispielsweise expires_after_days
auf 2 festgelegt ist und der PaymentIntent am Montag bestätigt wird, läuft die ausstehende Konbini-Zahlung am Mittwoch um 23:59:59 japanischer Zeit (UTC+9) ab.
Telefonnummer
Auf dem Konbini-Zahlungsformular können Ihre Kund/innen optional eine Telefonnummer als ihre Bestätigungsnummer angeben. Dies vereinfacht den Bezahlvorgang in Geschäften, in dem die Benutzeroberfläche vor Ort den/die Kund/in auffordert, einen Zahlungscode und seine/ihre Bestätigungsnummer anzugeben. Beides spiegelt sich in den Zahlungsanweisungen wider, die Stripe anzeigt, nachdem der/die Kund/in sein/ihr Zahlungsformular übermittelt hat. Wenn Ihr/e Kund/in keine Telefonnummer angibt, generiert Stripe eine zufällige Bestätigungsnummer.
Stripe blockiert aktiv Telefonnummern, die nur aus Nullen bestehen.
Auf die von Stripe gehostete Gutscheinseite weiterleiten
Notiz
Anders als bei Kartenzahlungen werden die Kund/innen bei Konbini-Zahlungen nicht zur success_url weitergeleitet.
Nach der erfolgreichen Übermittlung des Checkout-Formulars werden die Kund/innen zur hosted_voucher_url
weitergeleitet. Die Kund/innen können die Zahlungsanweisungen der gehosteten Seite einsehen, um zu erfahren, wie sie die Zahlung abschließen können. Die Seite kann sowohl auf einem Computer als auch mobil angezeigt werden und lässt sich zudem ausdrucken.
Stripe übermittelt ein payment_intent.requires_action-Ereignis, wenn ein Konbini-Gutschein erfolgreich erstellt wurde. Wenn Sie Ihren Kund/innen den Link mit den Zahlungsanweisungen für den Gutschein per E-Mail zusenden möchten, finden Sie die hosted_voucher_url
in payment_intent.next_action.konbini_display_details. Erfahren Sie mehr darüber, wie Sie eine PaymentIntent mit Webhooks überwachen.
Auf der Seite mit den Branding-Einstellungen können Sie die Nutzeroberfläche für Ihre Kund/innen anpassen. Folgende Anpassungen sind für Gutscheine möglich:
- Symbol: Ihr Markenlogo und Unternehmensname
- Akzentfarbe: Farbe für die Schaltfläche „Nummer kopieren“
- Markenfarbe: Hintergrundfarbe
Bestellungen abwickeln
Da Konbini eine Zahlungsmethode mit verzögerter Benachrichtigung ist, müssen Sie eine Methode wie Webhooks nutzen, um den Zahlungsstatus zu überwachen und die Ausführung der Bestellung durchführen. Erfahren Sie mehr zum Einrichten von Webhooks und Abwickeln von Bestellungen.
Die folgenden Ereignisse werden übermittelt, wenn sich der Zahlungsstatus ändert:
Ereignisname | Beschreibung | Nächste Schritte |
---|---|---|
Die Kund/innen haben das Checkout-Formular erfolgreich übermittelt. Stripe hat den Konbini-Gutschein generiert. Sie können die | Warten Sie, bis die Kund/innen in einem japanischem Minimarkt (Konbini) bezahlt haben. | |
checkout.session.async_payment_succeeded | Die Kund/innen haben den Konbini-Gutschein erfolgreich bezahlt. Der PaymentIntent geht in den Status succeeded über. | Verarbeiten Sie die Bestellung der Kund/innen. |
checkout.session.async_payment_failed | Der Konbini-Gutschein ist abgelaufen oder die Zahlung ist aus einem anderen Grund fehlgeschlagen. Der PaymentIntent kehrt zum Status requires_payment_method zurück. | Fordern Sie die Kund/innen per E-Mail auf, eine neue Bestellung zu tätigen. |
Integration testen
Wählen Sie beim Testen Ihrer Checkout-Integration „Konbini“ als Zahlungsmethode aus und klicken Sie auf Bezahlen.
Geben Sie die folgenden Werte im Bezahlformular an, um verschiedene Szenarien zu testen. Sie können die Tests entweder mit einer speziellen Bestätigungsnummer oder einem E-Mail-Muster durchführen. Wenn beides angegeben wird, gilt das Verhalten der speziellen Bestätigungsnummer.
Bestätigungsnummer | Beschreibung | |
---|---|---|
|
| Simuliert eine Konbini-Zahlung, die nach 3 Minuten erfolgreich ausgeführt wurde, wobei der Webhook Beispiel: hanako@test.com |
|
| Simuliert eine Konbini-Zahlung, die sofort erfolgreich ausgeführt wurde, wobei der Webhook Beispiel: succeed_immediately@test.com |
|
| Simuliert eine Konbini-Zahlung, die sofort abläuft, wobei der Webhook Das Feld Beispiel: expire_immediately@test.com |
|
| Simuliert eine Konbini-Zahlung, die nie erfolgreich ist. Sie läuft in 3 Minuten ab, und der Webhook Das Feld Beispiel: expire_with_delay@test.com |
|
| Simuliert eine Konbini-Zahlung, die nie erfolgreich ist. Sie läuft entsprechend der Angabe im Feld Beispiel: fill_never@test.com |
Um den Umgang mit Fehlern bei der Bestätigungsnummer zu testen, können Sie die folgenden Werte verwenden:
01234567890
simuliert die Ablehnung einer Bestätigungsnummer.00000000000
führt zu einem Validierungsfehler.
Ablauf und Stornierung
Nach Ablauf der Zeit, die durch den Wert expires_at
in den next_action.konbini_display_details angegeben wurde, können die Kund/innen den Zahlungsvorgang für eine ausstehende Konbini-Zahlung in einem Minimarkt nicht mehr initiieren. Wenn sie vor Fristablauf einen gültigen Einzahlungsschein ausgestellt haben, können sie die Zahlung ggf. nach der Uhrzeit unter expires_at
an der Ladenkasse abschließen.
Es gibt eine Pufferzeit, um in einem solchen Fall vorzeitige Zahlungsausfälle zu vermeiden. Der Status des PaymentIntent ändert sich in requires_payment_method
. Zu diesem Zeitpunkt können Sie den PaymentIntent stornieren oder mit einer anderen Zahlungsmethode bestätigen.
Sie können eine ausstehende Konbini-Zahlung auch nach Bestätigung und vor dem durch next_action.konbini_display_details.expires_at
angegebenen Zeitpunkt stornieren. Auch durch die Aktualisierung des PaymentIntent oder die Bestätigung mit einer anderen Zahlungsmethode wird die bestehende Konbini-Zahlung implizit storniert.
If the customer is currently paying for the Konbini payment at the convenience store, the cancellation request will fail. Cancellation may be re-attempted if the customer abandons the payment attempt and after the payment slip expires.
Note that temporary payment method availability issues also affect (both explicit as well as implicit) cancellation requests.
Vorsicht
When you cancel a pending payment the original payment instructions become invalid. For most use cases we suggest you reach out to your customer to inform them of the cancellation.
Wenn Sie einen PaymentIntent mit dem Status requires_action
erfolgreich erneut bestätigen, erstellen wir neue Anweisungen und eine neue hosted_voucher_url
. Sie müssen Ihre Kund/innen darüber in Kenntnis setzen.
Rückerstattungen
Es ist möglich, Konbini-Zahlungen über das Dashboard oder die API zurückzuerstatten.
Um eine Rückerstattung abzuwickeln, die direkt auf das Bankkonto eines/einer Kund/in eingegangen ist, müssen die Kund/innen die Kontoverbindung angeben, an die die Rückerstattung erfolgen soll. Stripe kontaktiert die Kund/innen über die E-Mail-Adresse aus den Abrechnungsdaten für die Zahlungsmethode und fordert die benötigten Daten an. Nachdem wir die Bankdaten erhalten haben, bearbeiten wir die Rückerstattung automatisch.
Der Status der Rückerstattung ändert sich wie folgt:
Ereignis | Rückerstattungsstatus |
---|---|
Rückerstattung wird erstellt | requires_action |
Der Kunde/Die Kundin reicht die Bankkontodaten ein und Stripe beginnt, die Rückerstattung zu bearbeiten. | pending |
Die Rückerstattung wird von der Bank des Kunden/der Kundin erwartet | succeeded |
Die Bank des Kunden/der Kundin überweist die Gelder zurück an Stripe. | requires_action |
Die Rückerstattung erfolgt requires_action 45 Tage nach Erstellung | failed |
Rückerstattung wurde aufgrund des Status requires_action storniert | canceled |
Wenn die Bank des Kunden/der Kundin die Überweisung nicht erfolgreich abschließen kann, wird das Geld an Stripe zurückgesendet und die Rückerstattung wechselt in den Status requires_action
. Dies kann passieren, wenn der Name des Kontoinhabers/der Kontoinhaberin nicht mit den Daten der Empfängerbank übereinstimmt oder wenn die angegebene Bankkontonummer einen Tippfehler enthält. In diesen Fällen informieren wir den Kunden/die Kundin per E-Mail über den Fehler und bitten ihn/sie, seine/ihre Bankkontodaten erneut einzureichen.
Wenn die Kund/innen ihre Kontodaten nicht innerhalb von 45 Tagen angeben, geht der Status der Rückerstattung in failed
über, und das Ereignis charge.refund.updated wird übermittelt. Das bedeutet, dass Stripe die Rückerstattung nicht bearbeiten kann und Sie die Gelder außerhalb von Stripe an Ihre Kund/innen zurückerstatten müssen.
Das Feld instructions_email auf der Rückerstattung enthält die E-Mail-Adresse, an die die Rückerstattung gesendet wurde. Während eine Rückerstattung auf eine Antwort des/der Kund/in wartet, finden Sie Details zu der E-Mail, die an den/die Kund/in gesendet wurde, unter next_action.display_details.email_sent auf der Rückerstattung.
Für jede einzelne Rückerstattung (einschließlich jeder Teilrückerstattung) können Gebühren anfallen. Bitte wenden Sie sich an Ihren Ansprechpartner bei Stripe, um mehr darüber zu erfahren.
Rückerstattungen testen
Das Rückerstattungsverhalten können Sie im Test-Modus testen. Verwenden Sie dazu die folgenden Testbankkonten auf der Seite zur Erfassung von Bankkontodaten, die in der an die Kund/innen gesendeten E-Mail verlinkt ist. Bankkontodaten außerhalb dieser Testbankkonten werden nicht akzeptiert.
Bankleitzahl | Konto | Typ |
---|---|---|
1100000 | 0001234 | Rückerstattung erfolgreich. |
|
| Rückerstattung fehlgeschlagen. |
Ablaufdatum von Rückerstattungen testen
Sie können einen API-Aufruf durchführen, um den Ablauf einer Rückerstattung im Testmodus zu simulieren.
curl https://api.stripe.com/v1/test_helpers/refunds/{{REFUND_ID}}/expire \ -X POST \ -u
:sk_test_4eC39HqLyjWDarjtT1zdp7dc