Fonctionnalités du compte

Les fonctionnalités que vous demandez pour un compte connecté déterminent les informations que vous devez collecter pour ce compte. Pour réduire les efforts d’intégration, assurez-vous de ne demander que les seules fonctionnalités dont vous avez réellement besoin. Plus vous en demandez, plus vous devrez collecter d’informations.

Vous pouvez commencer par renseigner le profil de la plateforme pour déterminer quelles fonctionnalités peuvent être appropriées.

Après avoir créé un compte, vous pouvez demander des fonctionnalités supplémentaires et supprimer les fonctionnalités temporaires existantes. Pour les comptes connectés contrôlés par d’autres plateformes, vous ne pouvez pas demander la désactivation de fonctionnalités.

Fonctionnalités prises en charge

Voici une liste des fonctionnalités disponibles. Cliquez sur un élément pour le développer ou le réduire.

Fonctionnalités multiples

Il est courant de demander plusieurs fonctionnalités pour un seul compte connecté, mais cela implique les éléments suivants :

• Les fonctionnalités sont indépendantes les unes des autres.
• Si un compte connecté possède à la fois card_payments et transfers et que le status de l’un ou de l’autre est inactive, cela signifie que les deux fonctionnalités sont désactivées.
• Vous pouvez faire déposer ou annuler une demande de fonctionnalité pour un compte connecté à tout moment pendant le cycle de vie du compte.

Les fonctionnalités vous permettent également de collecter simultanément différentes informations. Par exemple, vous pouvez collecter à la fois des informations fiscales requises et des informations nécessaires pour une fonctionnalité demandée. Si vous inscrivez un compte connecté avec la fonctionnalité transfers et qu’il doit remplir un formulaire 1099-MISC auprès de l’IRS (un formulaire fiscal fédéral américain), vous pouvez collecter ces informations en une seule fois.

Créer un compte avec des fonctionnalités

Les fonctionnalités sont définies sur l’objet Account. Pour obtenir la liste des fonctionnalités disponibles pour un objet Account, utilisez l’endpoint list_capabilities.

Les fonctionnalités de création et de demande de compte diffèrent pour les comptes connectés selon les configurations.

• Pour les comptes connectés ayant accès à l’ensemble du Dashboard Stripe, y compris les comptes Standard, certaines fonctionnalités sont demandées automatiquement, en fonction de leur pays. Vous pouvez également demander d’autres fonctionnalités en leur nom.
• Pour les comptes connectés ayant accès au Dashboard Express, y compris les comptes Express, vous pouvez soit demander leurs fonctionnalités, soit utiliser les paramètres de configuration de l’intégration pour automatiser les demandes de fonctionnalité.
• Pour les comptes connectés sans accès à un Dashboard hébergé par Stripe, y compris les comptes Custom, vous devez demander leurs fonctionnalités.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "controller[fees][payer]"=application \
  -d "controller[losses][payments]"=application \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[requirement_collection]"=application \
  -d country=US \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true

Les exigences en matière d’information varient selon les fonctionnalités, mais elles sont souvent liées à la vérification de l’identité ou à d’autres informations spécifiques à un type de paiement.

Lorsque votre compte connecté est créé avec succès, vous pouvez récupérer une liste de ses exigences :

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Dans la réponse, l’algorithme de hachage requirements précise quelles sont les informations nécessaires. Les valeurs pour payouts_enabled et charges_enabled indiquent si les paiements et virements sont activés sur le compte.

Fonctionnalités pour les comptes connectés existants

Les sections suivantes décrivent la manière de prévisualiser les exigences en matière d’informations ou de gérer les fonctionnalités des comptes connectés existants à l’aide de l’API Capabilities.

Obtenir un aperçu des exigences en matière d’informations

Vous pouvez obtenir un aperçu des informations que vous devez recueillir auprès de vos comptes connectés pour une fonctionnalité spécifique avant ou après en avoir fait la demande.

Lorsque vous demandez des fonctionnalités, les webhooks account.updated sont déclenchés et les exigences associées au compte peuvent changer. Pour activer une exigence plus rapidement et éviter de désactiver le compte, consultez les exigences et collectez toutes les informations requises avant de demander la fonctionnalité.

L’exemple suivant énumère les exigences de la fonctionnalité card_payments d’un compte donné.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/capabilities/card_payments \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Dans la réponse, vérifiez l’algorithme de hachage requirements pour déterminer quelles informations sont nécessaires :

