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

Créer un compte connectéVersion bêta publique

Créez et configurez vos comptes connectés à l’aide de l’API Comptes v2.

Lorsque vous ajoutez un compte connecté à votre plateforme SaaS, sa configuration définit les interactions entre ce compte, votre plateforme et Stripe, notamment :

  • Comment les paiements sont distribués entre chaque partie
  • Quelle entreprise paie les frais Stripe
  • Quelle entreprise finance les remboursements et les litiges

Avant de commencer

Suivez le processus d’inscription pour configurer votre compte plateforme Stripe.

Ce guide décrit les différents éléments d’un compte connecté qui utilise votre plateforme pour traiter les paiements de son activité. L’exemple de code en fin de guide montre la requête comment créer un compte connecté avec tous ses éléments, mais vous pouvez également utiliser la méthode update pour construire les propriétés du compte connecté de manière itérative.

Créer un compte connecté

Définissez les propriétés d’identité du compte connecté, telles que le nom, l’adresse, les coordonnées principales et le type de l’entreprise. Vous pouvez également permettre à l’utilisateur du compte de fournir ces informations lors de l’inscription.

Attribuer des configurations

Les comptes connectés interagissent avec votre plateforme et Stripe en fonction des configurations que vous leur attribuez. La plupart des plateformes SaaS attribuent :

  • La configuration marchand permet au compte connecté d’accepter des paiements par carte de ses propres clients.
  • La configuration client permet au compte connecté de payer à votre plateforme des frais d’abonnement, si vous en facturez.

Spécifier les capacités du marchand

La configuration du marchand régit le comportement des paiements des clients du compte connecté dans Stripe. Lorsque vous affectez cette configuration, vous devez également spécifier les paramètres suivants.

ConfigurationComportementValeurs
DashboardComment le compte connecté consulte son activité et ses paramètres Stripe.
  • full
  • hébergé
  • intégrée
Encaissement des fraisDétermine qui collecte les frais de paiement du compte connecté.
  • raie (Stripe perçoit directement les frais)
  • application (Votre plateforme collecte des commissions de la plateforme, puis Stripe prélève des frais sur votre plateforme.)
Responsabilité en cas de perteAttribue la responsabilité des soldes négatifs encourus par le compte connecté.
  • stripe (Stripe est responsable des soldes négatifs des comptes connectés)
  • application (Votre plateforme est responsable des soldes négatifs et gère le risque pour le compte connecté)
Présentation des moyens de paiementLes types de paiements, cartes bancaires, débit et wallets, à activer pour que le compte connecté puisse les accepter.Consultez la liste des fonctionnalités des moyens de paiement disponibles. Vous devez au minimum demander card_payments.

Spécifier les fonctionnalités du client

La configuration du client définit la manière dont votre compte connecté paie son abonnement à votre plateforme, y compris si vous collectez des taxes auprès de celui-ci et comment vous le facturez.

Exemple de code

L’exemple de code suivant montre une requête de création de compte connecté qui ajoute les configurations marchand, client et destinataire, où :

  • Stripe collecte les frais et gère les risques pour les paiements directs sur le compte connecté.
  • Les paiements par carte sont activés sur le compte connecté.
  • Les compte connectés peuvent accéder à leurs comptes via le Dashboard Stripe.
  • Vous transfert les paiements sur le solde du compte connecté.
  • Le paramètre include permet de demander des valeurs complètes dans la réponse pour certains objets de paramètres, qui seraient autrement par défaut null.
Command Line
cURL
No results
curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-04-30.preview" \
  --json '{
    "contact_email": "furever_contact@example.com",
    "display_name": "Furever",
    "dashboard": "full",
    "identity": {
        "business_details": {
            "registered_name": "Furever"
        },
        "country": "us",
        "entity_type": "company"
    },
    "configuration": {
        "customer": {
            "capabilities": {
                "automatic_indirect_tax": {
                    "requested": true
                }
            }
        },
        "merchant": {
            "capabilities": {
                "card_payments": {
                    "requested": true
                }
            }
        },
        "recipient": {
            "capabilities": {
                "stripe_balance": {
                    "stripe_transfers": {
                        "requested": true
                    }
                }
            }
        }
    },
    "defaults": {
        "currency": "usd",
        "responsibilities": {
            "fees_collector": "stripe",
            "losses_collector": "stripe"
        },
        "locales": [
            "en-US"
        ]
    },
    "include": [
        "configuration.customer",
        "configuration.merchant",
        "identity",
        "requirements"
    ]
  }'

Étapes suivantes

Après avoir créé et configuré votre compte connecté, configurez son accès au Dashboard.

Cette page vous a-t-elle été utile ?
OuiNon