Zahlungen per Bacs-Lastschriftverfahren
So nehmen Sie Bacs-Lastschriftzahlungen an.
Im Vereinigten Königreich kann das Payment Element and a Payment Intent zur Annahme von Bacs-Lastschriften über Bankkonten aus diesem Land genutzt werden.
Erste Schritte
Sie müssen ein Payment Element integrieren, um mit dem Payment Element Bacs-Lastschriften annehmen zu können. Befolgen Sie dazu unsere Kurzanleitung zur Zahlungsannahme mit dem Payment Element.
Notiz
Die Regeln des Bacs-Lastschriftverfahrens erfordern, dass die Kundinnen/Kunden ein Mandat akzeptieren, damit Stripe ihr Konto belasten kann. Wenn die Zahlungsdetails akzeptiert werden, erfasst das Payment Element dieses Mandat, sodass Sie nichts unternehmen müssen, um dieser Anforderung nachzukommen.
Payment Element für Bacs-Lastschriften einrichten
Notiz
Das Bacs-Lastschriftverfahren ist nur bei Zahlungen in GBP verfügbar. Wenn Ihr Payment Intent eine andere Währung verwendet, sind Bacs-Lastschriften nicht möglich.
Sie können Bacs Direct Debit auf zwei Arten als Zahlungsmethode in Ihrer Payment Element-Integration zur Verfügung stellen.
Handhabung von Ereignissen nach der Zahlung
Zahlungen per Bacs-Lastschriftverfahren sind eine asynchrone Methode, daher sind die Gelder nicht sofort verfügbar.
Ein PaymentIntent für eine BACS-Lastschriftzahlung erstellt wurde, kann für ein neu erstelltes Mandat bis zu 5 Werktage nach ihrer Erstellung in einem ausstehenden Status verbleiben, für ein bestehendes Mandat bis zu 3 Werktage. Nach abgeschlossener Zahlung wird der Status des PaymentIntent in succeeded
aktualisiert.
Zeitrahmen für Bacs-Lastschriften
Mit einem bereits erteilten Mandat dauert es im Bacs-Lastschriftverfahren drei Werktage, bis Sie über den Erfolg oder das Fehlschlagen einer Zahlung unterrichtet werden. Muss das Mandat erst noch eingeholt werden, beträgt dieser Zeitraum sechs Werktage. Zahlungen, die nach 20:00 Uhr UTC getätigt werden, werden erst am nächsten Werktag abgewickelt.
In einigen Fällen zeigt uns die Bank möglicherweise eine fehlgeschlagene Zahlung an, nachdem die Zahlung in Ihrem Stripe-Konto bereits als erfolgreich gekennzeichnet wurde. In diesem Fall wird die fehlgeschlagene Zahlung als Anfechtung mit entsprechendem Ursachencode ausgewiesen.
Diese Tabelle veranschaulicht den zeitlichen Ablauf des Bacs-Lastschriftverfahrens in Werktagen ab dem Zahlungszeitpunkt (T) und der Einholung eines neuen Lastschriftmandats:
T+0 | Mandatserteilung |
T+3 | Mandatsaktivierung und Zahlungsübermittlung |
T+5 | Abbuchung vom Kundenkonto |
T+6 | Mittelverfügbarkeit in Stripe |
Webhooks einrichten
Stripe sendet beim Zahlungsvorgang und nach erfolgter Zahlung mehrere Ereignisse. Verwenden Sie das Webhook-Tool im Dashboard oder befolgen Sie die Webhook-Anleitung, um diese Ereignisse zu empfangen und führen Sie Aktionen aus, wie beispielsweise das Senden einer Bestellbestätigung per E-Mail, das Protokollieren des Verkaufs in der Datenbank oder das Starten eines Versand-Workflows.
Bei Bacs-Lastschriften müssen Sie das Ereignis payment_intent.succeeded verarbeiten, damit die Zahlung bestätigt werden kann. Außerdem empfiehlt Stripe die Verarbeitung der Ereignisse payment_intent.processing und payment_intent.payment_failed.
Verwenden Sie die Stripe-CLI, um Webhooks lokal zu testen. Nach der Installation können Sie Ereignisse an Ihren Server weiterleiten:
stripe listen --forward-to localhost:4242/webhook Ready! Your webhook signing secret is '{{WEBHOOK_SIGNING_SECRET}}' (^C to quit)
Erfahren Sie mehr über die Einrichtung von Webhooks.
Integration testen
There are several test bank account numbers you can use in a sandbox to make sure this integration is ready.
Bankleitzahl | Kontonummer | Beschreibung |
---|---|---|
108800 | 00012345 | Die Zahlung ist erfolgreich und der PaymentIntent von wird von processing auf succeeded umgestellt. |
108800 | 90012345 | Die Zahlung erfolgt innerhalb von drei Minuten und der PaymentIntent von wird von processing auf succeeded umgestellt. |
108800 | 33333335 | Die Zahlung wird akzeptiert, schlägt dann aber unmittelbar fehl. Die Fehlerkennung debit_ wird ausgegeben und PaymentIntent wird von processing auf requires_ umgestellt. Das Mandat wechselt zu inactive und die PaymentMethod kann nicht erneut verwendet werden. |
108800 | 93333335 | Die Zahlung schlägt nach drei Minuten fehl. Die Fehlerkennung debit_ wird ausgegeben und der PaymentIntent wird von processing auf requires_ umgestellt. Das Mandat wechselt zu inactive und die PaymentMethod kann nicht erneut verwendet werden. |
108800 | 22222227 | Die Zahlung schlägt fehl, die Fehlerkennung insufficient_ wird ausgegeben und der PaymentIntent wird von processing auf requires_ umgestellt. Das Mandat bleibt active und die PaymentMethod kann erneut verwendet werden. |
108800 | 92222227 | Die Zahlung schlägt nach drei Minuten fehl, die Fehlerkennung insufficient_ wird ausgegeben und der PaymentIntent wird von processing auf requires_ umgestellt. Das Mandat bleibt active und die PaymentMethod kann erneut verwendet werden. |
108800 | 55555559 | Die Zahlung erfolgt innerhalb von drei Minuten und der PaymentIntent wechselt von processing zu succeeded . Eine Zahlungsanfechtung wird jedoch sofort erstellt. |
108800 | 00033333 | Die Zahlungsmethode wurde erfolgreich erstellt, das Mandat wird jedoch von der Kundenbank verweigert und sofort deaktiviert. |
108800 | 00044444 | Die Anfrage zur Einrichtung eines Bacs-Lastschriftverfahrens wird aufgrund einer ungültigen Kontonummer sofort abgelehnt. Die Kund/innen werden aufgefordert, ihre Angaben vor dem Absenden zu prüfen. Zahlungsinformationen werden nicht erfasst. |
108800 | 34343434 | The payment fails with a charge_ failure code due to the payment amount causing the account to exceed its weekly payment volume limit. |
108800 | 12121212 | The payment fails with a charge_ failure code due to the payment amount exceeding the account’s transaction volume limit. |
Sie können die oben aufgeführten Kontonummern nach Belieben testen. Da die Verarbeitung von Zahlungen per Bacs-Lastschriftverfahren mehrere Tage in Anspruch nimmt, verwenden Sie bitte die Testkontonummern. Bei diesen ist eine dreiminütige Verzögerung eingebaut, um tatsächliche Zahlungen möglichst exakt nachzubilden.
Notiz
By default, Stripe automatically sends emails to the customer when payment details are initially collected and each time a debit will be made on their account. These notifications aren’t sent in sandboxes.
Fehlgeschlagene Zahlungen
Payments can fail for a variety of reasons. The reason for a failure is available through charge.failure_code. Only payments with certain failure codes may be retried. If a payment can’t be retried, we recommend reaching out to the customer and asking them to pay again using a different bank account or a different payment method.
Unten finden Sie eine Liste der aktuellen Fehlercodes für das BACS-Lastschriftverfahren. Die Liste wird laufend ergänzt. Gehen Sie also davon aus, dass noch andere Fehlertypen existieren.
Fehlercode | Beschreibung | Wiederholbar |
---|---|---|
account_ | Das Bankkonto wurde geschlossen. | Nein |
bank_ | Das Konto wurde an einen anderen Zahlungsanbieter übertragen. Prüfen Sie, ob Ihnen dessen Angaben vorliegen. Andernfalls müssen Sie von den Betroffenen ein neues Lastschriftmandat einholen. | Nein |
debit_ | Die Zahlung wurde als nicht autorisiert gemeldet oder der Auszahlungsbank liegt kein entsprechendes Mandat vor. | Nein |
generic_ | Diese Zahlung konnte nicht bearbeitet werden. | Ja |
insufficient_ | Das Kundenkonto ist für diese Zahlung nicht ausreichend gedeckt. | Ja |
invalid_ | The account number is not valid. This could mean it is not for a GBP account or that the account can’t process Direct Debit payments. | Nein |
Um Zahlungen noch einmal zu versuchen, bestätigen Sie den PaymentIntent erneut mit derselben PaymentMethod.
Um die Erfolgsaussichten zu erhöhen, empfehlen wir vor dem erneuten Zahlungsversuch eine Kontaktaufnahme mit dem Zahler.