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.
Note
La plupart des fonctionnalités demandées sont activées de façon permanente. Toute tentative de suppression ou d’annulation renvoie une erreur.
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.
Transfers
Card payments
Déclaration fiscale aux États-Unis
Payment methods
Paiements internationaux en Inde
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
ettransfers
et que lestatus
de l’un ou de l’autre estinactive
, 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. Les utilisateurs n’ont donc pas besoin de le renvoyer plusieurs fois. 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 utilisateur 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 trouver la liste des fonctionnalités disponibles, 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.
- Les fonctionnalités sont automatiquement demandées pour tous les comptes que vous configurez qui ont un accès au Dashboard Stripe complet, y compris les comptes Standard.
- Pour les comptes ayant accès au Dashboard Express, y compris les comptes Express, vous pouvez soit demander des fonctionnalités lors de la création du compte, soit utiliser les paramètres de configuration de l’inscription pour automatiser les fonctionnalités demandées.
- Vous devez demander des fonctionnalités lorsque vous créez des comptes connectés n’ayant pas accès à un Dashboard hébergé par Stripe, y compris les comptes Custom.
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.
Une fois votre compte connecté créé, vous pouvez en consulter les exigences :
Dans la réponse, vérifiez l’algorithme de hachage requirements
pour déterminer quelles informations sont nécessaires. Les valeurs pour payouts_enabled
et charges_enabled
indiquent si les paiements et virements sont activés sur le compte.
En savoir plus sur les fonctionnalités
L’article ci-dessus traite des bases de la création de comptes. Toutefois, vous pouvez avoir besoin d’afficher les exigences en matière d’informations ou de gérer les fonctionnalités de comptes existants. Les sections suivantes expliquent comment réaliser ces actions avec 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 utilisateurs pour une fonctionnalité spécifique avant ou après avoir demandé la fonctionnalité.
Lorsque vous demandez des fonctionnalités, les webhooks account.updated
sont déclenchés et les exigences associées au compte peuvent alors évoluer. En obtenant un aperçu des exigences et en recueillant les informations nécessaires pour le compte avant de demander la fonctionnalité, vous pourrez activer les paiements et les virements plus rapidement. Vous évitez également tout risque de désactivation du compte, car les informations ont déjà été collectées.
Vous trouverez ci-dessous un exemple répertoriant les exigences de la fonctionnalité card_payments
d’un compte donné.
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":
, "requested": false, "requested_at": null, "requirements": { "past_due": [], "currently_due": ["company.tax_id", ...], "eventually_due": [...], "disabled_reason": ..., "current_deadline": ..., }, "status": "unrequested" }"{{CONNECTED_ACCOUNT_ID}}"
La valeur status
détermine si la fonctionnalité est requested
(demandée). Lorsqu’elle est demandée, les exigences sont activées pour le compte.
Ces étapes expliquent comment obtenir un aperçu des exigences d’une fonctionnalité avant de la demander, mais vous pouvez utiliser le même endpoint pour visualiser les exigences actuelles d’une fonctionnalité. Cela peut vous aider à garder un œil sur les exigences d’une fonctionnalité et leur évolution.
Demander l’activation et la désactivation de fonctionnalités
Après avoir créé la plupart des comptes, vous pouvez demander des fonctionnalités supplémentaires et supprimer des fonctionnalités existantes. Pour demander une fonctionnalité, définissez la valeur requested
sur true
en mettant à jour le compte. Si la requête aboutit, l’API renvoie requested: true
dans la réponse. Vous ne pouvez pas demander de fonctionnalités pour les comptes connectés ayant accès au Dashboard Stripe complet, y compris les comptes Standard.
Pour annuler une demande de fonctionnalité, mettez à jour le compte afin de définir la valeur requested
de la fonctionnalité sur false
. Si la fonctionnalité ne peut pas être supprimée, cet 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 :
L’exemple ci-dessous demande plusieurs fonctionnalités pour un compte connecté spécifique :