Zahlungen per BECS-Lastschriftverfahren in Australien annehmen

So nehmen Sie australische BECS-Lastschriftzahlungen an.

Web

Mobilgeräte

Stripe-Nutzer/innen in Australien können das Payment Element und eine Zahlungsabsicht verwenden, um BECS-Lastschriftzahlungen von Kundinnen/Kunden mit einem AU-Bankkonto zu initiieren.

Vorsicht

Der Inhalt dieses Abschnitts bezieht sich auf ein Legacy-Produkt. Verwenden Sie den Leitfaden Zahlungen akzeptieren für den aktuellsten Integrationspfad. Auch wenn Stripe dieses Produkt jetzt noch unterstützt, kann sich dies ändern, wenn das Produkt nicht mehr unterstützt wird.

Verwenden Sie Stripe Elements, unsere vorkonfigurierten Nutzeroberflächenkomponenten, für die Erstellung von Zahlungsformularen, die Ihnen die sichere Erfassung von Kontodaten ermöglichen, ohne dass Sie die vertraulichen Daten selbst handhaben müssen. Für die Annahme von BECS-Lastschriftzahlungen auf Ihrer Website müssen Sie ein Objekt zur Nachverfolgung von Zahlungen erstellen, Informationen zur Zahlungsmethode und die Mandatsbestätigung erfassen und Zahlungen zur Verarbeitung an Stripe übermitteln. Stripe verwendet das Zahlungsobjekt, den PaymentIntent, zur Dokumentation und Verarbeitung aller Zahlungsstatus bis zum Zahlungsabschluss.

Stripe-Nutzer/innen in Australien können das Australia Bank Account Element und einen PaymentIntent für die Annahme von Kundenzahlungen per BECS-Lastschriftverfahren über australische Bankkonten verwenden.

Stripe einrichten
Serverseitig

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:

Kundinnen/Kunden erstellen oder abrufen
Serverseitig

Um ein BECS-Lastschriftkonto für zukünftige Zahlungen zu verwenden, müssen Sie es einem Customer-Objekt zuordnen.

Erstellen Sie ein Customer-Objekt, wenn Ihre Kund/innen ein Konto bei Ihrem Unternehmen anlegen. Wenn Sie die ID des Customer-Objekts mit Ihrer eigenen Darstellung einer Kundin/eines Kunden verknüpfen, können Sie später die gespeicherten Angaben zur Zahlungsmethode abrufen und verwenden.

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

Erstellen Sie ein PaymentIntent
Serverseitig

Ein PaymentIntent ist ein Objekt, das Ihre Absicht, Zahlungen von Kundinnen/Kunden einzuziehen, darstellt und den gesamten Zahlungsvorgang dokumentiert. Erstellen Sie zunächst einen PaymentIntent auf Ihrem Server und geben Sie den einzuziehenden Betrag und die Währung aud an (das BECS-Lastschriftverfahren unterstützt keine anderen Währungen). Falls Sie bereits über eine Integration verfügen, die die Payment Intents API verwendet, fügen Sie der Liste der Zahlungsmethoden für Ihren PaymentIntent die Zahlungsmethode au_becs_debit hinzu.

Um ein BECS-Lastschriftkonto für eine erneute Verwendung zu speichern, legen Sie den Parameter setup_future_usage auf off_session fest. Das BECS-Lastschriftverfahren akzeptiert für diesen Parameter nur den Wert off_session.

Nach Erstellen eines PaymentIntent gibt Stripe ein PaymentIntent-Objekt mit der Eigenschaft client_secret zurück. Übergeben Sie das Client-Geheimnis an die Client-Seite.

Achtung

Das Client-Geheimnis kann zum Belasten des/der Kund/in mit dem in dem PaymentIntent angegebenen Betrag genutzt werden. Es darf nicht protokolliert, in URLs eingebettet oder Personen außer den Kund/innen selbst zugänglich gemacht werden.

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.

submit_payment.html
<head>
  <title>Submit Payment</title>
  <script src="https://js.stripe.com/v3/"></script>
</head>

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

const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx'
);
const elements = stripe.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 die 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“.
Zeigen Sie den folgenden Standard-Autorisierungstext für Ihre Kund/innen an, um BECS-Lastschriftanfragen zu akzeptieren. Dadurch sind Sie berechtigt, Zahlungen mit BECS-Lastschrift vom Bankkonto Ihrer Kund/innen zu veranlassen.

Notiz

