Weitere ZahlungsmethodenÖffentliche Vorschau

Um kartenlose Zahlungsmethoden über die QR-Code-Schnittstelle zu akzeptieren, erstellen Sie eine PaymentIntent und fügen Sie Ihre bevorzugten Zahlungsmethodenarten in den Parameter payment_method_types ein.

• Kombinieren Sie card_present mit anderen kartenlosen Zahlungsmethoden, um Ihren Kundinnen und Ihren Kunden im Bezahlvorgang alle Zahlungsmethoden anzuzeigen. Wir empfehlen, diese Option zu aktivieren, wenn Sie in einer Umgebung mit überwiegend Offline-Anwendungen arbeiten, da im Offline-Modus nur Karten unterstützt werden.
• Wenn Sie keine Karten akzeptieren möchten, unterstützen Sie nur Zahlungsmethoden ohne Karte.
• Wenn Sie wissen, zu welcher Zahlungsmethode Sie Ihre Kundinnen und Kunden zum Bezahlvorgang weiterleiten möchten, wählen Sie eine einzelne Zahlungsmethode aus.

Erfassungstyp

Viele Zahlungsmethoden unterstützen die manuelle Erfassung nicht. Erstellen Sie Ihren PaymentIntent mit dem capture_method-Parameter automatic, um eine möglichst große Anzahl von Zahlungsmethoden zu unterstützen. Um die manuelle Erfassung für Kartenzahlungen zu unterstützen und gleichzeitig Zahlungsmethoden zu akzeptieren, die eine automatische Erfassung erfordern, setzen Sie capture_method für das verschachtelte Attribut payment_method_options.card_present auf manual.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card_present \
  -d "payment_method_types[]"=wechat_pay \
  -d capture_method=automatic \
  -d "payment_method_options[card_present][capture_method]"=manual

Im Gegensatz zu Kartenzahlungen erfolgt die Verarbeitung von QR-Code-Zahlungen asynchron. Beim Abwickeln eines PaymentIntent mit einer Zahlungsmethode mit QR-Code erzeugt Stripe einen QR-Code, der für diese Zahlung eindeutig ist. Nach der Verarbeitung der Zahlung zeigt das Lesegerät den QR-Code an, den der Kunde/die Kundin mit seinem/ihrem Mobilgerät scannen kann. Kurz nachdem die Kundinnen/Kunden die Zahlung auf ihrem Gerät abgeschlossen haben, wird das Lesegerät aktualisiert, um die abgeschlossene Zahlung anzuzeigen.

QR-Code-Zahlungen unterstützen sowohl die sofortige Zahlungsabwicklung als auch den zweistufigen Einzugs- und Bestätigungsablauf.

curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/process_payment_intent \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent=pi_xxx \
  --data-urlencode "process_config[return_url]"="https://my.store.com/payment-completed"

curl https://api.stripe.com/v1/terminal/readers/tmr_xxx \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

{
  "id": "tmr_xxx",
  "object": "terminal.reader",
  ...
  "status": "online",
  "action": {
    "type": "process_payment_intent",
    "process_payment_intent": {
      "payment_intent": "pi_xxx"
    },
    "status": "in_progress",
    "failure_code": null,
    "failure_message": null
  }
}

Geben Sie das Lesegerät frei, um eine weitere Zahlung anzunehmen

Es kann mehrere Minuten dauern, bis ein Kunde/eine Kundin die Zahlung auf seinem/ihrem Gerät abschließt. Anstatt zu warten, bis das Lesegerät das Ergebnis der abgeschlossenen Zahlung anzeigt, können Sie das Lesegerät freigeben, um eine Zahlung für einen anderen Kunden/eine andere Kundin vorzunehmen.

Nachdem die Kundin/der Kunde den QR-Code gescannt und zu ihrem/seinem Gerät gewechselt hat, um die Zahlung abzuschließen, verwenden Sie den Endpoint cancel_action, um das Lesegerät zurückzusetzen.

curl -X POST https://api.stripe.com/v1/terminal/readers/tmr_xxx/cancel_action \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Nachdem Sie die Aktion des Lesegeräts zum Prozess der Zahlung abgebrochen haben, verbleibt die Zahlung im Status requires_action, sodass die Kundin/der Kunde die Zahlung abschließen kann. Verwenden Sie die Webhooks payment_intent.succeeded und payment_intent.payment_failed, um das Ergebnis der abgeschlossenen Zahlung abzugleichen. Erfahren Sie, wie Sie einen PaymentIntent mit Webhooks überwachen.