Konbini-Zahlungen

Als Erstes benötigen Sie ein Stripe-Konto. Registrieren Sie sich jetzt.

Nutzen Sie unsere offiziellen Bibliotheken für den Zugriff auf die Stripe-API über Ihre Anwendung:

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Stripe verwendet ein PaymentIntent-Objekt, um Ihre Absicht darzustellen, Zahlungen von Kundinnen/Kunden einzuziehen und Statusänderungen vom Konbini PaymentIntent Erstellung bis zum Abschluss zu verfolgen.

Erstellen Sie einen PaymentIntent auf Ihrem Server mit einem Betrag und der Währung jpy (Konbini unterstützt keine anderen Währungen). Wenn Sie bereits eine Integration mit dem Payment Intents API haben, fügen Sie konbini zur Liste der Zahlungsmethoden für Ihren PaymentIntent hinzu.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=jpy \
  -d "payment_method_types[]"=konbini \
  -d "payment_method_options[konbini][product_description]"="Tシャツ" \
  -d "payment_method_options[konbini][expires_after_days]"=3

Client-Geheimnis abrufen

Im PaymentIntent ist ein Client-Geheimnis enthalten, das auf dem Client verwendet wird, um Zahlungen sicher abzuschließen. Es gibt verschiedene Verfahren zum Übergeben des Client-Geheimnisses an den Client.

get '/secret' do
  intent = # ... Create or retrieve the PaymentIntent
  {client_secret: intent.client_secret}.to_json
end

(async () => {
  const response = await fetch('/secret');
  const {client_secret: clientSecret} = await response.json();
  // Render the form using the clientSecret
})();

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.

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.

Die Einstellung expires_at ist ein Unix-Zeitstempel in Sekunden. Wenn der Wert weniger als 30 Minuten von der aktuellen Uhrzeit entfernt ist oder die PaymentIntent-Bestätigung weniger als 30 Minuten vor dem Ablaufdatum erfolgt, wird ein Fehler zurückgegeben.

expires_after_days und expires_at schließen sich gegenseitig aus. Wenn beide Werte festgelegt sind, wird ein Fehler zurückgegeben. Beide Werte sind zudem optional, und wenn keiner von beiden festgelegt ist, ist die Ablaufzeit standardmäßig 3 Tage nach der Erstellung des PaymentIntent um 23:59 japanischer Zeit (UTC+9).

Fehlerbehebung

Anfragen in PaymentIntents, wie solche zum Erstellen, Aktualisieren und Bestätigen, können fehlschlagen. Sie können den error-Wert der API-Antwort überprüfen, um den Grund zu ermitteln, und in vielen Fällen die Anfrage entweder erneut übermitteln oder den Fehler beheben. Insbesondere wenn Sie einen Wert für die Option confirmation_number für die Zahlungsmethode angeben, empfiehlt es sich, bei bestimmten von uns zurückgegebenen Fehlercodes entsprechende Maßnahmen zu ergreifen. Weitere Informationen finden Sie unter Bestätigungsnummern.

Es kann vorkommen, dass die Zahlungsmethode aufgrund von Ausfällen, geplanten Wartungsarbeiten oder Ihrem Nutzungsverhalten vorübergehend nicht verfügbar ist. Weitere Informationen finden Sie unter Umgang mit vorübergehenden Verfügbarkeitsproblemen.

Erstellen Sie ein Zahlungsformular auf Ihrem Client, um die erforderlichen Rechnungsdaten von den Kund/innen zu erfassen:

In diesem Beispielformular wird auch eine Telefonnummer erfasst, die als von den Kund/innen bereitgestellte Bestätigungsnummer verwendet werden soll:

<form id="payment-form">
  <div class="form-row">
    <label for="name">
      Name
    </label>
    <input id="name" name="name" required>
  </div>

  <div class="form-row">
    <label for="email">
      Email
    </label>
    <input id="email" name="email" required>
  </div>

  <div class="form-row">
    <label for="phone">
      Phone Number
    </label>
    <input id="phone" name="phone" required>
  </div>

  <!-- Used to display form errors. -->
  <div id="error-message" role="alert"></div>

  <button id="submit-button">Pay with Konbini</button>
</form>

Verwenden Sie Stripe.js zur Übermittlung von Zahlungen an Stripe, wenn Kundinnen/Kunden mit Konbini bezahlen möchten. Stripe.js ist unsere grundlegende JavaScript-Bibliothek für die Erstellung von Zahlungsabläufen.

Fügen Sie das Stripe.js-Skript auf Ihrer Bezahlseite ein, indem Sie es zum head der HTML-Datei hinzufügen.

<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/basil/stripe.js"></script>
</head>

Erstellen Sie auf Ihrer Bezahlseite eine Instanz von Stripe.js mit dem folgenden JavaScript.

// Set your publishable key. Remember to switch to your live publishable key in production!
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx');

Verwenden Sie stripe.confirmKonbiniPayment und das Client-Geheimnis des PaymentIntent-Objekts, das Sie in Schritt 2 erstellt haben, um die Rechnungsdaten der Kundin/des Kunden zu übermitteln.

Bei Bestätigung öffnet Stripe automatisch ein Modal, in dem Ihren Kund/innen die Konbini-Zahlungsanweisungen angezeigt werden.

