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-Lastschriftverfahren müssen Sie das Ereignis payment_intent.succeeded verarbeiten, um zu bestätigen, dass die Zahlung erfolgreich war. Stripe empfiehlt außerdem 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
Es gibt mehrere Testbankkontonummern, die Sie in einer Sandbox verwenden können. So können Sie sicherstellen, dass diese Integration bereit ist.
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 | Die Zahlung schlägt mit dem Fehlercode charge_ fehl, da der Zahlungsbetrag dazu führt, dass das Konto sein wöchentliches Zahlungsvolumenlimit überschreitet. |
108800 | 12121212 | Die Zahlung schlägt mit dem Fehlercode charge_ fehl, da der Zahlungsbetrag das Transaktionsvolumenlimit des Kontos überschreitet. |
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
Standardmäßig sendet Stripe den Kundinnen und Kunden bei der erstmaligen Erfassung ihrer Zahlungsinformationen sowie bei jeder Kontobelastung automatisch E-Mails. Diese Benachrichtigungen werden nicht in Sandboxes gesendet.
Fehlgeschlagene Zahlungen
Zahlungen können aus verschiedenen Gründen fehlschlagen. Die Ursache für einen Fehler kann über charge.failure_code abgerufen werden. Nur Zahlungen mit bestimmten Fehlercodes können erneut durchgeführt werden. Wenn eine Zahlung nicht wiederholt werden kann, empfehlen wir Ihnen, Kontakt zu den Betroffenen aufzunehmen und diese aufzufordern, die Zahlung mit einem anderen Bankkonto oder einer anderen Zahlungsmethode erneut zu tätigen.
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_ | Die Kontonummer ist ungültig. Möglicherweise bezieht sie sich auf ein Konto in einer anderen Währung als GBP. Oder über das Konto können keine Zahlungen per Lastschrift verarbeitet werden. | 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.