Vorhandene Bankkonten migrieren

Stripe stellt die Unterstützung für ACH Direct Debit über Legacy-Integrationen ein.

Wenn Sie Zahlungen über das Legacy-ACH Direct Debit erstellen, müssen Sie zur Payment Intents API oder Checkout Sessions API migrieren.

Wenn Sie zuvor Kundenzahlungsdaten mit Stripe über die Tokens API erfasst haben, können Sie das gespeicherte Bankkonto weiterhin als Zahlungsmethode verwenden.

Sie können Kundenbankkonten nur dann mit der Payment Intents API oder der Checkout Sessions API verwenden, wenn Sie die folgenden Anforderungen erfüllen:

• Checkout Sessions API: Das Bankkonto des Kunden/der Kundin wurde verifiziert.

• Payment Intents API: Das Bankkonto der Kundin/des Kunden/der Kundin wurde verifiziert, und für dieses Bankkonto besteht ein aktives Mandat.

Sie müssen Bankkonten, die bereits verifiziert sind, nicht erneut verifizieren, um sie mit Payment Intents oder Checkout-Sessions zu verwenden.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=payment \
  -d ui_mode=custom \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "payment_method_types[0]"=us_bank_account \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=1099 \
  -d "line_items[0][quantity]"=1 \
  -d "saved_payment_method_options[allow_redisplay_filters][0]"=unspecified \
  -d "saved_payment_method_options[allow_redisplay_filters][1]"=always \
  --data-urlencode return_url="YOUR_DOMAIN/complete?session_id={CHECKOUT_SESSION_ID}"

const {checkout} = useCheckout();
const currentEmail = checkout.email;

if (currentEmail) {
  return <input value={currentEmail} readOnly />;
}

Ein BankAccount als PaymentMethod abrufen

Sie können gespeicherte BankAccounts über die Payment Methods API abrufen:

curl https://api.stripe.com/v1/payment_methods/
{{BANK_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Bei Verwendung eines BankAccounts als PaymentMethod werden keine neuen Objekte angelegt. Die Payment Methods API bietet einfach eine andere Ansicht desselben zugrunde liegenden Objekts.

{
  "id": "ba_1IsleZ2eZvKYlo2CI3To1g72",
  "object": "payment_method",
  "billing_details": {
    "address": {
      "city": null,
      "country": null,
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    },
    "email": null,
    "name": "Jenny Rosen",
    "phone": null
  },
  "us_bank_account": {
    "last4": "6789",
    "routing_number": "110000000",
    "fingerprint": "1JWtPxqbdX5Gamtc",
    "account_holder_type": "individual",
    "bank_name": "STRIPE TEST BANK",
  },
  "created": 123456789,
  "customer": "cus_CY5bH92D99f4mn",
  "livemode": false,
  "metadata": {},
  "type": "us_bank_account"
}

Rechnungen

Nachdem Sie die Mandatsbestätigung erhalten haben, müssen Sie, um Invoicing weiterhin nutzen zu können, entweder die Standardzahlungsmethode Ihres Kunden aktualisieren oder den Parameter default_payment_method festlegen.

So aktualisieren Sie die Standardzahlungsmethode einer Kundin/eines Kunden:

curl https://api.stripe.com/v1/customers/
{{CUSTOMER_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "invoice_settings[default_payment_method]"=
"{{BANK_ACCOUNT_ID}}"

So erstellen Sie eine Rechnung mit einem Bankkonto als Zahlungsmethode:

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d default_payment_method=
"{{BANK_ACCOUNT_ID}}"

Abonnements

Nachdem Sie die Mandatsbestätigung erhalten haben, müssen Sie, um Subscriptions weiterhin nutzen zu können, entweder die Standardzahlungsmethode Ihres Kunden aktualisieren oder den Parameter default_payment_method festlegen.

So aktualisieren Sie die Standardzahlungsmethode einer Kundin/eines Kunden:

curl https://api.stripe.com/v1/customers/
{{CUSTOMER_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "invoice_settings[default_payment_method]"=
"{{BANK_ACCOUNT_ID}}"

So erstellen Sie ein Abo mit einem Bankkonto als Zahlungsmethode:

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d default_payment_method=
"{{BANK_ACCOUNT_ID}}" \
  -d "items[0][price]"=price_1MowQULkdIwHu7ixraBm864M

Legacy-ACH-Zahlungen identifizieren

Bei einem Zahlungs-Objekt lautet die Eigenschaft payment_method_details.type bei der Legacy-Integration ach_debit und bei der neueren Integration us_bank_account.

Eine Legacy-ACH-Zahlung wird erstellt, wenn ein Legacy-BankAccount als Zahlungsquelle verwendet wird. Dies geschieht, wenn:

• Sie die Create Charge API aufrufen.
• Ein Abonnement oder eine Rechnung belastet eine Kundin oder einen Kunden, dessen default_source ein Legacy-Bankkonto ist und für den keine default_payment_method für die Kundin oder den Kunden, das Abonnement oder die Rechnung festgelegt ist.
• Sie rufen die Create PaymentIntent API auf, wobei Quelle auf ein Legacy-Bankkonto festgelegt ist.