const form = document.getElementById('payment-form');

form.addEventListener('submit', async (event) => {
  event.preventDefault();

  const result = await stripe.confirmKonbiniPayment(
    '{{PAYMENT_INTENT_CLIENT_SECRET}}',
    {
      payment_method: {
        billing_details: {
          name: document.getElementById('name').value,
          email: document.getElementById('email').value,
        },
      },
      payment_method_options: {
        konbini: {
          confirmation_number: document.getElementById('phone').value.replace(/\D/g,''),
        },
      },
    }
  );
  // Stripe.js will open a modal to display the Konbini payment instructions to your customer
  // This async function finishes when the customer closes the modal

  if (result.error) {
    // Display error to your customer
    const errorMsg = document.getElementById('error-message');
    errorMsg.innerText = result.error.message;
  }
});

Zusätzliche Optionen für Zahlungsmethoden

Bei der Bestätigung eines Konbini-PaymentIntent können Sie zusätzliche Optionen für Zahlungsmethoden in den Optionen für Zahlungsmethoden unter dem Schlüssel konbini angeben.

Bestätigungsnummern

Ihre Kund/innen müssen sich auf die confirmation_number beziehen, wenn sie ihre Zahlung abschließen. Wenn Sie diesen Wert festlegen möchten oder den Kund/innen ermöglichen, den Wert festzulegen, wird als zu verwendender Wert die Telefonnummer der Kund/innen empfohlen. Eine confirmation_number kann auch während der Erstellung des PaymentIntent auf Serverseite festgelegt werden, wird aber in der Regel bei Bestätigung des PaymentIntent von den Kund/innen auf Client-Seite festgelegt. Sie kann ab der PaymentIntent-Erstellung bis zur PaymentIntent-Bestätigung jederzeit geändert werden.

Wenn eine angegebene confirmation_number zu häufig bei den laufenden Transaktionen für Minimärkte vorkommt, kann sie bei der PaymentIntent-Bestätigung abgelehnt werden. Der in diesem Fall zurückgegebene Fehlercode ist payment_intent_konbini_rejected_confirmation_number (tritt nur bei Bestätigung eines PaymentIntent auf).

Stripe blockiert bei der Erstellung des PaymentIntent sowie bei Aktualisierung und Bestätigung proaktiv Bestätigungsnummern, die nur aus Nullen bestehen. Stellen Sie daher sicher, dass Sie diesen Wert nicht verwenden bzw. die Kund/innen nicht die Möglichkeit haben, ihn zu verwenden.

Fehlerbehebung

Die clientseitige Bestätigung eines PaymentIntent kann auch fehlschlagen. Sie sollten den error-Rückgabewert überprüfen, um den Grund für den Fehler zu ermitteln. Diesen können Sie wenn möglich dem/der Kund/in anzeigen oder ihn korrigieren und es erneut versuchen.

Konbini ist eine Zahlungsmethode mit verzögerter Benachrichtigung. Daher sind die Gelder nicht sofort verfügbar. Es kann vorkommen, dass Kundinnen/Kunden die ausstehende Konbini-Zahlung nicht sofort bei Abschluss des Bestellvorgangs im Minimarkt erledigen.

Nach Abschluss einer ausstehenden Konbini-Zahlung sendet Stripe das Ereignis payment_intent.succeeded für diese Zahlung. Verwenden Sie das Dashboard oder erstellen Sie einen Webhook-Handler, um diese Ereignisse zu erhalten und Aktionen auszuführen. Beispiele für Aktionen sind u. a. das Senden einer E-Mail zur Bestellbestätigung an Ihre Kundinnen/Kunden, das Protokollieren des Verkaufs in einer Datenbank oder das Starten eines Versand-Workflows.

Wenn es eindeutig ist, dass eine ausstehende Konbini-Zahlung nicht durchgeführt wurde, in der Regel etwa eine Stunde nach Ablauf der Frist, sendet Stripe das Ereignis payment_intent.payment_failed.

Ereignisse empfangen und Geschäftsaktionen ausführen

Manuell

Im Stripe-Dashboard können Sie alle Stripe-Zahlungen anzeigen, Zahlungsbelege per E-Mail versenden, Auszahlungen abwickeln oder fehlgeschlagene Zahlungen erneut durchführen.

• Testzahlungen im Dashboard anzeigen

Benutzerdefinierter Code

Erstellen Sie einen Webhook-Handler, um Ereignisse zu überwachen und benutzerdefinierte asynchrone Zahlungsabläufe zu erstellen. Mit der Stripe-CLI können Sie Ihre Webhook-Integration lokal testen und Fehler beheben.

• Nutzerdefinierten Webhook erstellen

Legen Sie payment_method.billing_details.email beim Testen auf die folgenden Werte fest, wenn Sie stripe.confirmKonbiniPayment aufrufen, 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.

Um die Bestätigungsnummer zu testen, können Sie die folgenden Werte für payment_method_options[confirmation_number] verwenden:

• 01234567890 ergibt den Fehlercode payment_intent_konbini_rejected_confirmation_number.
• 00000000000 ergibt einen generischen Validierungsfehlercode. Sie sollten diesen Fehler mithilfe der Vorabvalidierung in Ihrer Integration vermeiden.