Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden

Künftige PayTo-Zahlungen einrichten

So richten Sie zukünftige PayTo-Zahlungen ein.

Mit PayTo können Kundinnen und Kunden in Australien PayTo-Mandate für einmalige und wiederkehrende Zahlungen in ihren Banking-Apps authentifizieren. Kundinnen/Kunden zahlen mit PayTo, indem sie eine Benachrichtigung über eine ausstehende Mandatsanfrage erhalten, die Konditionen des Mandats autorisieren und dann wieder zu Ihrer App wechseln.

Wenn Sie ein PayTo-Mandat für zukünftige Zahlungen einrichten, können Sie jetzt die Autorisierung der Kundinnen und Kunden für den Einzug zukünftiger Zahlungen einholen. Kundinnen und Kunden können ihre PayTo-Mandate in ihren Banking-Apps anzeigen, verwalten, pausieren und stornieren.

Vorsicht

Die Änderung oder Pausierung von PayTo-Mandaten durch Kundinnen/Kunden wird von Stripe nicht unterstützt. Wenn ein Kunde/eine Kundin versucht, ein Mandat zu pausieren oder zu ändern, stornieren wir das Mandat und senden Ihnen einen mandate.updated-Webhook. Nach Erhalt des Webhooks können Sie sich mit dem Kunden/der Kundin in Verbindung setzen, um herauszufinden, warum er/sie ihr Mandat angepasst hat, und um ein neues Mandat zu erstellen.

Eine Zahlung einrichten

Hinweis

Diese Anleitung baut auf der grundlegenden Checkout-Integration Einrichtung von zukünftigen Zahlungen auf.

Um Payto als Zahlungsmethode zu aktivieren, erstellen Sie eine neue Checkout-Sitzung:

  1. Modus auf Einrichtung einstellen.
  2. Geben Sie die Konditionen des Mandats an, dem Ihre Kundin/Ihr Kunde unter Verwendung der Zahlungsmethoden-Optionen zustimmen soll.
  3. Fügen Sie payto zur Liste der payment_method_types hinzu.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d mode=setup \
  -d "payment_method_options[payto][mandate_options][amount_type]"=maximum \
  -d "payment_method_options[payto][mandate_options][payment_schedule]"=annual \
  -d "payment_method_options[payto][mandate_options][amount]"=150000 \
  -d "payment_method_options[payto][mandate_options][payments_per_period]"=13 \
  -d "payment_method_options[payto][mandate_options][start_date]"=2026-12-25 \
  -d "payment_method_options[payto][mandate_options][end_date]"=2036-12-25 \
  -d "payment_method_options[payto][mandate_options][purpose]"=mortgage \
  -d "payment_method_types[]"=card \
  -d "payment_method_types[]"=payto \
  --data-urlencode success_url="https://example.com/success"

Stripe unterstützt verschiedene Arten von Mandaten, wobei Betrag, Dauer, Frequenz und der Zweck des Mandats gesteuert werden können. Gestalten Sie Ihre Mandatsbedingungen so, dass sie am besten zu Ihren Anforderungen passen. Kundinnen und Kunden sehen diese genauen Konditionen zum Zeitpunkt der Autorisierung, unmissverständliche Formulierungen können daher Ihre Konversionsrate verbessern.

Stripe legt den Standardwert purpose auf der Grundlage Ihres Händlerkategorie-Codes (MCC) fest. Überschreiben Sie dieses Feld mit einem der gültigen Werte, wenn der Standardwert den Zweck des Mandats nicht genau wiedergibt. Sie können den Standardwert im Objekt Mandat prüfen, wenn Sie den Zweck nicht angeben.

PayTo PaymentMethod später belasten

Bevor Sie Ihre Kundin/Ihren Kunden belasten können, ermitteln Sie die Mandats-ID, die Kunden-ID und die Zahlungsmethoden-ID, indem Sie den SetupIntent anhand seiner ID aus der Checkout-Session abrufen.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/setup_intents/
{{SETUP_INTENT_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Sehen Sie sich die erforderlichen IDs in der Antwort unten an.

{
  // ...
  "customer": "cus_PW6rQWRGAaBD7z",  // <---- Here is the customer
  "mandate": "mandate_1Ok6ZrA8DuEjWaGw2nrO9xeS", // <---- Here is the mandate
  "metadata": {},
  "next_action": null,
  "on_behalf_of": null,
  "payment_method": "pm_1Ok4l9A8DuEjWaGwhB4SGrWh", // <---- Here is the payment method
  "payment_method_configuration_details": null,
  "payment_method_options": {
    "payto": {
      "mandate_options": {
        "amount": 150000,
        "amount_type": "maximum",
        "start_date": "2026-12-25",
        "end_date": "2036-12-25",
        "payment_schedule": "annual",
        "payments_per_period": 13,
        "purpose": "mortgage",
      }
    }
  },
  "payment_method_types": [
    "payto"
  ],
  "single_use_mandate": null,
  "status": "succeeded",
  "usage": "off_session"
  // ...
}

Erstellen Sie einen PaymentIntent mit PaymentMethod-, Mandats- und Kunden-ID.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_types[]"=payto \
  -d amount=1099 \
  -d currency=aud \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d payment_method=
"{{PAYMENT_METHOD_ID}}"
 \
  -d mandate=
"{{MANDATE_ID}}"
 \
  -d confirm=true

Abwicklung Ihrer Bestellungen

Informieren Sie sich über die Ausführung von Bestellungen, nachdem Sie eine Zahlung angenommen haben.

Ihre Integration testen

Testen Sie Ihre PayTo-Integration mit Ihren Test-API-Schlüsseln, indem Sie die verschiedenen Test-PayIDs und Bankkontodaten unten verwenden. Jeder Datensatz hat ein anderes Szenario zufolge, mit dem Ihre Integration im Live-Modus häufig konfrontiert wird.

PayIDBeschreibung
{any_prefix}+succeed@{any_domain}Der Status des PaymentIntent wechselt nach 10 Sekunden von requires_action zu processing und dann nach weiteren 5 Sekunden zu succeeded. Das Mandat geht in den Status active über.
{any_prefix}+decline@{any_domain}Der Status des PaymentIntent wechselt nach 10 Sekunden von requires_action zu requires_payment_method. Stripe gibt den Fehlercode payment_method_provider_decline und den Ablehnungscode invalid_authorization zurück. Das Mandat geht in den Status inactive über.
{any_prefix}+expire@{any_domain}Der Status des PaymentIntent wechselt nach 10 Minuten von requires_action zu requires_payment_method. Stripe gibt den Fehlercode payment_method_provider_decline und den Ablehnungscode generic_decline zurück. Das Mandat geht in den Status inactive über.
{any_prefix}+insufficient_funds@{any_domain}Der Status des PaymentIntent wechselt nach 10 Sekunden von requires_action zu processing und dann nach weiteren 5 Sekunden zu requires_payment_method . Stripe gibt den Fehlercode payment_method_provider_decline und den Ablehnungscode insufficient_funds zurück. Das Mandat geht in den Status inactive über.
{any_prefix}+revoke@{any_domain}Der Status des PaymentIntent wechselt nach 10 Sekunden von requires_action zu processing und dann nach weiteren 5 Sekunden zu succeeded. Das Mandat beginnt im Status active und wechselt nach 1 Minute zu inactive.
{any_prefix}+agreement_type_not_supported@{any_domain}Der PaymentIntent Status wechselt nach 10 Sekunden von requires_action zu requires_payment_method. Stripe gibt den Fehlercode payment_method_provider_decline zurück. Das Mandat geht in den Status inactive über.
War diese Seite hilfreich?
JaNein