Zahlungen per BECS-Lastschriftverfahren in Australien annehmen

Serverseitig

Diese Integration erfordert Endpoints auf Ihrem Server, die mit der Stripe-API kommunizieren können. Nutzen Sie unsere offiziellen Bibliotheken für den Zugriff auf die Stripe-API von Ihrem Server aus:

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Clientseitig

Das React Native SDK ist Open Source und vollständig dokumentiert. Intern werden native iOS und Android SDKs verwendet. Um das React Native SDK von Stripe zu installieren, führen Sie einen der folgenden Befehle im Verzeichnis Ihres Projekts aus (je nachdem, welchen Paket-Manager Sie verwenden):

yarn add @stripe/stripe-react-native

Installieren Sie als Nächstes einige weitere erforderliche Abhängigkeiten:

• Navigieren Sie für iOS zum Verzeichnis ios und führen Sie pod install aus, um sicherzustellen, dass Sie auch die erforderlichen nativen Abhängigkeiten installieren.
• Für Android müssen keine Abhängigkeiten mehr installiert werden.

Stripe Initialisierung

Um Stripe in Ihrer React Native-App zu initialisieren, umschließen Sie entweder Ihren Zahlungsbildschirm mit der Komponente StripeProvider oder verwenden Sie die Initialisierungsmethode initStripe. Nur der veröffentlichbare API-Schlüssel in publishableKey ist erforderlich. Das folgende Beispiel zeigt, wie Stripe mithilfe der Komponente StripeProvider initialisiert wird.

import React, { useState, useEffect } from 'react';
import { StripeProvider } from '@stripe/stripe-react-native';

function App() {
  const [publishableKey, setPublishableKey] = useState('');

  const fetchPublishableKey = async () => {
    const key = await fetchKey(); // fetch key from your server here
    setPublishableKey(key);
  };

  useEffect(() => {
    fetchPublishableKey();
  }, []);

  return (
    <StripeProvider
      publishableKey={publishableKey}
      merchantIdentifier="merchant.identifier" // required for Apple Pay
      urlScheme="your-url-scheme" // required for 3D Secure and bank redirects
    >
      // Your app code here
    </StripeProvider>
  );
}

Mit der im SDK enthaltenen Drop-in-Nutzeroberflächenkomponente AuBECSDebitForm können Sie Zahlungsdaten zum BECD-Lastschriftverfahren in Australien sicher erfassen. AuBECSDebitForm stellt eine Nutzeroberfläche bereit, in der die Kundinnen/Kunden ihren Namen, ihre E-Mail-Adresse, die BSB-Nummer und die Kontonnummer eingeben können. Außerdem werden die Bedingungen des BECS-Lastschriftverfahrens in Australien angezeigt.

Fügen Sie die Komponente AuBECSDebitForm samt ihrem Firmennamen in die Benutzeroberfläche ein. Mit der Eigenschaft formStyle können Sie AuBECSDebitForm individuell an das Erscheinungsbild Ihrer Anwendung anpassen. Formulardetails erfassen Sie zum Zeitpunkt der Zahlungsbestätigung mit der Eigenschaft onComplete.

function PaymentScreen() {
  const [formDetails, setFormDetails] = useState<
    AuBECSDebitFormComponent.FormDetails
  >();

  return (
    <View>
      <AuBECSDebitForm
        onComplete={(value) => setFormDetails(value)}
        companyName="Example Company Inc."
        formStyle={{
          textColor: '#000000',
          fontSize: 22,
          placeholderColor: '#999999',
        }}
      />
      <Button title="Pay" variant="primary" onPress={handlePayPress} />
    </View>
  );
}

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.

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=1099 \
  -d "setup_future_usage"="off_session" \
  -d "currency"="aud" \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "payment_method_types[]"="au_becs_debit"

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.

Clientseitig

Fordern Sie auf dem Client einen PaymentIntent von Ihrem Server an und speichern Sie sein Client-Geheimnis.

const fetchPaymentIntentClientSecret = async () => {
  const response = await fetch(`${API_URL}/create-payment-intent`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      currency: 'aud',
      payment_method_types: ['au_becs_debit'],
    }),
  });
  const { clientSecret, error } = await response.json();

  return { clientSecret, error };
};

Rufen Sie das Client-Geheimnis von der erstellten PaymentIntent ab und rufen Sie confirmPayment auf. Dies entspricht einer Webansicht, in der die Kund/innen die Zahlung auf der Website oder in der App ihrer Bank durchführen können. Anschließend wird das Promise mit dem Ergebnis der Zahlung aufgelöst.

function PaymentScreen() {
  const { confirmPayment, loading } = useConfirmPayment();

  const [formDetails, setFormDetails] = useState<
    AuBECSDebitFormComponent.FormDetails
  >();

  const handlePayPress = async () => {
    const { error, paymentIntent } = await confirmPayment(clientSecret, {
      paymentMethodType: 'AuBecsDebit',
      paymentMethodData: {
        formDetails,
      }
    });

    if (error) {
      Alert.alert(`Error code: ${error.code}`, error.message);
      console.log('Payment confirmation error', error.message);
    } else if (paymentIntent) {
      if (paymentIntent.status === PaymentIntents.Status.Processing) {
        Alert.alert(
          'Processing',
          `The debit has been successfully submitted and is now processing.`
        );
      } else if (paymentIntent.status === PaymentIntents.Status.Succeeded) {
        Alert.alert(
          'Success',
          `The payment was confirmed successfully! currency: ${paymentIntent.currency}`
        );
      } else {
        Alert.alert('Payment status:', paymentIntent.status);
      }
    }
  };

  return (
    <View>
      <AuBECSDebitForm
        onComplete={(value) => setFormDetails(value)}
        companyName="Example Company Inc."
        formStyle={{
          textColor: '#000000',
          fontSize: 22,
          placeholderColor: '#999999',
        }}
      />
      <Button title="Pay" variant="primary" onPress={handlePayPress} />
    </View>
  );
}

Bei BECS Direct Debit handelt es sich um eine Zahlungsmethode mit verzögerter Benachrichtigung, was bedeutet, dass das Geld nicht sofort verfügbar ist. Ein PaymentIntent mit BECS-Lastschriftverfahren verbleibt in der Regel 2 Geschäftstage nach Absenden ans BECS-Netzwerk im Bearbeitungsstatus. Die Übermittlung findet einmal am Tag statt. Ist die Zahlung erfolgreich, wird der Status des zugehörigen PaymentIntent von processing in succeeded aktualisiert.

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

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:

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.

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

Bei Verwendung der Testkontonummern werden Webhook-Ereignisse ausgelöst. In einer Sandbox 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 Live-Modus werden die Webhooks mit derselben Verzögerung wie der zugehörige PaymentIntent-Erfolg bzw. -Fehlschlag ausgelöst.