Abonnement per BECS-Lastschriftverfahren in Australien einrichten

Erfahren Sie, wie Sie ein Abonnement per BECS-Lastschriftverfahren einrichten und abrechnen können.

Notiz

Wenn Sie ein neuer Nutzer/eine neue Nutzerin sind, verwenden Sie das Payment Element, statt wie in diesem Leitfaden beschrieben Stripe Elements zu nutzen. Das Payment Element bietet einen Low-Code-Integrationspfad mit integrierten Konversionsoptimierungen. Eine Anleitung finden Sie unter Abonnement zusammenstellen.

Verwenden Sie diesen Leitfaden, um ein Abonnement mit BECS-Lastschriftverfahren als Zahlungsmethode einzurichten.

Produkt und Preis erstellen
Dashboard

Produkte stehen für den von Ihnen angebotenen Artikel oder Dienst. Preise geben an, wie viel und wie häufig Sie für ein Produkt berechnen. Dies schließt ein, wie viel ein Produkt kostet, welche Währung Sie akzeptieren und ob es sich um eine einmalige oder eine wiederkehrende Zahlung handelt. Wenn Sie nur ein paar wenige Produkte und Preise haben, können Sie diese im Dashboard erstellen und verwalten.

In diesem Leitfaden wird ein Stock-Foto-Service als Beispiel verwendet, für den Kund/innen ein monatliches Abonnement mit dem Betrag von 15 AUD berechnet werden. Um dies zu modellieren:

Gehen Sie zur Seite Produkte und klicken Sie auf Produkt erstellen.
Geben Sie einen Namen für das Produkt an. Sie können optional eine Beschreibung hinzufügen und ein Bild des Produkts hochladen.
Wählen Sie einen Produktsteuercode aus. Erfahren Sie mehr über Produktsteuercodes.
Wählen Sie Wiederkehrend aus. Geben Sie im Anschluss daran 15 für den Preis ein und wählen Sie AUD als Währung aus.
Wählen Sie, ob die Steuer im Preis berücksichtigt werden soll. Sie können entweder den Standardwert aus Ihren Steuereinstellungen verwenden oder den Wert manuell festlegen. Wählen Sie in diesem Beispiel Auto aus.
Wählen Sie Monatlich als Abrechnungszeitraum aus.
Klicken Sie auf Weitere Preisoptionen. Wählen Sie dann Pauschalpreis als Preismodell für dieses Beispiel aus. Erfahren Sie mehr über Pauschalpreise und andere Preismodelle.
Fügen Sie eine interne Preisbeschreibung und einen Lookup-Schlüssel hinzu, um bestimmte Preise in Zukunft zu organisieren, abzufragen und zu aktualisieren.
Klicken Sie auf Weiter. Klicken Sie dann auf Produkt hinzufügen.

Zeichnen Sie nach Erstellen des Produkts und des Preises die Preis-ID auf, sodass Sie diese in nachfolgenden Schritten verwenden können. Die ID wird auf der Preisseite angezeigt und sieht in etwa so aus: price_G0FvDp6vZvdwRZ.

SetupIntent erstellen
Serverseitig

Ein SetupIntent ist ein Objekt, das Ihre Absicht darstellt, die Zahlungsmethode einer Kundin/eines Kunden für zukünftige Zahlungen einzurichten. Mit dem SetupIntent werden die Schritte dieses Einrichtungsprozesses verfolgt. Für BECS-Lastschriftverfahren beinhaltet dies das Erfassen eines Mandats von der Kundin/dem Kunden und die Überprüfung der Gültigkeit während der Laufzeit des Mandats.

Erstellen Sie einen SetupIntent auf Ihrem Server. Setzen Sie dabei payment_method_types auf au_becs_debit:

Das zurückgegebene SetupIntent-Objekt enthält die Eigenschaft client_secret. Übergeben Sie das Client-Geheimnis an die Anwendung auf Client-Seite, um mit der Einrichtung fortzufahren.

