Fonctionnalités du compte

Les fonctionnalités représentent des fonctions que vous pouvez demander pour vos comptes connectés, telles que l’acceptation des paiements par carte ou la réception de fonds transférés depuis le compte de votre plateforme.

La plupart des fonctionnalités nécessitent la vérification de certaines informations concernant l’entreprise du compte connecté avant que Stripe ne les active pour ce 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’inscription, demandez uniquement les fonctionnalités dont vos comptes ont besoin. Demander plus de fonctionnalités signifie que le flux d’inscription doit vérifier davantage 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 des informations à des fins multiples en même temps. Par exemple, vous pouvez collecter à la fois les informations fiscales requises et les informations nécessaires pour une fonctionnalité demandée.

Demander des fonctionnalités pour un compte

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 de compte et de demande 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.

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 votre entreprise exerce des activités commerciales au Canada, Stripe demande automatiquement card_payments et transfers pour vos comptes qui utilisentlegacy_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