Indem Sie Ihre Bankkontoinformationen angeben und diese Zahlung bestätigen, stimmen Sie dieser Lastschriftanforderung und der Dienstleistungsvereinbarung zu Lastschriftenanfragen zu und ermächtigen Stripe Payments Australia Pty Ltd ACN 160 180 343, Lastschriften-Benutzer-ID 507156 („Stripe“), Ihr Konto über das Bulk Electronic Clearing System (BECS) im Namen (der „Händler“) zu belasten in Höhe jedweden Betrags, den Ihnen der Händler gesondert mitgeteilt hat. Sie bestätigen, dass Sie entweder Kontoinhaber/in oder Zeichnungsberechtige/r sind in Bezug auf das oben genannte Konto.

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. Fügen Sie es zu Ihrem Zahlungsformular hinzu, indem Sie leere DOM-Knoten (Container) mit einmaligen IDs erstellen. Außerdem müssen Ihre Kund/innen die Nutzungsvereinbarung für Lastschriftanforderungen lesen und akzeptieren.

submit_payment.html
HTML
<form action="/charge" method="post" id="payment-form">
  <div class="form-row inline">
    <div class="col">
      <label for="accountholder-name">
        Name
      </label>
      <input
        id="accountholder-name"
        name="accountholder-name"
        placeholder="John Smith"
        required
      />
    </div>
    <div class="col">
      <label for="email">
        Email Address
      </label>
      <input
        id="email"
        name="email"
        type="email"
        placeholder="john.smith@example.com"
        required
      />
    </div>
  </div>

  <div class="form-row">
    <!--
    Using a label with a for attribute that matches the ID of the
    Element container enables the Element to automatically gain focus
    when the customer clicks on the label.
    -->
    <label for="au-bank-account-element">
      Bank Account
    </label>
    <div id="au-bank-account-element">
      <!-- A Stripe Element will be inserted here. -->
    </div>
  </div>

  <!-- Used to display bank (branch) name associated with the entered BSB -->
  <div id="bank-name"></div>

  <!-- Used to display form errors. -->
  <div id="error-message" role="alert"></div>

  <!-- Display mandate acceptance text. -->
  <div class="col" id="mandate-acceptance">
    By providing your bank account details and confirming this payment,
    you agree to this Direct Debit Request and the
    <a href="stripe.com/au-becs-dd-service-agreement/legal">Direct Debit Request service agreement</a>,
    and authorise Stripe Payments Australia Pty Ltd ACN 160 180 343
    Direct Debit User ID number 507156 (“Stripe”) to debit your account
    through the Bulk Electronic Clearing System (BECS) on behalf of
    Rocket Rides (the "Merchant") for any amounts separately
    communicated to you by the Merchant. You certify that you are either
    an account holder or an authorised signatory on the account listed above.
  </div>

  <!-- Add the client_secret from the PaymentIntent as a data attribute -->
  <button id="submit-button" data-secret="{{CLIENT_SECRET}}">Confirm Payment</button>

</form>

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

// Custom styling can be passed to options when creating an Element
const style = {
  base: {
    color: '#32325d',
    fontSize: '16px',
    '::placeholder': {
      color: '#aab7c4'
    },
    ':-webkit-autofill': {
      color: '#32325d',
    },
  },
  invalid: {
    color: '#fa755a',
    iconColor: '#fa755a',
    ':-webkit-autofill': {
      color: '#fa755a',
    },
  }
};

const options = {
    style: style,
    disabled: false,
    hideIcon: false,
    iconStyle: "default", // or "solid"
}

// Create an instance of the auBankAccount Element.
const auBankAccount = elements.create('auBankAccount', options);

// Add an instance of the auBankAccount Element into
// the `au-bank-account-element` <div>.
auBankAccount.mount('#au-bank-account-element');

Zahlung an Stripe senden
Clientseitig

Anstatt das gesamte PaymentIntent-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.

Verwenden Sie stripe.confirmAuBecsDebitPayment, um das Lastschriftmandat einzuholen und die Zahlung abzuschließen, wenn der/die Nutzer/in das Formular abgesendet hat. Die Angabe von Kundenname und E-Mail-Adresse in der Eigenschaft billing_details des Parameters payment_method ist erforderlich, um die PaymentMethod BECS-Lastschriftverfahren zu erstellen.

const form = document.getElementById('payment-form');
const accountholderName = document.getElementById('accountholder-name');
const email = document.getElementById('email');
const submitButton = document.getElementById('submit-button');
const clientSecret = submitButton.dataset.secret;

form.addEventListener('submit', (event) => {
  event.preventDefault();
  stripe.confirmAuBecsDebitPayment(
    clientSecret,
    {
      payment_method: {
        au_becs_debit: auBankAccount,
        billing_details: {
          name: accountholderName.value,
          email: email.value
        }
      }
    }
  );
});

