Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous

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

Découvrez comment intégrer des destinataires à l’aide d’un formulaire hébergé par Stripe

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

Grâce à l’API Account Links, générez des liens par voie programmatique afin de collecter des informations via des formulaires hébergés par Stripe, conçus pour s’adapter automatiquement aux fonctionnalités, au pays et aux moyens de paiement de chaque bénéficiaire. Vous pouvez personnaliser ces formulaires avec le nom de votre entreprise, les couleurs de votre marque et votre logo. Les bénéficiaires complètent le formulaire hébergé et soumettent directement à Stripe toutes les informations requises, y compris leurs identifiants de virement (par exemple, le numéro de compte bancaire et le numéro de routage).

bénéficiaire saisit ses informations dans le formulaire
Le bénéficiaire accepte de Connect ses identifiants de virement à Stripe
Un écran de confirmation indique au bénéficiaire qu'il est prêt à recevoir Payouts

Navigateurs pris en charge

Le recouvrement hébergé par Stripe prend en charge les navigateurs bureau et mobiles qui sont :

  • Les 20 dernières versions majeures de Chrome et Firefox
  • Les deux dernières versions majeures de Safari et Edge.
  • Les deux dernières versions majeures de Safari mobile sur iOS.
  • Pas les environnements iframe

Personnaliser le formulaire de recouvrement

Pour personnaliser les formulaires hébergés par Stripe, accédez à la page d’adaptation à votre marque dans le Dashboard. Vous pourrez y inclure le nom, les couleurs et l’icône de votre entreprise.

Créez un bénéficiaire

Version bêta publique

Les virements transfrontaliers pour les expéditeurs américains sont disponibles en version bêta publique.

Utilisez l’API Accounts v2 pour créer votre destinataire. Vous devez spécifier les moyens de paiement souhaitées, car certaines moyens nécessitent des informations supplémentaires sur votre destinataire pour être activés. Les moyens que vous activez à l’aide du paramètre capabilities déterminent les informations que vous devez collecter pour votre destinataire. Par exemple, le paramètre configuration.recipient.bank_accounts.local pour un destinataire américain vous oblige à fournir un numéro de compte et un numéro de routage).

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-02-25.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual"
    },
    "configuration": {
        "recipient": {
            "capabilities": {
                "bank_accounts": {
                    "local": {
                        "requested": true
                    }
                }
            }
        }
    },
    "include": [
        "requirements",
        "configuration.recipient",
        "identity"
    ]
  }'

Après avoir ajouté ces champs et ces options de virement, Stripe détermine les informations supplémentaires requises dans la réponse de l’API à soumettre pour que le bénéficiaire soit prêt à recevoir des virements.

Méthode de virementParamètre de l’APIDescription
Banque localeconfiguration.recipient.capabilities.bank_accounts.localPermet au compte de recevoir des OutboundPayments sur les réseaux bancaires locaux, tels que ACH ou FPS.
Virement bancaireconfiguration.recipient.capabilities.bank_accounts.wirePermet au compte de recevoir des OutboundPayments sur des réseaux de virement bancaire, tels que Fedwire ou SWIFT.
Cartes bancairesconfiguration.recipient.capabilities.cardsPermet au compte de recevoir des OutboundPayments sur des réseaux de cartes de débit, tels que Visa Direct ou Mastercard Send.

Plusieurs moyens de virement peuvent être activés pour un bénéficiaire. Tous les moyens de virement ne sont pas disponibles pour les bénéficiaires dans tous les pays. Consultez la liste complète des moyens de virement disponibles par pays.

Après avoir ajouté ces champs et ces options de virement, Stripe détermine les informations supplémentaires requises dans la réponse de l’API à soumettre pour que le bénéficiaire soit prêt à recevoir des virements.

Créer un Link partageable

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

Version bêta privée

Vous souhaitez vérifier vos bénéficiaires ? Une fois qu’ils ont partagé les coordonnées de leur moyen de virement dans les formulaires hébergés par Stripe, utilisez l’API Financial Connections pour afficher et confirmer les informations de propriété liées au compte associé. Si vous souhaitez y avoir accès, saisissez votre adresse e-mail.

