Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
Übersicht
Informationen zu Stripe Payments
Aktualisieren Sie Ihre Integration
Zahlungsanalysefunktionen
Online-Zahlungen
ÜbersichtIhren Use case findenZahlungen verwalten
Payment Links verwenden
Bezahlseite erstellen
Erweiterte Integration erstellen
In-App-Integration erstellen
Zahlungsmethoden
Zahlungsmethoden hinzufügen
    Übersicht
    Optionen für die Integration von Zahlungsmethoden
    Standardzahlungsmethoden im Dashboard verwalten
    Arten von Zahlungsmethoden
    Karten
    Mit Stripe-Guthaben bezahlen
    Krypto
    Lastschriften
    Bank Redirect
    Banküberweisungen
    Überweisungen (Sources)
    Jetzt kaufen, später bezahlen
    Zahlungen in Echtzeit
    Gutscheine
      Boleto
      Konbini
        Zahlung annehmen
      Multibanco
      OXXO
    Geldbörsen
    Lokale Zahlungsmethoden nach Land aktivieren
    Nutzerdefinierte Zahlungsmethoden
Zahlungsmethoden verwalten
Schnellerer Bezahlvorgang mit Link
Zahlungsschnittstellen
Payment Links
Checkout
Web Elements
In-App-Elements
Zahlungsszenarien
Umgang mit mehreren Währungen
Nutzerdefinierte Zahlungsabläufe
Flexibles Acquiring
Orchestrierung
Präsenzzahlungen
Terminal
Mehr als Zahlungen
Unternehmensgründung
Krypto
Financial Connections
Climate
Betrug verstehen
Betrugsprävention von Radar
Zahlungsanfechtungen verwalten
Identitäten verifizieren
StartseiteZahlungenAdd payment methodsVouchersKonbini

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

Unterstützte Unternehmensstandorte: JP

Unterstützte Währungen: jpy

Transaktionswährungen: jpy

Zahlungsmodus: Yes

Einrichtungsmodus: No

Abonnementmodus: No

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:

  1. Fügen Sie konbini zur Liste der payment_method_types hinzu.
  2. Stellen Sie sicher, dass alle line_items die Währung jpy verwenden.
Command Line
curl
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "mode"="payment" \ -d "payment_method_types[]"="card" \ -d "payment_method_types[]"="konbini" \ -d "payment_method_options[konbini][expires_after_days]"=3 \ -d "line_items[0][price_data][currency]"="jpy" \ -d "line_items[0][price_data][unit_amount]"=2000 \ -d "line_items[0][price_data][product_data][name]"="Tシャツ" \ -d "line_items[0][quantity]"=1 \ -d "success_url"="https://example.com/success" \ -d "cancel_url"="https://example.com/cancel"

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.

FeldWertErforderlichStandardwert
expires_after_daysDie 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.Nein3

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 Kundinnen/Kunden bei einer Konbini-Zahlung 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 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_voucher_url 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:

EreignisnameBeschreibungNächste Schritte

checkout.session.completed

Die Kund/innen haben das Checkout-Formular erfolgreich übermittelt. Stripe hat den Konbini-Gutschein generiert.

Sie können die hosted_voucher_url per E-Mail an die Kund/innen senden, falls sie den Konbini-Gutschein verloren haben.

Warten Sie, bis die Kund/innen in einem japanischem Minimarkt (Konbini) bezahlt haben.

checkout.session.async_payment_succeededDie 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_failedDer Konbini-Gutschein ist abgelaufen oder die Zahlung ist aus einem anderen Grund fehlgeschlagen. Der PaymentIntent kehrt zum Status requires_payment_method 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.

E-MailBestätigungsnummerBeschreibung

{any_prefix}@{any_domain}

11111111110

Simuliert eine Konbini-Zahlung, die nach 3 Minuten erfolgreich ausgeführt wurde, wobei der Webhook payment_intent.succeeded danach eingeht.

Beispiel: hanako@test.com

{any_prefix}succeed_immediately@{any_domain}

22222222220

Simuliert eine Konbini-Zahlung, die sofort erfolgreich ausgeführt wurde, wobei der Webhook payment_intent.succeeded danach eingeht.

Beispiel: succeed_immediately@test.com

{any_prefix}expire_immediately@{any_domain}

33333333330

Simuliert eine Konbini-Zahlung, die sofort abläuft, wobei der Webhook payment_intent.payment_failed danach eingeht.

Das Feld expires_at in next_action.konbini_display_details wird auf die aktuelle Zeit festgelegt, unabhängig davon, worauf der Parameter expires_after_days oder expires_at in den Optionen für Zahlungsmethoden festgelegt wird.

Beispiel: expire_immediately@test.com

{any_prefix}expire_with_delay@{any_domain}

44444444440

Simuliert eine Konbini-Zahlung, die nie erfolgreich ist. Sie läuft in 3 Minuten ab, und der Webhook payment_intent.payment_failed geht danach ein.

Das Feld expires_at in next_action.konbini_display_details wird auf 3 Minuten in der Zukunft festgelegt, unabhängig davon, auf welchen Wert der Parameter expires_after_days oder expires_at in den Optionen für Zahlungsmethoden festgelegt ist.

Beispiel: expire_with_delay@test.com

{any_prefix}fill_never@{any_domain}

55555555550

Simuliert eine Konbini-Zahlung, die nie erfolgreich ist. Sie läuft entsprechend der Angabe im Feld expires_at in den next_action.konbini_display_details für die angegebenen Parameter in den Optionen für Zahlungsmethoden ab, und der Webhook payment_intent.payment_failed trifft danach ein.

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_at 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_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.

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_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:

EreignisRückerstattungsstatus
Rückerstattung wird erstelltrequires_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 erwartetsucceeded
Die Bank des Kunden/der Kundin überweist die Gelder zurück an Stripe.requires_action
Die Rückerstattung erfolgt requires_action 45 Tage nach Erstellungfailed
Rückerstattung wurde aufgrund des Status requires_action storniertcanceled

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

BankleitzahlKontoTyp
11000000001234Rückerstattung erfolgreich.

1100000

1111113

1111116

1111113

3333335

4444440

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.

Command Line
curl https://api.stripe.com/v1/test_helpers/refunds/{{REFUND_ID}}/expire \ -X POST \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Siehe auch

  • Checkout-Ausführung
  • Checkout anpassen
War diese Seite hilfreich?
JaNein
  • Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
  • Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc