Fonctionnalités du compte

Comprendre les fonctionnalités activables pour les comptes et les exigences à satisfaire pour les utiliser.

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 et le mode test peuvent ne pas imposer certaines fonctionnalités. Dans certains cas, ils peuvent permettre à un compte d’effectuer des actions dépendantes des fonctionnalités, même lorsque l’état de la fonctionnalité associée n’est pas actif.

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.

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 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.

Transferts

Vous pouvez transférer des fonds vers des comptes connectés disposant de la fonctionnalité transfers. Les plateformes à la demande l’utilisent souvent pour payer les comptes connectés. Par exemple, une plateforme de chauffeurs privés pourrait l’utiliser pour payer ses chauffeurs. Le diagramme suivant illustre le flux des fonds et la relation entre les clients, la plateforme et les comptes connectés.

Relation entre les clients, la plateforme et les comptes connectés.

Lorsque vous utilisez la fonctionnalité transfers, c’est votre plateforme, et non le compte connecté, qui traite les frais. Par conséquent, les relevés bancaires des clients d’un compte connecté affichent le libellé de relevé bancaire de votre plateforme, et non celui du compte connecté.

Les paiements effectués à l’aide de la fonctionnalité transfers comprennent les paiements indirects et les paiements et transfers distincts.

Remarque

Avant la version 2019-08-14 de l’API, la fonctionnalité transfers était dénommée platform_payments. Si la version d’API que vous utilisez est antérieure à la version 2019-08-14, utilisez platform_payments.

Transferts internationaux

Le déplacement de fonds entre pays est soumis à des exigences supplémentaires et n’est pris en charge que dans les scénarios suivants :

Plateformes de l’Union européenne, du Royaume-Uni et de Gibraltar envoyant des fonds vers les pays SEPA.
Plateformes basées aux États-Unis envoyant des fonds vers des destinations de paiement international par le biais d’un contrat de service de type bénéficiaire.

Pour d’autres scénarios, créez un compte de plateforme dans la même région que vos comptes connectés. En fonction de la structure de votre entreprise, il vous faudra peut-être créer une entité juridique dans cette région et suivre des étapes supplémentaires pour inscrire les comptes connectés.

Paiements par carte

Les comptes connectés dotés de la fonctionnalité card_payments peuvent recevoir des paiements de votre plateforme et traiter directement les paiements par carte bancaire et ACH. Une boutique en ligne disposant de cette fonctionnalité peut, par exemple, encaisser ses propres paiements. Le diagramme suivant illustre le flux de fonds et la relation entre les clients, les comptes connectés et la plateforme :

Relation entre les clients, les comptes connectés et la plateforme.

Pour qu’un compte soit doté de la fonctionnalité card_payments, vous devez demander à la fois les fonctionnalités card_payments et transfers.

Lorsqu’un compte connecté dispose de cette fonctionnalité, les relevés bancaires de ses clients affichent le libellé de relevé bancaire du compte connecté, et non celui de la plateforme.

La fonctionnalité card_payments s’applique à tous les types de paiement.

Déclaration fiscale aux États-Unis

L’administration fiscale aux États-Unis, l’Internal Revenue Service (IRS), exige de certaines plateformes le dépôt de formulaires 1099 entre janvier et mars, et l’envoi du rapport de ces dépôts à leurs comptes connectés au plus tard le 31 janvier. Pour remplir les formulaires, ces plateformes doivent collecter des informations supplémentaires auprès de leurs comptes connectés.

Remarque

Stripe vous recommande de consulter un conseiller fiscal afin de déterminer vos obligations en matière de déclaration fiscale.

Si votre plateforme a l’obligation de déposer des formulaires 1099 auprès de l’IRS et que vous souhaitez effectuer cette déclaration par l’intermédiaire de Stripe, vous pouvez utiliser les fonctionnalités tax_reporting_us_1099_misc et tax_reporting_us_1099_k pour recueillir auprès de vos comptes connectés les informations personnelles et les informations de l’entreprise nécessaires.

Formulaire 1099-MISC