Pour créer un Link partageable, 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 sur bénéficiaire
  • use_case.account_onboarding.return_url : la page vers laquelle Stripe redirige le bénéficiaire lorsque le AccountLink a déjà été visité, a expiré ou n’est pas valide pour une autre raison.
  • use_case.account_onboarding.actualiser_url : la page vers laquelle Stripe redirige le bénéficiaire lorsqu’il remplit ou quitte le formulaire de recouvrement d’informations.

La requête suivante crée un AccountLink pour collecter les informations d’un bénéficiaire pour la première fois :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/account_links \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-02-25.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"
        }
    }
  }'

s’identifier le bénéficiaire dans votre formulaire d’inscription avant de le rediriger vers cette URL.

Version bêta privée

Vous souhaitez en savoir plus sur nos autres outils d’authentification ? Stripe propose également une fonction de code d’accès à usage unique qui permet de réauthentifier le bénéficiaire en lui envoyant un code d’authentification par e-mail, puis en le redirigeant vers un nouvel AccountLink. Si vous souhaitez y avoir accès, saisissez votre adresse e-mail.

Confirmation du chèque du bénéficiaire Le Royaume-Uni uniquement

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.

Vous pouvez fournir les paramètres suivants dans votre requête /v2/payment_methods/gb_bank_accounts :

Paramètre de l’APIObligatoireDescription
account_numberOuiLe numéro du compte bancaire.
sort_codeOuiLe code guichet du compte bancaire (format numérique uniquement).
confirmation_of_payeeNonDétermine s’il faut vérifier le compte bancaire de votre bénéficiaire.

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/vault/gb_bank_accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-02-25.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 :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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: 2026-02-25.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 l’activation du bénéficiaire

Pour qu’un bénéficiaire accepte Payouts, vous devez collecter des informations sur le bénéficiaire et les moyens de virement prévus.

Une fois qu’un bénéficiaire accède au formulaire de collecte à partir du lien partageable et envoie les informations requises, le webhook v2.core.account_link.returned est déclenché. L’écoute de cet événement de webhook vous permet de savoir quand le processus AccountLink s’est terminé avec succès et que le bénéficiaire est prêt à accepter les virements. En savoir plus sur les webhooks et comment les gérer.

Vous pouvez également déterminer si un destinataire est prêt à accepter des paiements à l’aide du Dashboard ou de l’API Accounts v2.

  1. Accédez à Bénéficiaires et sélectionnez le bénéficiaire de votre choix
  2. Confirmez qu’aucune information supplémentaire n’est requise. Une bannière sur la page s’affiche si nous exigeons des informations supplémentaires du bénéficiaire (par exemple, « Informations requises » ou « Compte bancaire par défaut non défini »). Dans le cas contraire, le recouvrement des informations du bénéficiaire est terminé.
  3. Confirmez qu’au moins une méthode de virement est activée dans la section Méthodes de virement. Si ce n’est pas le cas, vous devez collecter une méthode de virement, soit en partageant un autre lien, soit en utilisant l’API. Pour créer un autre lien partageable, utilisez à nouveau l’API Account Links.

Effectuer des mises à jour sur 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 Link partageable avec l’API Account Links.

Pour créer un nouveau Link 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 : précisez account_update.
  • use_case.account_update.configurations : défini sur recipient.
  • use_case.account_update.return_url : la page vers laquelle Stripe redirige le bénéficiaire une fois que le AccountLink a déjà été visité, a expiré ou n’est pas valide d’une autre manière.
  • use_case.account_update.actualiser_url : la page vers laquelle Stripe redirige le bénéficiaire lorsqu’il a rempli ou quitté le formulaire de collecte d’informations.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/account_links \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-02-25.preview" \
  --json '{
    "account": "{{ACCOUNT_ID}}",
    "use_case": {
        "type": "account_update",
        "account_update": {
            "configurations": [
                "recipient"
            ],
            "return_url": "https://example.com/return",
            "refresh_url": "https://example.com/reauth"
        }
    }
  }'

Tout comme le lien AccountLink utilisé pour créer le bénéficiaire, l’URL expire au bout de 10 minutes et ne peut être utilisée qu’une seule fois. Si votre bénéficiaire essaie d’ouvrir l’URL au-delà du délai de 10 minutes ou plusieurs fois, nous le redirigerons vers refresh.url.

Sur cette page