Angaben zur Zahlungsmethode und Mandatsbestätigung erfassen
Clientseitig

Sie können jetzt mit Stripe Elements Zahlungsinformationen auf dem Client erfassen. Elements beinhaltet vorgefertigte Komponenten der Nutzeroberfläche zur Erfassung von Zahlungsdetails.

Ein Stripe Element enthält ein iframe, dass die Zahlungsdaten über eine HTTPS-Verbindung sicher an Stripe sendet. Die Adresse der Bezahlseite muss ebenfalls mit https:// beginnen, nicht mit http://, damit Ihre Integration funktioniert.

Sie können Ihre Integration ohne HTTPS testen. Dann müssen Sie das Protokoll aber aktivieren, bevor Sie Ihre ersten Live-Zahlungen empfangen.

Stripe Elements einrichten

Stripe Elements ist ein Feature von Stripe.js und steht damit automatisch zur Verfügung. Fügen Sie das Stripe.js-Skript auf Ihrer Zahlungsseite ein, indem Sie es in den head Ihrer HTML-Datei einbinden. Laden Sie Stripe.js immer direkt von js.stripe.com, um die PCI-Compliance zu gewährleisten. Fügen Sie das Skript nicht in ein Bundle ein und hosten Sie selbst keine Kopie davon.

Erstellen Sie auf Ihrer Zahlungsseite mit dem folgenden JavaScript eine Instanz von Elements:

Lastschriftanfragen

Bevor Sie eine BECS-Lastschriftzahlung erstellen können, muss Ihr/e Kund/in der Dienstleistungsvereinbarung zu Lastschriftenanfragen zustimmen. Dies können sie tun, indem sie eine ausgefüllte Lastschriftanfrage (DDR) einreichen. Durch die Genehmigung erhalten Sie ein Mandat, sein/ihr Konto zu belasten. Das Mandate ist eine Aufzeichnung der Zustimmung, Zahlungen über eine Zahlungsmethode einzuziehen.

Für die Mandatsannahme online können Sie ein Formular erstellen, um die erforderlichen Informationen einzuholen. Stellen Sie das Formular über HTTPS bereit und erfassen Sie die folgenden Informationen:

Informationen	Beschreibung
Kontoname	Der vollständige Name des Kontoinhabers/der Kontoinhaberin
BSB-Nummer	Die Zweigniederlassungsnummer des Bankkontos (z. B. `123-456`)
Kontonummer	Die Bankkontonummer (z. B. `87654321`).

Bei Einzug einer Lastschriftanforderung befolgen Sie unsere BECS-Lastschriftbedingungen und tun Sie im Rahmen Ihres Bezahlformulars Folgendes:

Zeigen Sie die genauen Bedingungen der Stripe-Dienstleistungsvereinbarung zu Lastschriftenanfragen entweder inline im Formular oder auf einer im Formular verlinkten Seite an und kennzeichnen Sie diese als „Dienstleistungsvereinbarung zu Lastschriftanfragen“.
Stellen Sie sicher, dass die akzeptierten Lastschriftanfragen und die dazugehörige Dienstleistungsvereinbarung zu Lastschriftenanfragen zu jeder Zeit mit Ihren Kundinnen/Kunden geteilt werden kann, entweder als gedruckte oder unveränderliche elektronische Kopie (z. B. E-Mail). Stripe hostet dies für Sie.
Zeigen Sie den folgenden Standard-Autorisierungstext für Ihre Kund/innen an, um BECS-Lastschriftanfragen zu akzeptieren. Ersetzen Sie Rocketship Inc durch den Namen Ihres Unternehmens. Dadurch sind Sie berechtigt, Zahlungen mit BECS-Lastschrift vom Bankkonto Ihrer Kund/innen zu veranlassen.

Notiz

