Migrer depuis l'API Charges

Si vous collectiez précédemment les informations de paiement de vos clients avec Stripe à l’aide de l’API Bank Accounts, vous pouvez continuer à utiliser le BankAccount enregistré en tant que PaymentMethod. Vous pouvez utiliser des comptes bancaires de clients avec l’API Payment Intents une fois que vous répondez aux exigences suivantes :

1. Le compte bancaire du client a été vérifié.
2. Un mandat actif existe pour ce compte bancaire.

Compatibilité avec l’API Bank Accounts

Créer un PaymentIntent avec un compte bancaire

Les comptes bancaires qui sont déjà vérifiés et qui ont été associés à un objet Customer peuvent être utilisés dans les API qui acceptent les objets PaymentMethod. Vous pouvez utiliser un BankAccount enregistré comme PaymentMethod lors de la création d’un PaymentIntent. Il n’est donc pas nécessaire de demander à nouveau les informations du paiement. Cependant, veillez à mettre à jour votre intégration pour commencer à créer des PaymentMethods à la place.

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=1099 \
  -d "currency"="usd" \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "payment_method_types[]"="us_bank_account" \
  -d "payment_method"="{{BANK_ACCOUNT_ID}}"

De même, vous pouvez utiliser un BankAccount enregistré comme PaymentMethod lors de la création d’un SetupIntent.

curl https://api.stripe.com/v1/setup_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"="us_bank_account" \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "payment_method"="{{BANK_ACCOUNT_ID}}"

Collecter la confirmation du mandat

Pour confirmer un PaymentIntent ou un SetupIntent, votre client doit autoriser un mandat de prélèvement du compte. Consultez la page relative aux codes SEC pour comprendre quel type d’autorisation convient à votre entreprise.

Dans certains cas, vous pouvez disposer d’une préautorisation de votre client provenant d’un achat antérieur ou d’un SetupIntent que vous pouvez utiliser pour créer un paiement hors session. Par exemple :

• Si vous avez déjà collecté un mandat en ligne auprès du client, vous pouvez utiliser à la fois l’adresse IP et les informations de l’agent utilisateur pour créer un objet mandate.
• Si vous collectiez auparavant les informations relatives aux paiements et aux mandats hors ligne sur papier, vous pouvez créer un mandat PPD.

Pour créer un paiement hors session, vous pouvez utiliser l’acceptation du mandat hors ligne pour fournir un enregistrement de l’autorisation initiale de votre client.

L’autorisation n’est requise que la première fois que vous utilisez un objet BankAccount avec l’API PaymentIntents. Ensuite, vous pouvez utiliser l’objet BankAccount comme PaymentMethod pour accepter des futurs paiements.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/confirm \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "mandate_data[customer_acceptance][type]"="offline" \
  -d "mandate_data[customer_acceptance][accepted_at]"="{{ACCEPTANCE_TIMESTAMP}}" \
  -d "payment_method_options[us_bank_account][mandate_data][collection_method]"="paper"

Récupérer un BankAccount en tant que PaymentMethod

Vous pouvez récupérer les BankAccounts enregistrés via l’API Payment Methods.

curl https://api.stripe.com/v1/payment_methods/ba_1IsleZ2eZvKYlo2CI3To1g72 \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Lorsqu’un BankAccount est utilisé comme PaymentMethod, aucun nouvel objet n’est créé. L’API Payment Methods propose simplement une vue différente du même objet sous-jacent.

{
  "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"
}