De nombreux types de paiements imposent de renseigner un formulaire IRS 1099-MISC, comme les paiements à des personnes non salariées ou des sous-traitants, les versements de droits d’auteur, les récompenses, etc. La fonctionnalité tax_reporting_us_1099_misc facilite le recueil des informations requises pour ce formulaire. Par exemple, une plateforme de créateurs pourra utiliser la fonctionnalité tax_reporting_us_1099_misc pour recueillir les informations nécessaires aux fins de ses déclarations fiscales auprès de ses fournisseurs de contenu.

Formulaire 1099-K

Le formulaire 1099-K récapitule les paiements reçus dans le cadre de transactions par carte de crédit et de réseaux de paiement tiers. Les organisations de virement de fonds tierces utilisent habituellement ce formulaire pour déclarer le montant brut de leurs transactions au cours de l’année calendaire. Par exemple, une plateforme d’e-commerce utilisera la fonctionnalité tax_reporting_us_1099_k pour recueillir les informations nécessaires à la déclaration fiscale auprès de chaque boutique.

Pour plus d’informations sur la déclaration fiscale des comptes connectés établis aux États-Unis, consultez Gérer les formulaires fiscaux.

Moyens de paiement

Certains moyens de paiement sont activés par la fonctionnalité card_payments, tandis que d’autres le sont par leur propre fonctionnalité.

Si vous débitez le client avant d’effectuer le paiement, consultez votre Dashboard pour prendre connaissance des moyens de paiement disponibles.

Pour permettre aux comptes connectés d’accepter un moyen de paiement pour les paiements directs ou les payments avec on_behalf_of, vous devez demander la fonctionnalité associée à ce moyen de paiement pour ces comptes.

Accès du compte au Dashboard:

Pour les comptes connectés ayant accès au Dashboard Stripe complet, y compris les comptes Standard, la plupart des fonctionnalités de moyens de paiement sont activées par défaut. Ces comptes peuvent gérer leurs propres fonctionnalités de moyens de paiement. Vous pouvez également demander des fonctionnalités pour eux en appelant l’API de mise à jour des fonctionnalités, et lister les fonctionnalités activées d’un compte en appelant l’API des comptes.

Dans le tableau suivant, la colonne Tous les types d’entreprises pris en charge indique que tous les types d’entreprise sont pris en charge, sauf interdiction de Stripe. La colonne Exigences supplémentaires en matière de vérification désigne les exigences autres que celles de la fonctionnalité card_payments.

Moyen de paiement et fonctionnalité associée	Tous les types d’entreprises pris en charge	Disponible par défaut	Exigences supplémentaires en matière de vérification	Pays concernés	Prise en charge de Accounts v2