Mit der Angabe Ihrer Bankdaten erklären Sie sich mit dieser Lastschriftanforderung und der Dienstleistungsvereinbarung Lastschriftverfahren einverstanden und autorisieren Stripe Payments Australia Pty Ltd ACN 160 180 343, Lastschriftverfahren-Nutzer-ID 507156 („Stripe“), Ihr Konto über das Bulk Electronic Clearing System (BECS) im Namen von Rocketship Inc (dem „Händler“) für Zahlungen gemäß den Bedingungen Ihrer Vereinbarung mit dem Händler/der Händlerin zu belasten. Sie bestätigen, dass Sie entweder Kontoinhaber oder Zeichnungsberechtigter des oben genannten Kontos sind.

Die Details des akzeptierten Mandats werden beim Einrichten einer PaymentMethod oder beim Bestätigen eines PaymentIntent generiert. Sie sollten jederzeit in der Lage sein, dieses Mandat – die akzeptierten Lastschriftanfragen und die dazugehörige Dienstleistungsvereinbarung – entweder in gedruckter Form oder als unveränderliche elektronische Kopie (z. B. per E-Mail) mit Ihren Kundinnen/Kunden zu teilen. Stripe hostet dies für Sie unter der url-Eigenschaft des Mandate-Objekts, das mit der PaymentMethod verknüpft ist.

Australisches Bankkontoelement hinzufügen und konfigurieren

Das australische Bankkontoelement hilft Ihnen beim Einziehen und Validieren der BSB-Nummer und der Kontonummer. Stellen Sie sicher, dass es in Ihrem Zahlungsformular erscheint. Erstellen Sie in Ihrem Zahlungsformular leere DOM-Knoten (Container) mit einmaligen IDs. Außerdem müssen Ihre Kund/innen die Nutzungsvereinbarung für Lastschriftanforderungen lesen und akzeptieren.

Wenn das Formular geladen wurde, erstellen Sie eine Instanz des Australia Bank Account Element und verbinden sie mit dem Element-Container:

Angaben zur Zahlungsmethode an Stripe senden
Clientseitig

Anstatt das gesamte SetupIntent-Objekt an den Client zu senden, verwenden Sie dessen Client-Geheimnis aus Schritt 2. Dieses unterscheidet sich von Ihren API-Schlüsseln, mit denen Anfragen der Stripe-API authentifiziert werden.

Achten Sie auf einen sorgfältigen Umgang mit dem Client-Geheimnis, da mit ihm die Einrichtung abgeschlossen werden kann. Es darf nicht protokolliert, in URLs eingebettet oder Dritten zugänglich gemacht werden.

Verwenden Sie stripe.confirmAuBecsDebitSetup, damit die Einrichtung abgeschlossen werden kann, wenn der/die Nutzer/in das Formular absendet. War die Einrichtung erfolgreich, wird der Wert succeeded für die Eigenschaft status des SetupIntent zurückgegeben. War die Einrichtung nicht erfolgreich, prüfen Sie den angegebenen error, um den Grund zu erfahren.

Teilen Sie nach Bestätigung des SetupIntent die Mandats-URL aus dem Mandats-Objekt mit Ihrem Kunden/Ihrer Kundin. Wir empfehlen außerdem, die folgenden Details hinzuzufügen, wenn Sie bestätigen, dass sein/ihr Mandat eingerichtet wurde.

Eine eindeutige Bestätigungsnachricht über die Einrichtung des Lastschriftverfahrens
Der Name des Unternehmens, der auf den Kontoauszügen von Kund/innen angezeigt wird, wenn ihr Konto belastet wird
Der Zahlungsbetrag und der Zahlungsplan (falls zutreffend)
Ein Link zur generierten Mandats-URL für Lastschriftanfragen

Sie können vom mandate für das SetupIntent-Objekt aus auf die ID des Mandate-Objekts zugreifen, das nach Bestätigung zusammen mit dem Ereignis setup_intent.succeeded gesendet wird. Oder Sie können sie über die API abrufen.

