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

Fonctionnalités et configurations du compte

Découvrez les fonctionnalités que vous pouvez activer pour les comptes, les configurations de compte auxquelles elles appartiennent et les exigences les concernant.

Vous pouvez demander des fonctionnalités pour vos comptes connectés, telles que l’acceptation des paiements par carte ou la réception de fonds transférés depuis votre compte plateforme. Une fonctionnalité doit être active pour qu’un compte connecté puisse effectuer des actions associées à cette fonctionnalité.

Tester les fonctionnalités

Les environnements de test peuvent ne pas imposer certaines fonctionnalités. Dans certains cas, ils peuvent permettre à un Account d’effectuer des actions dépendantes des fonctionnalités, même lorsque le status de la fonctionnalité associée n’est pas active.

Avant que Stripe ne les active, la plupart des fonctionnalités nécessitent la vérification de certaines informations sur l’entreprise du compte connecté. Les fonctionnalités dont vous faites la requête pour un compte connecté déterminent les informations que vous devez collecter pour celui-ci. Pour réduire les efforts d’onboarding, effectuez uniquement la requête des fonctionnalités dont vos comptes ont besoin. Plus vous faites de requêtes de fonctionnalités, plus le flux d’onboarding doit vérifier d’informations.

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

Remarque

Certaines des fonctionnalités demandées sont activées de façon permanente. Toute tentative de suppression ou d’annulation renvoie une erreur.

Après la création d’un Account, vous pouvez effectuer la requête de fonctionnalités supplémentaires et supprimer des fonctionnalités non permanentes existantes. Pour les comptes connectés contrôlés par d’autres plateformes, vous ne pouvez pas annuler la requête 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.

Transferts

Paiements par carte

Déclaration fiscale aux États-Unis

Moyens de paiement

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 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 effectuer la requête ou annuler la requête de la plupart des fonctionnalités pour un compte connecté à tout moment de son cycle de vie.

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 Account, utilisez l’endpoint list Capabilities.

La création de Account et la requête de fonctionnalités diffèrent selon les configurations des comptes connectés.

  • 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.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -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 :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
 \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:"

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.

Comprendre les exigences des fonctionnalités

Stripe signale les exigences liées au risque et à la conformité dans le hachage requirements de l’objet Capability. Les exigences répertoriées dans ce hachage précisent quelles informations doivent être fournies par votre compte connecté pour éviter la désactivation de cette fonctionnalité.

Les exigences basées sur formulaire et sur support suivent le format <id>.<requirement_description>.<resolution_path>, où id est préfixé par interv_ pour indiquer une exigence de vérification liée au risque.

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 effectuer une requête de fonctionnalités, cela déclenche un événement de webhook account.updated et les exigences de l’Account peuvent changer. Pour activer une exigence plus rapidement et éviter la désactivation de l’Account, prévisualisez les exigences et collectez toutes les informations requises avant d’effectuer la requête d’une fonctionnalité.

Dans l’exemple suivant, les exigences pour la fonctionnalité card_payments d’un Account sont répertoriées.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/capabilities/card_payments \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:"

Vérifiez le hachage requirements dans la réponse pour voir 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 de status indique si une requête de la fonctionnalité a été effectuée. Lorsque la valeur est requested, les exigences de l’Account 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 effectuer la requête d’une fonctionnalité pour un Account, mettez à jour la fonctionnalité pour définir la valeur de requested sur true. Si la requête aboutit, l’API renvoie requested : true dans la réponse.

Pour annuler la requête d’une fonctionnalité pour un Account, mettez à jour la fonctionnalité pour définir la valeur de requested sur false. 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é.

Dans l’exemple ci-dessous, une requête de la fonctionnalité transfers pour un compte connecté est effectuée :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/capabilities/transfers \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d requested=true

Dans l’exemple ci-dessous, une requête de différentes fonctionnalités pour un compte connecté est effectuée :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
 \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -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, n’effectuez pas de requêtes pour ces fonctionnalités pour les nouveaux Accounts. Si vous avez des Accounts existants qui utilisent des fonctionnalités obsolètes, nous vous recommandons de les mettre à jour pour qu’ils utilisent d’autres fonctionnalités.

legacy_payments

La fonctionnalité legacy_payments permet d’effectuer des paiements, des virements et des transferts. Les Accounts plus récents activent 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 tout code qui vérifie l’état de legacy_payments pour vérifier l’état de legacy_payments ou de la nouvelle fonctionnalité concernée. Par exemple, mettez à jour le code qui s’appuie sur la capacité d’un Account à effectuer des paiements par carte bancaire pour s’exécuter lorsque legacy_payments ou card_payments est actif. De même, mettez à jour le code qui s’appuie sur la capacité d’un Account à accepter les 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ù les nouvelles fonctionnalités 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.

Remarque

Vous ne pouvez pas annuler la demande de cette fonctionnalité legacy_payments. Stripe vous informera à l’avance avant de la supprimer.

Si vous exercez vos activités au Canada, pour se conformer aux nouvelles exigences, Stripe effectue automatiquement la requête de card_payments et de transfers pour vos Accounts qui utilisent legacy_payments. Au cours du processus, vous pouvez voir les valeurs suivantes dans les réponses d’API de vos comptes connectés.

Avant de demander de nouvelles fonctionnalitésNouvelles fonctionnalités demandéesNouvelles exigences satisfaites
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

Remarque

Pendant la transition, les exigences card_payments et transfers peuvent apparaître dans past_due. Toutefois, si legacy_payments est actif, les paiements, les transferts et les virements restent activés.

Voir aussi