{
  "id": "card_payments",
  "object": "capability",
  "account": 
"{{CONNECTED_ACCOUNT_ID}}",
  "requested": false,
  "requested_at": null,
  "requirements": {
    "past_due": [],
    "currently_due": ["company.tax_id", ...],
    "eventually_due": [...],
    "disabled_reason": ...,
    "current_deadline": ...,
  },
  "status": "unrequested"
}

La valeur status détermine si la fonctionnalité a été demandée. Lorsqu’elle est demandée, les exigences du compte sont actives.

En plus de prévisualiser les exigences d’une fonctionnalité avant de la demander, vous pouvez aussi utiliser le même endpoint pour afficher les exigences actuelles d’une fonctionnalité. Cela peut vous aider à garder un œil sur les exigences et leur évolution.

Demander l’activation et la désactivation de fonctionnalités

Pour demander une fonctionnalité pour un compte, définissez la valeur requested de la fonctionnalité sur true en mettant à jour le compte. Si la requête aboutit, l’API renvoie requested: true dans la réponse.

Pour annuler une demande de fonctionnalité pour un compte, définissez la valeur requested de la fonctionnalité sur false en mettant à jour le compte. Si la fonctionnalité ne peut pas être supprimée, l’appel renvoie une erreur. Si l’appel aboutit, l’API renvoie requested: false dans la réponse.

Vous pouvez également demander et supprimer des fonctionnalités pour un compte depuis le Dashboard. Si une fonctionnalité ne peut pas être supprimée, son bouton Supprimer est désactivé.

L’exemple ci-dessous demande la fonctionnalité transfers pour un compte connecté spécifique :

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/capabilities/transfers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d requested=true

L’exemple ci-dessous demande plusieurs fonctionnalités pour un compte connecté spécifique :

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "capabilities[bancontact_payments][requested]"=true \
  -d "capabilities[eps_payments][requested]"=true \
  -d "capabilities[ideal_payments][requested]"=true \
  -d "capabilities[p24_payments][requested]"=true \
  -d "capabilities[sepa_debit_payments][requested]"=true

Fonctionnalités obsolètes

Les fonctionnalités décrites dans les sections suivantes sont obsolètes. Dans la mesure du possible, ne les demandez pas pour de nouveaux comptes. Si vous avez des comptes existants qui utilisent des fonctionnalités obsolètes, nous vous recommandons de les mettre à jour pour les remplacer par d’autres fonctionnalités.

legacy_payments

La fonctionnalité legacy_payments permet d’effectuer des paiements, des virements et des transferts. Les comptes plus récents permettent ces actions à l’aide des fonctionnalités card_payments et transfers, qui prennent en charge des configurations plus flexibles.

Nous vous recommandons de suivre les étapes suivantes :

1. Mettez à jour le processus d’inscription de votre compte connecté pour demander la combinaison appropriée de card_payments et de transfers au lieu de legacy_payments.

2. Mettez à jour vos comptes connectés existants pour demander la combinaison appropriée de card_payments et de transfers.

3. Mettez à jour toute écriture de code portant sur l’état de legacy_payments pour vérifier l’état de legacy_payments ou de la nouvelle fonctionnalité appropriée. Par exemple, mettez à jour le code qui s’appuie sur la capacité d’un compte à effectuer des paiements par carte pour s’exécuter lorsque card_payments ou legacy_payments est actif. De même, mettez à jour le code qui s’appuie sur la capacité d’un compte à accepter des transferts pour s’exécuter lorsque legacy_payments ou transfers est actif. Le code mis à jour fonctionne tout au long du processus de transition vers les nouvelles fonctionnalités, quel que soit le moment où celles-ci deviennent actives.

4. Une fois que les nouvelles fonctionnalités sont actives pour tous vos comptes connectés, supprimez les références à legacy_payments de votre code.

Si vous entreprise exerce des activités commerciales au Canada, Stripe demande automatiquement card_payments et transfers pour vos comptes qui utilisent legacy_payments, afin de vous conformer aux nouvelles exigences. Au cours du processus, les valeurs suivantes peuvent apparaître dans les réponses API de vos comptes connectés.

capabilities: {
  legacy_payments: "active"
},
charges_enabled: true,
payouts_enabled: true

capabilities: {
  card_payments: "inactive",
  legacy_payments: "active",
  transfers: "inactive"
},
charges_enabled: true,
payouts_enabled: true

capabilities: {
  card_payments: "active",
  legacy_payments: "active",
  transfers: "active"
},
charges_enabled: true,
payouts_enabled: true