Teilen Sie nach Bestätigung des PaymentIntent die Mandats-URL des Mandats-Objekts 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 auf die ID des Mandate-Objekts über the payment_method_details für die latest_charge des PaymentIntent zugreifen, indem Sie sie abrufen

Nutzer/innen mit API-Version 2022-08-01 oder älter:

Sie können von payment_method_details im Zahlungsobjekt des PaymentIntent aus auf die ID des Mandate-Objekts zugreifen (enthalten im Ereignis payment_intent.processing, das nach Bestätigung gesendet wird). Oder Sie können sie abrufen.

Erfolgreichen PaymentIntent bestätigen
Serverseitig

BECS Direct Debit is a delayed notification payment method, which means that funds aren’t immediately available. A BECS Direct Debit PaymentIntent typically remains in a processing state for 2 business days after submission to the BECS network. This submission happens once per day. Once the payment succeeds, the associated PaymentIntent status updates from processing to succeeded.

Die folgenden Ereignisse werden übermittelt, wenn der PaymentIntent-Status aktualisiert wird:

Ereignis	Beschreibung	Nächste Schritte
`payment_intent.processing`	Die Zahlung der Kundin/des Kunden wurde erfolgreich an Stripe übermittelt.	Warten Sie, bis die initiierte Zahlung erfolgt oder fehlschlägt.
`payment_intent.succeeded`	Die Kundenzahlung war erfolgreich.	Führen Sie die Bestellung der gekauften Waren oder Dienstleistungen aus.
`payment_intent.payment_failed`	Die Zahlung des/der Kund/in wurde abgelehnt.	Kontaktieren Sie Ihren Kunden/Ihre Kundin per E-Mail oder Push-Benachrichtigung und fordern Sie eine andere Zahlungsmethode an.

Die PaymentMethod wird dem Kundenobjekt zugeordnet, sobald die Zahlung den Status processing hat, da setup_future_usage und Kundin/Kunde festgelegt wurden. Diese Zuordnung erfolgt unabhängig davon, ob die Zahlung später erfolgt oder fehlschlägt.

Wenn eine Lastschriftzahlung fehlschlägt, sendet Stripe das Ereignis payment_intent.payment_failed mit einem PaymentIntent-Objekt. Das Attribut last_payment_error auf dem PaymentIntent enthält einen code und eine message mit einer detaillierten Beschreibung der fehlgeschlagenen Zahlung.

Die fehlgeschlagenen Zahlungen können vorübergehend oder endgültig für das mit dem fehlgeschlagenen PaymentIntent verknüpften Mandat sein. Im Falle einer endgültig fehlgeschlagenen Zahlung widerruft Stripe das Mandat, um zusätzliche Kosten zu vermeiden. Wenn dies geschieht und Ihre Kundin/Ihr Kunde eine Zahlung leisten muss, müssen Sie Ihre Kundin/Ihren Kunden kontaktieren, um ein neues Mandat einzurichten, indem Sie die Bankkontoinformationen erneut erfassen.

Für die folgenden zurückgegebenen Fehlercodes aktualisiert Stripe den Mandatsstatus wie folgt:

Fehlercode	Beschreibung	Mandatsstatus
`debit_not_authorized`	Aufgrund einer Einschränkung oder Sperre kann dieses Konto nicht belastet werden und die fehlgeschlagene Zahlung ist dauerhaft. Kontaktieren Sie diesbezüglich Ihre/n Kund/in.	`inactive`
`account_closed`	Aufgrund der Schließung dieses Kontos kann es nicht belastet werden und die fehlgeschlagene Zahlung ist dauerhaft. Kontaktieren Sie diesbezüglich Ihre/n Kund/in.	`inactive`
`no_account`	Die fehlgeschlagene Zahlung ist dauerhaft, da kein entsprechendes Konto zu den angegebenen Bankinformationen existiert. Kontaktieren Sie diesbezüglich Ihre/n Kund/in.	`inactive`
`refer_to_customer`	Die fehlgeschlagene Zahlung ist vorübergehend (zum Beispiel aufgrund nicht ausreichender Deckung). Sie können die Abbuchung erneut versuchen, ohne ein neues Mandat einzuholen.	`active`

Wir empfehlen die Verwendung von Webhooks, um die erfolgreiche Abbuchung zu bestätigen und die Kundinnen/Kunden zu informieren, ob das Mandat erstellt wurde und die Zahlung erfolgt ist oder ob weitere Maßnahmen erforderlich sind.

Integration testen

Testen Sie Ihr Formular mit der BSB-Prüfnummer 000-000 und einer der unten aufgeführten Testkontonummern, wenn Sie confirmAuBecsDebitPayment anfordern.

