Créez et pré-remplissez le compte connecté

Utilisez l’API Accounts v2 pour créer un compte connecté en spécifiant le Dashboard et les responsabilités du compte connecté. En tant que marketplace, votre plateforme :

• Est généralement le marchand attitré
• Utilise des paiements indirects
• Gestion des litiges et des remboursements
• Génère des revenus en prélevant une commission de la plateforme sur chaque transaction.

Ces fonctionnalités ont un impact sur les paramètres que vous définissez lorsque vous créez vos comptes connectés.

Attribuer des configurations de compte

Les comptes connectés interagissent avec votre plateforme et Stripe en fonction des configurations que vous leur attribuez. La plupart des plateformes de marketplace attribuent à leurs comptes connectés la configuration destinataire. Certaines marketplaces attribuent également la configuration marchand.

La configuration recipient inclut la fonctionnalité Stripe_balance.stripe_transfers, qui permet au solde Stripe de l’Account de recevoir des transferts depuis le solde de la plateforme. Vous devez attribuer la fonctionnalité stripe_balance.stripe_transfers pour utiliser les paiements indirects.

Vous devez également affecter la configuration merchant à vos comptes connectés dans les cas suivants :

• Vous utilisez les paiements directs. Il est rare que les marketplaces utilisent ce type de paiement.
• Vous utilisez les paiements indirects avec le paramètre on_behalf_of pour définir un compte connecté comme marchand attitré.

Exemple de code

curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-09-30.preview" \
  --json '{
    "contact_email": "testaccount@example.com",
    "display_name": "Test account",
    "defaults": {
        "responsibilities": {
            "fees_collector": "application",
            "losses_collector": "application"
        }
    },
    "dashboard": "express",
    "identity": {
        "country": "us"
    },
    "configuration": {
        "recipient": {
            "capabilities": {
                "stripe_balance": {
                    "stripe_transfers": {
                        "requested": true
                    }
                }
            }
        }
    },
    "include": [
        "configuration.recipient",
        "identity",
        "requirements"
    ]
  }'

La réponse inclut l’identifiant que vous utiliserez pour référencer le Account tout au long de votre intégration. Une fois la requête réussie, le compte est en état d’attente. Ensuite, utilisez les informations dont vous disposez déjà pour préremplir le formulaire d’onboarding du compte connecté.

Si vous avez déjà collecté des informations pour vos comptes connectés, vous pouvez préremplir ces informations dans l’objet Account. Vous pouvez préremplir n’importe quelle information de compte, y compris des informations personnelles et professionnelles, des informations de compte externe, etc.

Après avoir créé un compte, créez une Person et définissez relationship.representative sur true pour représenter la personne responsable de l’ouverture du compte et toutes les informations de compte que vous souhaitez préremplir (par exemple, son prénom et son nom).

curl https://api.stripe.com/v1/accounts/
{{ACCOUNT_ID}}
/persons \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d first_name=Jenny \
  -d last_name=Rosen \
  -d "relationship[representative]"=true

Connect Onboarding ne demande pas les informations préremplies. Cependant, il demande au titulaire du compte de confirmer les informations préremplies avant d’accepter le contrat d’utilisation du service Connect.

Lorsque vous testez votre intégration, préremplissez les informations du compte à l’aide des données de test.