Collecter les informations d'un compte bancaire pour utiliser les paiements par prélèvement automatique ACH avec les données du compte

Le paramètre verification_method de diverses ressources API contrôle si Financial Connections est activé pour la vérification du compte bancaire. Par défaut, la vérification s’effectue via Financial Connections, avec les microversements comme solution de secours.

Cette option est disponible avec les API suivantes :

• PaymentIntent
• SetupIntent
• CheckoutSession
• Facture
• Abonnement
• Payment Element

Nous vous recommandons de créer un objet Customer contenant une adresse e-mail, qui représentera votre utilisateur et que vous pourrez ensuite associer à votre paiement. L’association d’un objet Customer vous permet de répertorier les comptes précédemment associés ultérieurement. En renseignant une adresse e-mail dans l’objet Customer, vous permettez à Financial Connections d’améliorer le flux d’authentification en simplifiant l’inscription ou la connexion de votre utilisateur, selon qu’il s’agit d’un nouvel utilisateur de Link ou d’un utilisateur existant.

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d email={{CUSTOMER_EMAIL}}

Pour accéder à des données de compte supplémentaires sur les comptes Financial Connections, vérifiez d’abord que vous avez envoyé votre demande Financial Connections en consultant les paramètres Financial Connections dans le Dashboard. Pour afficher cette page, activez votre compte. La façon dont vous configurez les types de données de compte auxquelles vous avez accès dépend de votre intégration.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=2000 \
  -d currency=usd \
  -d customer=
{{CUSTOMER_ID}} \
  -d "automatic_payment_methods[enabled]"=true \
  -d "payment_method_options[us_bank_account][financial_connections][permissions][]"=payment_method \
  -d "payment_method_options[us_bank_account][financial_connections][permissions][]"=balances \
  -d "payment_method_options[us_bank_account][financial_connections][permissions][]"=ownership \
  -d "payment_method_options[us_bank_account][financial_connections][permissions][]"=transactions

Après que l’accès aux données bancaires supplémentaires sur les soldes ou la propriété d’un compte bancaire a été approuvé, vous pouvez utiliser ces données pour améliorer les performances des paiements ACH. Vous pouvez, par exemple, utiliser les données du solde pour réduire le risque d’échec des paiements liés à des fonds insuffisants. Consultez les guides de données associés pour voir quelques exemples :

• Soldes : consultez le solde du compte avant d’initier le paiement pour réduire le nombre de cas de fonds insuffisants.
• Propriété : consultez les propriétaires de comptes et comparez-les à vos modèles de données internes pour détecter les tentatives de fraude.
• Transactions : consultez l’historique des transactions d’un compte pour vérifier quand les recettes du client sont susceptibles d’arriver.

Trouver l’ID d’un compte Financial Connections

Pour initier l’actualisation des données et récupérer les données d’un compte Financial Connections, vous devez d’abord obtenir l’ID du compte à partir du moyen de paiement associé en développant la propriété payment_method du PaymentIntent :

curl -G https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "expand[]"=payment_method

L’ID du compte Financial Connections se trouve dans le hachage us_bank_account du moyen de paiement développé. Si vous autorisez la saisie manuelle de secours et que l’utilisateur a saisi manuellement ses informations de compte, ce champ est null.

{
  "id": "pi_3OK3g4FitzZY8Nvm11121Lhb",
  "object": "payment_intent",
  "payment_method": {
    "us_bank_account": {
      "financial_connections_account": "fca_1OK123bitUAA8SvmruWkck76"
    }
    // ... other fields on the Payment Method
  }
  // ... other fields on the Payment Intent
}