Eine Banküberweisung annehmen

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:

# Available as a gem
sudo gem install stripe

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

Sie müssen ein Kundenobjekt zuordnen, um jede Banküberweisungszahlung abzugleichen. Wenn Sie bereits über ein Kundenobjekt verfügen, können Sie diesen Schritt überspringen. Erstellen Sie andernfalls ein neues Kundenobjekt.

curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Ein PaymentIntent ist ein Objekt, das Ihre Absicht zur Einziehung einer Kundenzahlung darstellt und den Zahlungsvorgang in jeder Phase verfolgt. Erstellen und bestätigen Sie einen PaymentIntent auf dem Server und geben Sie den Betrag und die Währung an, die Sie einziehen möchten. Außerdem müssen Sie den Kundenparameter der PaymentIntent-Erstellungsanfrage ausfüllen. Banküberweisungen sind bei PaymentIntents ohne eine Kundin/einen Kunden nicht verfügbar.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d customer=
{{CUSTOMER_ID}} \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true \
  --data-urlencode return_url="https://example.com/return_url" \
  -d "payment_method_data[type]"=customer_balance \
  -d confirm=true

Wenn der Kundensaldo nicht ausreicht, um den angeforderten Betrag zu decken, zeigt der PaymentIntent den Status requires_action an. Die Antwort enthält das Feld next_action mit dem Wert display_bank_transfer_instructions als type. Der Hash next_action[display_bank_transfer_instructions] enthält Informationen, die Sie Ihren Kundinnen/Kunden anzeigen sollten, damit sie die Überweisung durchführen können. Um die Abwicklung von Geldern zu gewährleisten, weisen Sie Ihre Kundinnen/Kunden an, genau die angegebenen Details zu verwenden, insbesondere den Kontonamen und gegebenenfalls die Kontonummer.

{
  "aba": {
    "account_number": "111222333444",
    "bank_name": "Wells Fargo Bank, NA",
    "routing_number": "444555666"
  },
  "supported_networks": [
    "ach",
    "domestic_wire_us"
  ],
  "type": "aba"
}

{
  "swift": {
    "account_number": "111222333444",
    "bank_name": "Wells Fargo Bank, NA",
    "swift_code": "AAAA-BB-CC-123"
  },
  "supported_networks": [
    "swift"
  ],
  "type": "swift"
}

Die PaymentIntent verbleibt im Status requires_action, bis Gelder auf dem Bankkonto eingehen. Wenn die Gelder bereit sind, wird der PaymentIntent-Status von requires_action auf succeeded aktualisiert.

Ihr Webhook-Endpoint muss so eingerichtet werden, dass er das Ereignis payment_intent.partially_funded empfängt.

Sie können einen Webhook über das Dashboard hinzufügen.

Alternativ können Sie die Webhook Endpoints API verwenden, um das Ereignis payment_intent.partially_funded zu empfangen.

Stripe sendet die folgenden Ereignisse während des Zahlungsablaufs, wenn wir den PaymentIntent aktualisieren.

Wir empfehlen die Verwendung von Webhooks, um die erfolgreiche Abbuchung zu bestätigen und die Kundinnen/Kunden zu informieren, dass die Zahlung abgeschlossen ist.

Beispielcode

require 'json'

# Using Sinatra
post '/webhook' do
  payload = request.body.read
  event = nil

  begin
    event = Stripe::Event.construct_from(
      JSON.parse(payload, symbolize_names: true)

Ausstehende Zahlungen im Dashboard anzeigen

Sie können alle ausstehenden PaymentIntents für Banküberweisungen im Dashboard anzeigen, indem Sie den Filter Auf Finanzierung warten auf den Status anwenden.

Sie können Ihre Integration testen, indem Sie eine eingehende Überweisung über das Dashboard oder eine HTTP-Anfrage simulieren.

curl https://api.stripe.com/v1/test_helpers/customers/ic_xxxxxxxxx/fund_cash_balance \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d reference=REF-4242

Die folgenden Fehlercodes weisen auf vorübergehende Probleme mit der Verfügbarkeit der Zahlungsmethode hin: