Création de bénéficiaires hébergée par StripeVersion bêta publique

Utilisez le formulaire web hébergé par Stripe pour collecter des informations sur les bénéficiaires, qui s’affichent de manière dynamique en fonction des fonctionnalités, du pays et des moyens de paiement de chaque bénéficiaire.

Utilisez l’API Account Links pour générer des liens de manière programmatique afin de collecter des informations à l’aide de formulaires hébergés par Stripe, qui s’adaptent de manière dynamique selon les fonctionnalités, le pays et les moyens de paiement de chaque bénéficiaire, et que vous pouvez personnaliser avec le nom, les couleurs de la marque et l’icône de votre entreprise. Vos bénéficiaires remplissent le formulaire hébergé et transmettent directement à Stripe les informations requises, y compris les coordonnées de virement (par exemple, le compte bancaire et le numéro de routage).

Navigateurs pris en charge

La collecte hébergée par Stripe prend en charge les navigateurs de bureau et mobiles qui ne sont :

• Les 20 dernières versions majeures de Chrome et Firefox
• Les 2 dernières versions majeures de Safari et Edge
• Les 2 dernières versions majeures de Safari mobile sur iOS
• pas des environnements iframe

Personnaliser le formulaire de collecte des informations

Pour personnaliser les formulaires hébergés par Stripe, accédez à la page Paramètres de marque de l’entreprise dans le Dashboard pour inclure le nom, les couleurs et l’icône de votre entreprise.

Créer un bénéficiaire

Utilisez l’API Accounts v2 pour créer votre bénéficiaire. Vous devez fournir les paramètres suivants pour créer l’ID de compte :

À l’aide de l’API Accounts v2, vous devez préciser les modes de virement prévus, car certains nécessitent des informations supplémentaires sur votre bénéficiaire pour leur activation. Les modes que vous activez à l’aide du paramètre capabilities déterminent les informations que vous devez collecter concernant votre bénéficiaire (par exemple, configuration.recipient.capabilities.bank_accounts.local pour un bénéficiaire aux États-Unis nécessite que vous fournissiez un numéro de compte et un numéro de routage).

Plusieurs moyens de virement peuvent être activés pour un bénéficiaire. Selon le pays du bénéficiaire, tous les modes de virement ne seront pas disponibles. Consultez la liste complète des moyens de virement disponibles par pays.

Une fois que vous avez ajouté ces champs et les modes de virement demandés, Stripe détermine les informations supplémentaires requises dans la réponse de l’API que vous devez soumettre pour que le bénéficiaire soit prêt à recevoir des virements.

Créer un lien à partager

Créez un lien à partager à l’aide de l’API Account Link. Vous envoyez ce lien à votre bénéficiaire, qui a ensuite accès au formulaire de collecte pour soumettre les informations requises directement à Stripe. Chaque URL d’AccountLink expire 10 minutes après sa génération et ne peut être utilisée qu’une seule fois. Si le bénéficiaire clique sur l’AccountLink après la période de 10 minutes, il est redirigé vers l’URL refresh.url pour des raisons de sécurité. Une fois que le bénéficiaire a fourni ses informations, l’AccountLink le redirige vers l’URL return.url.

Pour créer un lien à partager, incluez les paramètres suivants :

• account : l’ID de compte du bénéficiaire, que vous pouvez obtenir à l’aide de l’API Accounts v2.
• use_case.type : Si vous collectez les informations du bénéficiaire pour la première fois, précisez account_onboarding.
• use_case.account_onboarding.configurations : définissez-le sur recipient.
• use_case.account_onboarding.return_url : la page vers laquelle Stripe redirige le bénéficiaire lorsque l’AcccountLink a déjà été consulté, a expiré ou n’est pas valide.
• use_case.account_onboarding.refresh_url : La page vers laquelle Stripe redirige le destinataire lorsqu’il remplit ou quitte le formulaire de collecte d’informations.

La demande suivante crée un AccountLink dans le but de collecter les informations d’un bénéficiaire pour la première fois :

curl -X POST https://api.stripe.com/v2/core/account_links \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-03-31.preview" \
  --json '{
    "account": "{{ACCOUNT_ID}}",
    "use_case": {
        "type": "account_onboarding",
        "account_onboarding": {
            "configurations": [
                "recipient"
            ],
            "return_url": "https://example.com/return",
            "refresh_url": "https://example.com/reauth"
        }
    }
  }'

Authentifiez le destinataire dans votre application avant de le rediriger vers cette URL.

Confirmation de la vérification du bénéficiaire UK only

Nous exigeons une vérification de confirmation du bénéficiaire avant de payer les bénéficiaires au Royaume-Uni. Effectuez cette vérification lors de la création du compte bancaire ou effectuez un appel à l’API distinct.

Fournissez les paramètres suivants dans votre requête à /v2/payment_methods/gb_bank_accounts :

L’en-tête Stripe-Context de ces requêtes doit contenir l’ID de compte du bénéficiaire.

curl -X POST https://api.stripe.com/v2/core/vault/gb_bank_accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-06-30.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
" \
  --json '{
    "sort_code": "108800",
    "account_number": "00012345",
    "confirmation_of_payee": {
        "initiate": true
    }
  }'

Voici un exemple de réponse :

{
  "id": "gbba_123",
  "object": "payment_methods.gb_bank_account",
  "bank_account_type": "checking",
  "bank_name": "Test Bank",
  "created": "2023-05-15T16:29:15.738Z",
  "deactivated": false,
  "last4": "2345",
  "sort_code": "108800",
  "confirmation_of_payee": {
    "result": {
      "created": "2024-10-18T19:19:31.000Z",
      "match_result": "mismatch",
      "matched": {
        "business_type": null,
        "name": ""
      },
      "message": "The provided information does not match the information the bank has on file for this account.",
      "provided": {
        "business_type": "business",
        "name": "John Smith"
      }
    },
    "status": "awaiting_acknowledgement"
  },
}

Si le résultat de la confirmation du bénéficiaire correspond, vous pouvez immédiatement envoyer des fonds à cette destination. Si le résultat est une correspondance partielle, une non-correspondance ou si le service n’est pas disponible, vous devez d’abord accuser réception du résultat :

curl -X POST https://api.stripe.com/v2/core/vault/gb_bank_accounts/gbba_1234/acknowledge_confirmation_of_payee \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-06-30.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
"

Vérifiez ces comptes bancaires pour vous assurer qu’ils sont corrects avant d’accuser réception. Vous pouvez également vérifier les comptes bancaires non concordants dans le Dashboard.

Confirmer que le bénéficiaire est activé

Pour qu’un bénéficiaire puisse accepter des virements, vous devez collecter des informations sur ce bénéficiaire ainsi que sur les modes de virement prévus. Vous pouvez déterminer si un bénéficiaire est prêt à accepter des virements à l’aide du Dashboard ou de l’API Accounts v2.

Mettre à jour un bénéficiaire existant

Vous pouvez autoriser les bénéficiaires à mettre à jour leurs informations dans le formulaire hébergé par Stripe en créant un autre lien partageable avec l’API Account Links.

Pour créer un lien partageable, incluez :

• account : l’ID de compte du bénéficiaire, que vous pouvez obtenir à l’aide de l’API Accounts v2.
• use_case.type : Spécifiez account_update.
• use_case.account_onboarding.configurations : définissez-le sur recipient.
• use_case.account_onboarding.return_url : la page vers laquelle Stripe redirige le bénéficiaire lorsque l’AccountLink a déjà été visité, a expiré ou n’est pas valide.
• use_case.account_onboarding.refresh_url : La page vers laquelle Stripe redirige le bénéficiaire lorsqu’il a rempli ou quitté le formulaire de collecte d’informations.

curl -X POST https://api.stripe.com/v2/core/account_links \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-03-31.preview" \
  --json '{
    "account": "{{ACCOUNT_ID}}",
    "use_case": {
        "type": "account_update",
        "account_onboarding": {
            "configurations": [
                "recipient"
            ],
            "return_url": "https://example.com/return",
            "refresh_url": "https://example.com/reauth"
        }
    }
  }'

Semblable à l’AccountLink utilisé pour créer le destinataire, l’URL expire au bout de 10 minutes et ne peut être utilisée qu’une seule fois. Si votre destinataire clique sur l’AccountLink après la fenêtre de 10 minutes, nous le redirigeons vers refresh.url pour des raisons de sécurité.