Prélèvement automatique ACH `us_bank_account_ach_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui ; le nom de la fonctionnalité v2 est `ach_debit_payments`
Affirm `affirm_payments`	Non, consultez la liste des activités interdites.	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Afterpay Clearpay `afterpay_clearpay_payments`	Non, consultez la liste des activités interdites.	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Alipay `alipay_payments`	Non, consultez la liste des activités interdites.	Le moyen de paiement doit être activé dans la page des paramètres du Dashboard. Demandez également une invitation pour créer des paiements au nom d’autres comptes.	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Non
Apple Pay Disponible avec `card_payments`	Oui	Avec Checkout - Oui Avec Payment Element : le moyen de paiement doit être configuré dans la page des paramètres du Dashboard.	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Prélèvements automatiques Bacs `bacs_debit_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Bancontact `bancontact_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Prélèvement automatique BECS `au_becs_debit_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
BLIK `blik_payments`	Oui	Le moyen de paiement doit être activé dans la page des paramètres du Dashboard.	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Boleto `boleto_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Paiement par prélèvement automatique canadien `acss_debit_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Cartes Bancaires `cartes_bancaires_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Cash App Pay `cashapp_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
EPS `eps_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
FPX `fpx_payments`	Non, les entreprises dotées d’un numéro d’immatriculation valide uniquement.	La fonctionnalité doit être activée dans la page des paramètres du Dashboard.	Oui	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Google Pay Disponible avec `card_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
GrabPay `grabpay_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
iDEAL `ideal_payments`	Oui	Oui	Oui, le numéro fiscal est requis pour les entreprises individuelles.	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
JCB Japan `jcb_payments`	Oui	Oui	Non	Le compte connecté doit se trouver au Japon.	Oui
Klarna `klarna_payments`	Non, consultez les entreprises interdites.	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Konbini `konbini_payments`	Non, consultez la liste des activités interdites.	Le moyen de paiement doit être activé dans la page des paramètres du Dashboard.	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Link `link_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
MobilePay `mobilepay_payments`	Non, consultez la liste des activités interdites.	Le moyen de paiement doit être activé dans la page des paramètres du Dashboard.	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Multibanco `multibanco_payments`	Oui	Le moyen de paiement doit être activé dans la page des paramètres du Dashboard.	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
OXXO `oxxo_payments`	Oui	Oui, lors de la première tentative de paiement.	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
P24 `p24_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Pay by Bank `pay_by_bank_payments`	Oui	Le moyen de paiement doit être activé dans la page des paramètres du Dashboard.	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
PayNow `paynow_payments`	Non, consultez la liste des activités interdites.	Oui, si le code de catégorie de marchand (MCC) n’entre pas dans la liste des activités interdites de PayNow.	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Pix `pix_payments`	Oui	La fonctionnalité doit être activée dans la page des paramètres du Dashboard.	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Non
PromptPay `promptpay_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Satispay `satispay_payments`	Non, consultez la liste des activités interdites.	La fonctionnalité doit être activée dans la page des paramètres du Dashboard.	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Virements bancaires SEPA `sepa_bank_transfer_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Prélèvement SEPA `sepa_debit_payments`	Oui	Oui	Oui	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
Sofort `sofort_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Non
Transferts bancaires en USD `us_bank_transfer_payments`	Oui	Oui	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Oui
WeChat Pay `wechat_pay_payments`	Non, consultez la liste des activités interdites.	Le moyen de paiement doit être activé dans la page des paramètres du Dashboard. Demandez également une invitation pour créer des paiements au nom d’autres comptes.	Non	Le compte connecté doit se trouver dans un pays pris en charge.	Non

En savoir plus sur la prise en charge des moyens de paiement pour Connect.

paiements internationaux en Inde

Vous devez demander à pouvoir prendre en charge les transactions d’acheteurs situés en dehors de l’Inde qui utilisent une devise autre que l’INR. Procédez comme suit lors de votre processus d’inscription pour activer les paiements internationaux :

Indiquez un code de motif de la transaction. Le champ export_purpose_code décrit la nature d’un paiement reçu en devise étrangère. La liste complète des codes de motif de transaction est tenue à jour par la banque centrale indienne (RBI). Le sous-ensemble de codes de motif de transaction pris en charge par Stripe est précisé ici.
Indiquez votre code d’importateur/exportateur (IEC). Le champ export_license_id contient la valeur du code IEC. Ce code est émis par la Direction générale du commerce extérieur (DGFT) indienne. Vous pouvez demander un IEC sur le site Web de la DGFT. Un IEC est exigé dans certains cas de figure.
- Si vous prévoyez d’accepter les cartes Visa ou Mastercard, un IEC n’est obligatoire que si vous vendez des biens matériels. Votre export_purpose_code concerne les biens physiques.
- Si vous prévoyez d’accepter les paiements internationaux AMEX pour toutes les transactions d’exportation, y compris la vente de biens physiques et de services. Ceci est expliqué dans la politique de commerce extérieur de l’Inde.

Pour en savoir plus, consultez la page Accepter les Payments internationaux depuis l’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 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.

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 :

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é.

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 :

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

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 :

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.
Mettez à jour vos comptes connectés existants pour demander la combinaison appropriée de card_payments et de transfers.
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.
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 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.

Avant de demander de nouvelles fonctionnalités Nouvelles fonctionnalités demandées Nouvelles exigences satisfaites

Avant de demander de nouvelles fonctionnalités	Nouvelles fonctionnalités demandées	Nouvelles 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`

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

Créer un paiement