BSB-Nummer	Kontonummer	Beschreibung

`000-000`	`000123456`	Der PaymentIntent-Status wechselt von `processing` zu`succeeded`. Der Mandatsstatus bleibt `active`.
`000-000`	`900123456`	Der PaymentIntent-Status wechselt von `processing` zu`succeeded` (mit einer Verzögerung von drei Minuten). Der Mandatsstatus bleibt `active`.
`000-000`	`111111113`	Der PaymentIntent-Status wechselt von `processing` zu `requires_payment_method` mit dem Fehlercode `account_closed`. Der Mandatsstatus wird zu `inactive`.
`000-000`	`111111116`	Der PaymentIntent-Status wechselt von `processing` zu `requires_payment_method` mit dem Fehlercode `no_account`. Der Mandatsstatus wird zu `inactive`.
`000-000`	`222222227`	Der PaymentIntent-Status wechselt von `processing` zu `requires_payment_method` mit dem Fehlercode `refer_to_customer`. Der Mandatsstatus bleibt `active`.
`000-000`	`922222227`	Der PaymentIntent-Status wechselt von `processing` zu `requires_payment_method` mit dem Fehlercode `refer_to_customer` (mit einer Verzögerung von drei Minuten). Der Mandatsstatus bleibt `active`.
`000-000`	`333333335`	Der PaymentIntent-Status wechselt von `processing` zu `requires_payment_method` mit dem Fehlercode `debit_not_authorized`. Der Mandatsstatus wird zu `inactive`.
`000-000`	`666666660`	Der PaymentIntent-Status wechselt von `processing` zu `succeeded`, aber es wird sofort eine Zahlungsanfechtung erstellt.
`000-000`	`343434343`	The PaymentIntent fails with a `charge_exceeds_source_limit` error due to the payment amount causing the account to exceed its weekly payment volume limit.
`000-000`	`121212121`	The PaymentIntent fails with a `charge_exceeds_transaction_limit` error due to the payment amount exceeding the account’s transaction volume limit.

Bei Verwendung der Testkontonummern werden Webhook-Ereignisse ausgelöst. Im Testmodus gelingt bzw. scheitert PaymentIntents unverzüglich, sodass auch die entsprechenden Ereignisse payment_intent.succeeded und payment_intent.payment_failed unverzüglich ausgelöst werden. Im Livemodus werden die Webhooks mit derselben Verzögerung wie der zugehörige PaymentIntent-Erfolg bzw. -Fehlschlag ausgelöst.

Zahlungen per BECS-Lastschriftverfahren in Australien annehmen

So nehmen Sie australische BECS-Lastschriftzahlungen an.

Vorsicht

Stripe einrichten
Serverseitig

Kundinnen/Kunden erstellen oder abrufen
Serverseitig

Erstellen Sie ein PaymentIntent
Serverseitig

Achtung

Angaben zur Zahlungsmethode und Mandatsbestätigung erfassen
Clientseitig

Stripe Elements einrichten

Lastschriftanfragen

Notiz

Australisches Bankkontoelement hinzufügen und konfigurieren

Zahlung an Stripe senden
Clientseitig

Erfolgreichen PaymentIntent bestätigen
Serverseitig

Integration testen

OptionalAustralisches Bankkontoelement validieren
Clientseitig

OptionalAbbuchungsdatum für Kunde/Kundin konfigurieren

Siehe auch

Zahlungen per BECS-Lastschriftverfahren in Australien annehmen

So nehmen Sie australische BECS-Lastschriftzahlungen an.

Vorsicht

Stripe einrichtenServerseitig

Kundinnen/Kunden erstellen oder abrufenServerseitig

Erstellen Sie ein PaymentIntentServerseitig

Achtung

Angaben zur Zahlungsmethode und Mandatsbestätigung erfassenClientseitig

Stripe Elements einrichten

Lastschriftanfragen

Notiz

Australisches Bankkontoelement hinzufügen und konfigurieren

Zahlung an Stripe sendenClientseitig

Erfolgreichen PaymentIntent bestätigenServerseitig

Integration testen

OptionalAustralisches Bankkontoelement validierenClientseitig

OptionalAbbuchungsdatum für Kunde/Kundin konfigurieren

Siehe auch

Stripe einrichten
Serverseitig

Kundinnen/Kunden erstellen oder abrufen
Serverseitig

Erstellen Sie ein PaymentIntent
Serverseitig

Angaben zur Zahlungsmethode und Mandatsbestätigung erfassen
Clientseitig

Zahlung an Stripe senden
Clientseitig

Erfolgreichen PaymentIntent bestätigen
Serverseitig

OptionalAustralisches Bankkontoelement validieren
Clientseitig