Utilisez l’objet Accounts en tant que clients

Avec Comptes v2, vous pouvez utiliser un objet de compte de manière similaire à un objet Customer en lui assignant la configuration client.

curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-11-17.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "individual": {
            "given_name": "Jenny Rosen"
        }
    },
    "configuration": {
        "customer": {
            "capabilities": {
                "automatic_indirect_tax": {
                    "requested": true
                }
            }
        }
    },
    "include": [
        "configuration.customer",
        "identity"
    ]
  }'

Lorsque vous activez Accounts v2, vos intégrations hébergées sur Stripe, comme Checkout, créent des comptes avec la configuration client au lieu de créer des clients. Nous vous recommandons de mettre à jour les références client dans votre code afin qu’elles renvoient plutôt aux comptes.

Fournir un compte en tant que client

Requêtes API telles que Subscriptions et SetupIntents vous obligent à spécifier un client. Ces demandes acceptent soit les paramètres customer oucustomer_account. L’exemple suivant montre un abonnement qui spécifie le client en passant un objet Accounts v2 comme le customer_account.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-04-30.preview" \
  -d customer_account=acct_xxxxx \
  -d "items[0][price]"=price_CBb6IXqvTLXp3f \
  -d "items[0][quantity]"=5

Comptes de référence dans les intégrations Customer v1

Une requête qui précise le paramètre customer_account renvoie les deux propriétés customer etcustomer_account, avec des valeurs formatées correspondantes. Cela maintient la compatibilité avec les intégrations existantes de Billing and Payments.

{
  "id": "sub_1Mow234",
  .
  .
  .
  "customer": "cus_xxxxx",
  "customer_account": "acct_xxxxx"
}

Vous pouvez également récupérer ou mettre à jour des comptes configurés par le client en utilisant l’endpoint /v1/customers.

curl -X POST https://api.stripe.com/v1/customers/acct_1234 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Webhooks Accounts v2

Les webhooks Accounts v2 envoient des événements légers.

Propriétés de la facture client

Référencez un ID Accounts v2 dans un paramètre de chemin v1/clients

Accounts v2 n’a pas d’endpoints pour chaque fonction client. Pour effectuer les actions suivantes pour un objet Accounts v2, utilisez l’endpoint v1/customers et transmettez l’ID du compte (acct_xxxxx) comme paramètre de chemin d’accès.