Créer un destinataire de virements internationaux (Global Payouts) avec l'APIVersion bêta publique

Créez un flux de recouvrement permettant à vos bénéficiaires de collecter les informations relatives aux bénéficiaires et aux modes de virement, puis transmettez ces informations à Stripe via nos API.

Considérations

Votre entreprise est responsable de toutes les interactions avec vos destinataires et de la collecte de toutes les informations nécessaires pour les vérifier. Stripe met à jour les exigences en matière de vérification des destinataires à mesure que les lois et réglementations évoluent à travers le monde.

Lorsque vous créez une intégration de paiement, réfléchissez à la manière de gérer :

• Examiner régulièrement les modifications apportées aux exigences légales et réglementaires.
• Mettre à jour la logique de votre application en réponse à ces changements.

Prévoyez de vérifier et de mettre à jour régulièrement les exigences en matière d’onboarding pour éviter les échecs de virement.

Créer un bénéficiaire

Lorsque vous utilisez un formulaire pour collecter les informations relatives aux bénéficiaires des paiements, utilisez l’API Accounts v2 pour créer un bénéficiaire. Vous devez fournir les paramètres suivants pour créer l’ID du compte :

Vous devez préciser à l’aide de l’API Accounts v2 les modes de virement que vous comptez utiliser, car certains nécessitent des informations supplémentaires sur votre bénéficiaire avant que nous puissions les activer. 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 moyens 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. Pour recevoir ces exigences, incluez requirements, configuration.recipient et identity dans le tableau include. Dans le cas contraire, Stripe renverra une réponse nulle, indépendamment des valeurs réelles.

Lorsque vous créez, récupérez ou mettez à jour un compte, certains champs ne sont renseignés dans la réponse que si vous les spécifiez dans le paramètre include. Pour tous les champs que vous ne spécifiez pas, la réponse les inclut comme null, quelle que soit leur valeur réelle.

curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  --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": [
        "identity",
        "configuration.recipient",
        "requirements"
    ]
  }'

Déterminer les champs requis pour activer un bénéficiaire

Utilisez la réponse de l’API Accounts v2 et examinez les requirements.entries pour déterminer quels champs vous devez envoyer à Stripe. Toutes les entries qui ont le champ restricts_capabilities sont indispensables pour que le bénéficiaire accepte les virements.

{
 "id": "{{CONNECTED_ACCOUNT_ID}}",
 "object": "v2.core.account",
 "applied_configurations": [
   "recipient"
 ],
 "configuration": {
   "customer": null,
   "merchant": null,
   "recipient": {

Envoyer les coordonnées du bénéficiaire à Stripe

Après avoir déterminé les champs supplémentaires que vous devez soumettre, utilisez l’API Accounts v2 pour soumettre les informations requises. Utilisez l’ID de la réponse ci-dessus dans l’URI.

curl -X POST https://api.stripe.com/v2/core/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual",
        "individual": {
            "given_name": "Jenny",
            "surname": "Rosen",
            "address": {
                "city": "Brothers",
                "country": "US",
                "line1": "27 Fredrick Ave",
                "postal_code": "97712",
                "state": "OR"
            }
        }
    },
    "include": [
        "identity"
    ]
  }'

Confirmer que le bénéficiaire est activé

Utilisez l’API Accounts v2 pour récupérer un compte et examiner le status des fonctionnalités que vous avez demandées. Pour qu’un bénéficiaire reçoive les virements par le mode de virement souhaité, la valeur de status doit être active.

curl -G https://api.stripe.com/v2/core/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  -d "include[0]"="configuration.recipient"

Créer des moyens de virement pour vos bénéficiaires

Utilisez l’API OutboundSetupIntents v2 pour soumettre les détails du moyen de virement à Stripe afin d’activer un virement à un bénéficiaire.

L’en-tête Stripe-Context de cette requête doit correspondre à l’identifiant du compte du destinataire.

curl -X POST https://api.stripe.com/v2/money_management/outbound_setup_intents \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  -H "Stripe-Context: 
{{CONTEXT}}
" \
  --json '{
    "payout_method_data": {
        "type": "bank_account",
        "bank_account": {
            "country": "FR",
            "account_number": "FR76300060000112345678901234"
        }
    }
  }'

Pour envoyer des virements par transfert bancaire, utilisez l’API USBankAccount v2 afin d’ajouter le fedwire_acheminement_number à la méthode de virement. Des frais supplémentaires s’appliquent. Consultez les tarifs pour en savoir plus.

Vous pouvez également utiliser des cartes de débit comme mode de virement. Cependant, vos bénéficiaires doivent envoyer leurs coordonnées de carte de débit directement à Stripe. Si vous souhaitez activer les virements par carte de débit, utilisez l’API Account Links v2 pour créer un formulaire à partager permettant à vos utilisateurs de soumettre leurs données de carte de débit.

Afficher tous les moyens de virement d’un bénéficiaire

Affichez tous les modes de virement créés pour un bénéficiaire. Appelez l’API Payout Methods v2 et indiquez l’ID du bénéficiaire.

L’en-tête Stripe-Context de cette requête doit correspondre à l’identifiant du compte du destinataire.

curl https://api.stripe.com/v2/money_management/payout_methods \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  -H "Stripe-Context: 
{{CONTEXT}}
"

La réponse contient une liste des objets PayoutMethod que possède un bénéficiaire. Utilisez les ID de PayoutMethod pour effectuer un virement à l’aide de l’API OutboundPayments. Consultez la section Envoyer des fonds pour plus de détails.