Kundin/Kunde mit PaymentMethod erstellen
Serverseitig

Für die Erstellung von Abonnements wird ein Customer-Objekt benötigt, das für die Kundin/den Kunden steht, die/der Ihr Produkt kauft. Da der von Ihnen erstellte Preis monatlich berechnet wird, müssen Sie Ihren Kund/innen eine gespeicherte Zahlungsmethode hinzufügen, damit zukünftige Zahlungen erfolgreich sind. Hierfür wird die zuvor erfasste Zahlungsmethode auf das übergeordnete Customer-Objekt und als Standard-Zahlungsmethode für Rechnungen festgelegt:

Gibt ein Customer-Objekt zurück. Sie können die Standard-Zahlungsmethode im invoice_settings-Objekt anzeigen:

Speichern Sie nach dem Erstellen der Kundin/des Kunden den Wert id zur späteren Verwendung in Ihrer Datenbank. Auch im nächsten Schritt wird diese ID benötigt.

Abonnement erstellen
Serverseitig

Erstellen Sie ein Abonnement mit dem Preis und dem Kunden/der Kundin:

Durch das Erstellen von Abonnements werden Kundenzahlungen automatisch abgewickelt, weil die Standard-Zahlungsmethode festgelegt wird. Nach einer erfolgreichen Zahlung ändert sich der Status im Stripe-Dashboard in Aktiv. Der Preis, den Sie zuvor erstellt haben, bestimmt nachfolgende Abrechnungen.

Abonnementstatus verwalten
Clientseitig

Wenn die erste Zahlung erfolgreich war, ist der Status des Abonnements active und es sind keine weiteren Maßnahmen erforderlich. Wenn Zahlungen fehlschlagen, wird der Status in den Status des Abonnements geändert, der in Ihren Einstellungen für den automatischen Einzug konfiguriert ist. Benachrichtigen Sie die Kundin / den Kunden nach einem Fehlschlag und wickeln Sie die Zahlung mit einer anderen Zahlungsmethode ab.

Notiz

BECS-Lastschriftzahlungen werden nie automatisch wiederholt, auch dann nicht, wenn Sie einen Wiederholungsplan für andere Zahlungsmethoden konfiguriert haben.

Integration testen

Sie können Ihr Formular mit der BSB-Nummer 000000 und einer der unten aufgeführten Kontonummern testen, wenn Sie confirmAuBecsDebitSetup anfordern.

BSB-Nummer	Kontonummer	Beschreibung
`000000`	`000123456`	Der mit der resultierenden PaymentMethod erstellte PaymentIntent wechselt von `processing` zu `succeeded`. Der Mandatsstatus bleibt `active`.
`000000`	`900123456`	Der mit der resultierenden PaymentMethod erstellte PaymentIntent wechselt von `processing` zu `succeeded` (mit einer Verzögerung von drei Minuten). Der Mandatsstatus bleibt `active`.
`000000`	`111111113`	Der mit der resultierenden PaymentMethod erstellte PaymentIntent wechselt von `processing` zu `requires_payment_method` mit dem Fehlercode `account_closed`. Der Mandatsstatus ändert sich an dieser Stelle in `inactive`.
`000000`	`111111116`	Der mit der resultierenden PaymentMethod erstellte PaymentIntent wechselt von `processing` zu `requires_payment_method` mit dem Fehlercode `no_account`. Der Mandatsstatus ändert sich an dieser Stelle in `inactive`.
`000000`	`222222227`	Der mit der resultierenden PaymentMethod erstellte PaymentIntent wechselt von `processing` zu `requires_payment_method` mit dem Fehlercode `refer_to_customer`. Der Mandatsstatus bleibt `active`.
`000000`	`922222227`	Der mit der resultierenden PaymentMethod erstellte PaymentIntent wechselt von `processing` zu `requires_payment_method` mit dem Fehlercode `refer_to_customer` (mit einer Verzögerung von drei Minuten). Der Mandatsstatus bleibt `active`.
`000000`	`333333335`	Der mit der resultierenden PaymentMethod erstellte PaymentIntent wechselt von `processing` zu `requires_payment_method` mit dem Fehlercode `debit_not_authorized`. Der Mandatsstatus ändert sich an dieser Stelle in `inactive`.
`000000`	`666666660`	Der mit der resultierenden PaymentMethod erstellte PaymentIntent wechselt von `processing` zu `succeeded`. Eine Zahlungsanfechtung wird jedoch sofort erstellt.
`000000`	`343434343`	Der mit der resultierenden PaymentMethod erstellte PaymentIntent schlägt mit dem Fehler `charge_exceeds_source_limit` fehl, da der Zahlungsbetrag dazu führt, dass das Konto sein wöchentliches Limit für das Zahlungsvolumen überschreitet.
`000000`	`121212121`	Der mit der resultierenden PaymentMethod erstellte PaymentIntent schlägt mit dem Fehler `charge_exceeds_transaction_limit` fehl, da der Zahlungsbetrag das Transaktionsvolumenlimit des Kontos überschreitet.

