Konbini-Zahlungen
Verwenden Sie die Payment Intents API und Payment Methods API, um Zahlungen über Konbini anzunehmen, eine beliebte Zahlungsmethode für
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.
Konbini ist eine einmalig nutzbare Zahlungsmethode, bei der die Kundinnen/Kunden weitere Schritte unternehmen müssen, um ihre Zahlung abzuschließen. Die Kundinnen/Kunden 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 zunächst eine Integration, um mit Checkout Zahlungen anzunehmen, bevor Sie mit diesem Leitfaden fortfahren.
In diesem Leitfaden erfahren Sie, wie Sie Konbini aktivieren. Er zeigt die Unterschiede zwischen der Annahme einer Kartenzahlung und der Verwendung von Konbini.
Konbini als Zahlungsmethode aktivieren
Führen Sie bei der Erstellung einer neuen Checkout-Sitzung folgende Schritte aus:
- Fügen Sie
konbini
zur Liste derpayment_
hinzu.method_ types - Stellen Sie sicher, dass alle
line_
die Währungitems jpy
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_ | 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_
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 Kundinnen/Kunden bei einer Konbini-Zahlung nicht zur success_url weitergeleitet.
Nach der erfolgreichen Übermittlung des Checkout-Formulars werden die Kund/innen zur hosted_
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 sendet ein payment_intent.requires_action-Ereignis, wenn ein Konbini-Gutschein erfolgreich erstellt wurde. Wenn Sie Ihren Kundinnen/Kunden den Link mit den Zahlungsanweisungen für den Gutschein per E-Mail senden möchten, finden Sie die hosted_
in payment_intent.next_action.konbini_display_details. Erfahren Sie mehr darüber, wie Sie einen 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 Ihr offizieller Firmenname
- Akzentfarbe: Farbe für die Schaltfläche „Nummer kopieren“
- Markenfarbe – Die 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 vorzunehmen. Erfahren Sie mehr zum Einrichten von Webhooks und der Abwicklung 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_ zurück. | Kontaktieren Sie den Kunden/die Kundin per E-Mail und fordern Sie eine neue Bestellung von ihm/ihr an. |
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 Fehler 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_
in den next_action.konbini_display_details angegeben wurde, können die Kundinnen/Kunden 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_
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_
. 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_
angegebenen Zeitpunkt stornieren. Auch durch die Aktualisierung des PaymentIntent oder die Bestätigung mit einer anderen Zahlungsmethode wird die bestehende Konbini-Zahlung implizit storniert.
Wenn der Kunde/die Kundin die Konbini-Zahlung gerade im Minimarkt bezahlt, schlägt die Stornierungsanfrage fehl. Es kann erneut versucht werden, die Stornierung durchzuführen, wenn der Kunde/die Kundin den Zahlungsversuch abbricht und der Einzahlungsschein abläuft.
Beachten Sie, dass Probleme mit der vorübergehenden Verfügbarkeit von Zahlungsmethoden auch (sowohl explizite als auch implizite) Stornoanfragen betreffen.
Vorsicht
Wenn Sie eine ausstehende Zahlung stornieren, verlieren die ursprünglichen Zahlungsanweisungen ihre Gültigkeit. Für die meisten Anwendungsfälle empfehlen wir Ihnen, Ihre Kundin/Ihren Kunden zu kontaktieren, um sie/ihn über die Stornierung zu informieren.
Wenn Sie einen PaymentIntent mit dem Status requires_
erfolgreich erneut bestätigen, erstellen wir neue Anweisungen und eine neue hosted_
. 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_ |
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_ |
Die Rückerstattung erfolgt requires_ 45 Tage nach Erstellung | failed |
Rückerstattung wurde aufgrund des Status requires_ 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_
. 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 Kontodaten nicht innerhalb von 45 Tagen angegeben werden, wechselt der Status der Rückerstattung zu failed
und wir senden das Ereignis refund.failed. Das bedeutet, dass Stripe die Rückerstattung nicht bearbeiten kann und Sie die Gelder außerhalb von Stripe an Ihre Kundinnen/Kunden zurückerstatten müssen.
Das Feld instructions_email 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 Kunden/der Kundin wartet, finden Sie Details zu der E-Mail, die an den Kunden/die Kundin 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_BQokikJOvBiI2HlWgH4olfQ2