Angaben zur Zahlungsmethode für künftige Zahlungen per vorab autorisierter Abbuchung in Kanada speichern

Zunächst 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'

Um ein Bankkonto für zukünftige Zahlungen wiederzuverwenden, muss es einer Kundin/einem Kunden zugeordnet werden.

Erstellen Sie ein Kundenobjekt, wenn Ihre Kundinnen/Kunden ein Konto bei Ihrem Unternehmen anlegen. Wenn Sie die ID des Kundenobjekts mit Ihrer eigenen Darstellung eines Kunden/einer Kundin verknüpfen, können Sie später die gespeicherten Angaben zur Zahlungsmethode abrufen und verwenden. Wenn Ihre Kundinnen/Kunden noch kein Konto erstellt haben, können Sie jetzt trotzdem ein Kundenobjekt erstellen und es zu einem späteren Zeitpunkt mit Ihrer eigenen internen Darstellung des Kundenkontos verknüpfen.

Legen Sie neue Kund/innen an oder rufen Sie bestehende Kund/innen ab, um sie mit diesen Kartendaten zu verknüpfen. Fügen Sie den folgenden Code auf Ihrem Server ein, um neue Kund/innen zu erstellen.

curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

In diesem Leitfaden erfahren Sie, wie Sie kanadische Pre-Authorized Debits (PADs) aktivieren. Er zeigt die Unterschiede zwischen der Einrichtung zukünftiger payments und der Verwendung von PADs.

Vorab autorisierte Lastschriftzahlungen in Kanada als Zahlungsmethode aktivieren

Führen Sie bei der Erstellung einer neuen Checkout-Sitzung folgende Schritte aus:

1. Fügen Sie acss_debit zur Liste der payment_method_types hinzu.
2. Geben Sie zusätzliche payment_method_options-Parameter an, die Ihre Transaktion beschreiben. Nachfolgend finden Sie weitere Details.

Bei Zahlungen muss ein Zahlungsplan festgelegt werden, den Kundinnen/Kunden beim Bezahlvorgang autorisieren können. Unter PAD-Mandate finden Sie weitere Informationen dazu, wie Sie die passenden Mandatsoptionen für Ihr Unternehmen auswählen:

Checkout-Sitzung erstellen

Stripe::Checkout::Session.create({
  mode: 'setup',
  payment_method_types: ['card'],
  payment_method_types: ['acss_debit'],

  # or you can take multiple payment methods with
  # payment_method_types: ['card', 'acss_debit', ...]
  payment_method_options: {
    acss_debit: {
      currency: 'cad',
      mandate_options: {
        payment_schedule: 'interval',
        interval_description: 'First day of every month',
        transaction_type: 'personal',
      }
    }
  },
  customer: customer.id,
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Während der Checkout-Sitzung wird den Kundinnen/Kunden ein Nutzeroberflächenmodal angezeigt, das die Erfassung der Bankkontodaten und die sofortige Verifizierung mit Ausweichoption auf die Verifizierung mittels Testeinzahlungen abwickelt. Wenn der Kunde/die Kundin sich für die Verifizierung der Testeinzahlung entscheidet, sendet Stripe automatisch zwei kleine Einzahlungen auf das angegebene Bankkonto, die innerhalb von 1–2 Werktagen dauert auf dem Online-Auszug des Kunden/der Kundin erscheinen. Wenn das Eintreffen der Einzahlungen erwartet wird, erhält der Kunde/die Kundin eine E-Mail mit einem Link, um diese Beträge zu bestätigen und das Bankkonto mit Stripe zu verifizieren. Nach Abschluss der Verifizierung kann die Zahlungsmethode für zukünftige Zahlungen verwendet werden.

E-Mail zur Verifizierung der Testeinzahlung erhalten

Um die E-Mail zur Verifizierung der Testeinzahlung in einer Sandbox zu erhalten, nachdem Sie die Bankkontodaten erfasst und ein Mandat angenommen haben, geben Sie bei der Bestätigung der Details der Zahlungsmethode im Feld payment_method[billing_details][email] eine E-Mail-Adresse im folgenden Format an: {any_prefix}+test_email@{any_domain}.

Testkontonummern

Stripe stellt mehrere Testnummern zur Verfügung, um sicherzustellen, dass Ihre Integration für manuell eingegebene Bankkontodaten produktionsbereit ist. Alle Testkonten, die eine Zahlung automatisch ausführen oder fehlschlagen lassen, müssen vor dem Zahlungsabschluss anhand der unten aufgeführten Testeinzahlungen überprüft werden.

Um erfolgreiche oder fehlgeschlagene Bankkontoverifizierungen in einer Sandbox zu imitieren, verwenden Sie die folgenden aussagekräftigen Beträge für Testeinzahlungen:

Nach Abschluss der Checkout-Sitzung können Sie die PaymentMethod-ID und eine Mandats-ID erfassen. Damit können künftige Zahlungen eingeleitet werden, ohne dass die Kundin/der Kunde das Bankkonto erneut angeben muss.

Wenn Sie bereit sind, eine Off-Session-Belastung eines Kundenkontos vorzunehmen, geben Sie beim Erstellen eines PaymentIntent die customer-, payment_method-, und mandate-IDs an.

Wenn Sie die SetupIntent-ID noch nicht erfasst haben, suchen Sie die PaymentMethod und das Mandat, um eine Abbuchung vorzunehmen, indem Sie die mit Ihrer Kundin oder Ihrem Kunden verknüpften SetupIntents auflisten:

curl -G https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}"

Wiederverwenden einer Zahlungsmethode mit bestehendem, autorisiertem Mandat

Wenn Ihnen die PaymentMethod-ID und die Mandats-ID aus dem entsprechenden SetupIntent vorliegen, erstellen Sie einen PaymentIntent mit dem Betrag und der Währung der Zahlung. Legen Sie einige weitere Parameter fest, um die Off-Session-Zahlung durchzuführen:

• Legen Sie den Wert der Eigenschaft confirm des PaymentIntent auf true fest. Dadurch erfolgt die Bestätigung sofort, wenn der PaymentIntent erstellt wird.
• Setzen Sie payment_method auf die ID der PaymentMethod, Mandat auf die ID des Mandats und Kunde/Kundin auf die ID der Kundin/des Kunden.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_types[]"=acss_debit \
  -d payment_method=
"{{PAYMENT_METHOD_ID}}" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d mandate=
"{{MANDATE_ID}}" \
  -d confirm=true \
  -d amount=100 \
  -d currency=cad

Wird ein bestehendes Mandat mit dem neuen PaymentIntent wiederverwendet, muss zu diesem Zeitpunkt eine E-Mail mit Abbuchungsbenachrichtigung gesendet werden. Stripe übernimmt das standardmäßig für Sie, es sei denn, Sie entscheiden sich für den Versand nutzerdefinierter Benachrichtigungen.