OptionalLegen Sie den Rechnungsstellungszeitraum fest

Wenn Sie ein Abonnement erstellen, wird der Abrechnungszyklus automatisch auf Standard eingestellt. Wenn ein Kunde/eine Kundin beispielsweise am 7. September einen monatlichen Plan abonniert, wird dies danach am 7. jedes Monats in Rechnung gestellt. Manche Unternehmen legen ihren Abrechnungszyklus lieber selbst fest, damit sie ihren Kundinnen/Kunden jeden Zyklus zur selben Zeit in Rechnung stellen können. Das Argument Abrechnungszyklusanker macht dies möglich.

Durch manuelles Festlegen des Abrechnungszyklus wird dem Kunden/der Kundin automatisch ein anteilsmäßig verrechneter Betrag für die Zeit zwischen der Erstellung des Abonnements und dem Abrechnungszyklusanker berechnet. Wenn Sie Kundinnen/Kunden diesen Zeitraum nicht in Rechnung stellen möchten, können Sie das Argument proration_behavior auf none setzen. Sie können den Abrechnungszyklusanker auch mit Testzeiträumen kombinieren, um Nutzern und Nutzerinnen kostenlosen Zugriff auf Ihr Produkt zu gewähren und ihnen dann einen anteiligen Betrag zu berechnen.

OptionalAbonnement-Testphasen

Kostenlose Testphasen ermöglichen Kundinnen/Kunden, Ihr Produkt für einen begrenzten Zeitraum ohne Gebühren zu nutzen. Die Nutzung kostenloser Testphasen unterscheidet sich vom Festlegen bdes proration_behavior auf none, da Sie die Dauer der kostenlosen Testphase anpassen können. Übergeben Sie einen Zeitstempel im Ablauf der Testphase, um den Testzeitraum festzulegen.

Sie können einen Abrechnungszyklusanker auch mit einer kostenlosen Testphase kombinieren. Angenommen, es ist der 15. September und Sie möchten Ihrem Kunden/Ihrer Kundin eine kostenlose siebentägige Testphase schenken und am 1. Oktober mit dem normalen Abrechnungszyklus starten. Sie können den Ablauf der kostenlosen Testphase auf den 22. September festlegen und den Abrechnungszyklusanker auf den 1. Oktober. So kann der Kunde/die Kundin sieben Tage lang eine kostenlose Testversion nutzen und für den Zeitraum zwischen Ablauf der Testphase und dem 1. Oktober wird ein anteilsmäßig verrechneter Betrag berechnet. Am 1. Oktober berechnen Sie dem Kunden/der Kundin dann den normalen Abonnementbetrag für seinen/ihren ersten vollen Abrechnungszyklus.