Angaben zur Zahlungsmethode für künftige Zahlungen per vorab autorisierter Abbuchung in Kanada speichern
Speichern Sie die Angaben zur Zahlungsmethode für zukünftige Zahlungen per vorab autorisierter Abbuchung in Kanada.
Sie können die Setup Intents API verwenden, um Details zur Zahlungsmethode im Voraus zu erfassen, wobei der endgültige Betrag oder das Zahlungsdatum später festgelegt wird. Dies ist nützlich für Folgendes:
- Speichern von Zahlungsmethoden in einer Geldbörse, um künftige Käufe zu optimieren
- Einziehen von Zuschlägen nach Erbringung einer Dienstleistung
- Einrichtung kostenloser Probeabonnements
Notiz
Pre-authorized debit in Canada ist eine Zahlungsmethode mit verzögerter Benachrichtigung. Dies bedeutet, dass Gelder nicht sofort nach der Zahlung verfügbar sind. Eine Zahlung benötigt in der Regel 5 business days bis zum Eingang auf Ihrem Konto.
Die meisten Bankkonten in Kanada werden in kanadischen Dollar (CAD) geführt, während nur sehr wenige andere Währungen wie den US-Dollar (USD) unterstützen. PAD-Zahlungen können sowohl in CAD als auch in USD angenommen werden, wobei es zur Vermeidung von Zahlungsfehlschlägen wichtig ist, die korrekte Währung für Ihre Kund/innen zu wählen.
Im Gegensatz zu den meisten kartenbasierten Zahlungsmethoden können Sie ein CAD-Konto ggf. nicht erfolgreich in USD belasten und umgekehrt ein USD-Konto nicht in CAD belasten. In den meisten Fällen kommt es bei einem solchen Versuch noch nach bis zu fünf Werktagen zu einem verzögerten Fehlschlagen der Zahlung.
Um das zu vermeiden, sollten Sie PAD-Zahlungen möglichst in CAD einrichten, sei denn, Sie sind sicher, dass das Kundenkonto Lastschriften in USD akzeptiert.
Stripe einrichtenServerseitig
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:
Kund/innen erstellen oder abrufenServerseitig
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.
Zukünftige Zahlungen einrichten
Notiz
Dieser Leitfaden beruht auf der grundlegenden Checkout-Integration für die Einrichtung von zukünftigen Zahlungen.
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:
Pre-authorized debit in Canada
- Fügen Sie
acss_
zur Liste derdebit payment_
hinzu.method_ types - 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:
Parameter | Wert | Pflichtfeld |
---|---|---|
payment_ | Währung, die mit dieser Zahlungsmethode für zukünftige Zahlungen verwendet werden soll. Muss mit der Währung des Bankkontos der Kundin/des Kunden übereinstimmen. Akzeptierte Werte sind cad or usd . | Ja |
payment_ | Der Zahlungsplan des Mandats. Folgende Werte werden unterstützt: interval , sporadic oder combined . In der Übersicht PAD-Mandate können Sie die passende Intervallbeschreibung für Ihr Unternehmen wählen. | Ja |
payment_ | Textbeschreibung des Zahlungsplans. In der Übersicht PAD-Mandate können Sie die passende Intervallbeschreibung für Ihr Unternehmen erstellen. | Erforderlich, wenn der Wert payment_ interval oder combined ist |
payment_ | Die Art des zu erstellenden Mandats, entweder personal (wenn es sich bei der Kundin/dem Kunden um eine Einzelperson handelt) oder business (wenn es sich um ein Unternehmen handelt). | Ja |
Checkout-Sitzung erstellen
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.
Integration testen
E-Mail zur Verifizierung der Testeinzahlung erhalten
In order to receive the micro-deposit verification email in a sandbox after collecting the bank account details and accepting a mandate, provide an email in the payment_
field in the form of {any_
when confirming the payment method details.
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.
Institutsnummer | Transitnummer | Kontonummer | Szenario |
---|---|---|---|
000 | 11000 | 000123456789 | Die Zahlung ist sofort nach Prüfung der Testeinzahlungen erfolgreich. |
000 | 11000 | 900123456789 | Die Zahlung ist mit einer Verzögerung von drei Minuten nach Prüfung der Testeinzahlungen erfolgreich. |
000 | 11000 | 000222222227 | Die Zahlung schlägt sofort nach Prüfung der Testeinzahlungen fehl. |
000 | 11000 | 900222222227 | Die Zahlung schlägt mit einer Verzögerung von drei Minuten nach Prüfung der Testeinzahlungen fehl. |
000 | 11000 | 000666666661 | Die Testeinzahlungen zur Verifizierung schlagen fehl. |
000 | 11000 | 000777777771 | Fails the payment due to the payment amount causing the account to exceed its weekly payment volume limit. |
000 | 11000 | 000888888881 | Fails the payment due to the payment amount exceeding the account’s transaction limit. |
To mimic successful or failed bank account verifications in a sandbox, use these meaningful amounts for micro-deposits:
Werte für Testeinzahlungen | Szenario |
---|---|
32 und 45 | Die Verifizierung des Kontos ist erfolgreich. |
10 und 11 | Simuliert das Überschreiten der Anzahl zulässiger Verifizierungsversuche. |
Jede andere Zahlenkombination | Die Verifizierung des Kontos schlägt fehl. |
Zahlungsmethode verwendenServerseitig
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.
Achtung
Zukünftige vorab autorisierte Lastschriftzahlungen müssen gemäß den Bedingungen des bestehenden Mandats abgebucht werden. Eine Abbuchung, die diese Bedingungen nicht erfüllt, könnte in einer angefochtenen Zahlung resultieren.
Wenn Sie bereit sind, eine Off-Session-Belastung eines Kundenkontos vorzunehmen, geben Sie beim Erstellen eines PaymentIntent die customer
-, payment_
-, und mandate
-IDs an.