Configurer une intégration pour Issuing et ConnectVersion bêta privée
Découvrez comment émettre des cartes pour vos comptes connectés.
Stripe Connect fournit aux plateformes Stripe Issuing une infrastructure permettant de gérer les flux de fonds et les exigences de conformité. Dans une intégration Connect, le compte de la plateforme effectue des appels à l’API au nom de ses comptes connectés.
Quand utiliser Connect ?
Si vous devez émettre des cartes à destination d’utilisateurs qui ne sont pas des employés directs de votre entreprise, configurez Stripe Connect pour votre intégration Issuing. Par exemple, une entreprise qui développe un nouveau produit de gestion des dépenses pour les petites entreprises peut développer une intégration à Connect. Chaque petite entreprise qui utilise le produit de gestion des dépenses sera représentée par un compte connecté.
Une fois que vous avez mis en place et intégré des comptes connectés, vos clients peuvent financer leurs dépenses par carte en alimentant leur solde Issuing à partir de leur compte bancaire externe (ou, dans certains cas, les dépenses de vos clients peuvent être financées par le solde Issuing de votre plateforme). Ils peuvent également créer un compte financier qu’ils peuvent approvisionner et utiliser pour régler leurs achats par carte, créer des titulaires de carte et des cartes, et mettre en place des contrôles des dépenses.
Créer plusieurs types de cartes sur le même compte connecté
Les plateformes peuvent permettre aux comptes connectés de créer différents types de cartes avec l’API programmes.
Créer des comptes connectés avec les fonctionnalités Issuing
Pour émettre des cartes, chaque entreprise doit utiliser un compte connecté. Issuing prend uniquement en charge les comptes connectés qui n’utilisent pas de Dashboard hébergé par Stripe, et pour lesquels votre plateforme est responsable du recouvrement des exigences et de la responsabilité des pertes, également connu sous le nom de compte connecté Custom. Découvrez comment créer des comptes connectés avec les API Accounts v2 qui fonctionnent avec Issuing. Les comptes connectés nécessitent des fonctionnalités spécifiques activées sur le compte pour utiliser les fonctionnalités Issuing. Les fonctionnalités demandées pour un compte connecté peuvent nécessiter des informations supplémentaires sur les propriétaires de vos comptes connectés.
Stripe Issuing fonctionne avec les objets Account v2. Un objet Account v2 représente une entreprise, un entrepreneur individuel ou une autre entité qui interagit avec une plateforme sur Stripe. Il contient des informations d’identification et des propriétés qui contrôlent son comportement et ses fonctionnalités. Un compte peut avoir une ou plusieurs configurations qui activent des ensembles de fonctionnalités associées, telles que la possibilité d’agir en tant qu’entreprise, client, destinataire, entité de stockage ou créateur de carte bancaire.
L’utilisation de la configuration card_ permet aux comptes de contrôler les fonctionnalités sur émission. Tous les comptes qui nécessitent des fonctionnalités d’émission doivent également demander la configuration recipient avec la fonctionnalité stripe_ demandée. En tant que plateforme, vous pouvez créer des comptes connectés avec les fonctionnalités requises pour l’émission. Vous pouvez inscrire le compte connecté en fournissant toutes les informations nécessaires.
Créer un compte
Créez un nouveau compte connecté via le Dashboard ou en utilisant l’API avec créez un compte.
Commencer avec les comptes de test
Les comptes connectés du mode test ne peuvent pas recevoir ni dépenser de fonds réels ni être utilisés en mode production, mais leur configuration et leurs fonctionnalités sont identiques à ceux du mode production.
Utilisez POST /v2/core/accounts pour créer un nouveau compte connecté. Utilisez le paramètre inclure pour spécifier les propriétés renvoyées dans la réponse. Vous pouvez également demander la configuration card_, la configuration merchant et la configuration recipient avec les fonctionnalités stripe_. Vous pouvez demander les fonctionnalités card_ suivantes pour le compte, qui activent différentes fonctionnalités pour Issuing au Royaume-Uni :
| Fonctionnalité | Description | Persona |
|---|---|---|
configuration. | Permet au compte connecté de créer des cartes de paiement avec Stripe comme sponsor BIN. | card_ |
configuration. | Permet au compte connecté de créer des cartes prépayées avec Stripe comme sponsor BIN. | card_ |
Exigence de structure pour les entreprises britanniques
Un compte britannique peut activer la fonctionnalité commercial. uniquement si sa company. est private_, public_ ou incorporated_. Cette fonctionnalité ne prend pas en charge les structures de partenariat telles que incorporated_ (LLP) et unincorporated_, même si elles sont valides pour d’autres fonctionnalités associées aux comptes britanniques.
curl -X POST https://api.stripe.com/v2/core/accounts \ -H "Authorization: Bearer" \ -H "Stripe-Version: 2025-09-30.preview" \ --json '{ "include": [ "configuration.card_creator", "configuration.recipient" ], "contact_email": "test@example.com", "display_name": "John Smith", "identity": { "country": "gb", "entity_type": "individual" }, "configuration": { "merchant": { "mcc": "5045", "statement_descriptor": { "descriptor": "test1" }, "support": { "phone": "7325460697" } }, "card_creator": { "capabilities": { "commercial": { "stripe": { "charge_card": { "requested": true } } } } }, "recipient": { "capabilities": { "stripe_balance": { "stripe_transfers": { "requested": true } } } } }, "dashboard": "none", "defaults": { "currency": "gbp", "responsibilities": { "fees_collector": "application", "losses_collector": "application" } } }'sk_test_VePHdqKTYQjKNInc7u56JBrQ
Sauf échec de l’opération, la réponse confirme la création du compte connecté et la fonctionnalité de sauvegarde requise :
{ "id": "acct_123", "object": "v2.core.account", "applied_configurations": [ "card_creator", "recipient", "merchant" ], "configuration": { "customer": null, "merchant": null, "recipient": { "capabilities": { "stripe_balance": { "stripe_transfers": { "requested": true, "status": "restricted", "status_details": [ { "code": "requirements_past_due", "resolution": "provide_info" } ] } } } }, "card_creator": { "capabilities": { "commercial": { "stripe": { "charge_card": { "requested": true, "status": "restricted", "status_details": [ { "code": "requirements_past_due", "resolution": "provide_info" } ] } } } } } }, "contact_email": "test@example.com", "created": "2025-06-18T00:48:16.000Z", "dashboard": "none", "identity": null, "defaults": null, "display_name": "John Smith", "metadata": {}, "requirements": null, "livemode": false }
Découvrez comment les appels de compte renvoient les données.
Activer Issuing sur les comptes connectés
Créez ensuite le programme avec la valeur platform_ appropriée. Vous pouvez lister vos programmes à l’aide de l’API programmes avec l’en-tête issuing_.
curl https://api.stripe.com/v1/issuing/programs \ -u ":" \ -H "Stripe-Version: 2026-06-24.dahlia; issuing_program_beta=v2" \ -H "Stripe-Account:sk_test_VePHdqKTYQjKNInc7u56JBrQ" \ -d platform_program=iprg_123 \ -d is_default=true{{CONNECTED_ACCOUNT_ID}}
Stripe demande automatiquement la fonctionnalité nécessaire. Si vous demandez directement cette fonctionnalité, Stripe ne créera pas le programme pour vous, et vous aurez besoin d’un programme pour créer des cartes.
Issuing et Treasury pour les plateformes
Si votre plateforme dispose déjà de comptes connectés, assurez-vous que leur configuration est prise en charge par Issuing ou Treasury pour les plateformes. Issuing prend uniquement en charge les comptes connectés qui n’utilisent pas de Dashboard hébergé par Stripe et pour lesquels votre plateforme est responsable de la collecte des exigences et de la couverture des pertes, c’est-à-dire les comptes connectés Custom. Si ce n’est pas le cas, vous devez créer de nouveaux comptes pour utiliser Issuing ou Treasury pour les plateformes. Vous pouvez voir la configuration de votre compte existant sur la page comptes connectés de votre Dashboard.
Récupérer le compte connecté
Vous pouvez également utiliser l’API pour récupérer les informations du compte et vérifier que la propriété des fonctionnalités dispose de la fonctionnalité d’Issuing requise. La fonctionnalité ne sera active que lorsque toutes les conditions seront remplies.
curl -G https://api.stripe.com/v2/core/accounts/acct_1234567890 \ -H "Authorization: Bearer" \ -H "Stripe-Version: 2025-09-30.preview" \ -d "include[0]=identity" \ -d "include[1]=configuration.card_creator"sk_test_VePHdqKTYQjKNInc7u56JBrQ
Mettre à jour un compte connecté pour solliciter une nouvelle fonctionnalité
Si vous possédez déjà un compte connecté, vous pouvez demander l’ajout de fonctionnalités card_ pour un compte connecté avec la requête suivante :
curl -X POST https://api.stripe.com/v2/core/accounts/\ -H "Authorization: Bearer{{CONNECTED_ACCOUNT_ID}}" \ -H "Stripe-Version: 2025-09-30.preview" \ --json '{ "configuration": { "card_creator": { "capabilities": { "commercial": { "stripe": { "charge_card": { "requested": true } } } } } } }'sk_test_VePHdqKTYQjKNInc7u56JBrQ
Démarrez le processus de vérification d'identité
Une fois le compte connecté créé, il est nécessaire de compléter les informations concernant le titulaire du compte. L’objet Account correspondant au compte connecté contient un hachage requirements qui recense les exigences awaiting_ pour la vérification d’identité. L’utilisateur de votre plateforme doit remplir ces informations dans le hachage requirements pour activer les fonctionnalités de son compte connecté.
Si vous créez un objet Account de test et que vous souhaitez contourner les exigences d’inscription des utilisateurs pour tester les fonctionnalités, utilisez l’API mis à jours des comptes pour fournir des valeurs de test qui répondent à toutes les exigences.
En fonction du type de l’entreprise, l’utilisateur fournit des informations détaillées sur l’entrepreneur individuel, l’entreprise, l’association à but non lucratif ou l’entité publique (Treasury pour les plateformes ne prend pas en charge les entités publiques).
Exigence de structure pour les entreprises britanniques
Un compte britannique peut activer la fonctionnalité commercial. uniquement si sa company. est private_, public_ ou incorporated_. Cette fonctionnalité ne prend pas en charge les structures de partenariat telles que incorporated_ (LLP) et unincorporated_, même si elles sont valides pour d’autres fonctionnalités associées aux comptes britanniques.
Choisissez l’une des options d’inscription des utilisateurs suivantes :
L’inscription hébergée par Stripe est un formulaire Web hébergé par Stripe qui affiche le nom, la couleur et l’icône de votre marque. L’inscription hébergée par Stripe utilise l’API Accounts pour lire les exigences et générer un formulaire d’inscription hébergée avec une validation robuste des données. Elle est localisée pour tous les pays dans lesquels Stripe est disponible.
Pour utiliser Connect Onboarding, vous devez indiquer le nom, la couleur et l’icône de votre marque dans la section Adaptation à votre marque de vos paramètres Connect.
Vous pouvez utiliser l’inscription hébergée pour permettre aux comptes connectés de lier un external_ (requis pour les virements) en l’activant via vos paramètres Connect Onboarding.
Pour créer un lien d’inscription pour un compte connecté, utilisez l’API Account Links.
curl https://api.stripe.com/v1/account_links \ -u ":" \ -d account={{CONNECTED_ACCOUNT_ID}} \ --data-urlencode "refresh_url=https://example.com/reauth" \ --data-urlencode "return_url=https://example.com/return" \ -d type=account_onboardingsk_test_VePHdqKTYQjKNInc7u56JBrQ
Mise en garde
Pour des raisons de sécurité, n’envoyez pas directement d’URL de lien de compte à votre compte connecté par e-mail, SMS ou autre. Nous vous recommandons de distribuer l’URL du lien de compte depuis l’application de votre plateforme, là où le compte de l’utilisateur est authentifié.
La réponse reçue inclut un paramètre url, dont vous pouvez fournir le lien à votre compté connecté lors de son inscription sur votre plateforme.
{ "object": "account_link", "created": 1612927106, "expires_at": 1612927406, "url": "https://connect.stripe.com/setup/s/…" }
Collecter et vérifier les informations requises
Pour activer une fonctionnalité, vous devez d’abord en faire la requête en définissant sa propriété demandée sur « true ». Cela déclenche le recouvrement des exigences de la fonctionnalité, qui est géré par votre plateforme. Les exigences peuvent concerner des documents d’identité et conformité, et données de risque. Lorsque Stripe vérifie que les exigences d’une fonctionnalité sont remplies, elle devient active.
Exigences
Les exigences, qui décrivent les informations dont Stripe a besoin pour activer les fonctionnalités du compte, peuvent inclure :
- Le type d’information
- Pourquoi Stripe a besoin de ces informations
- Si l’exigence est en retard (la date limite peut être une date ou un autre type de seuil, tel qu’un certain volume de paiements)
- Des conséquences que Stripe impose à la date limite si nous ne pouvons pas vérifier les informations à l’aide de documents acceptables, telles que la suspension de certaines fonctionnalités ou l’arrêt des virements à partir du solde du compte Stripe.
- Qui doit agir ?
En plus de toute conséquence spécifique à la fonctionnalité, si une fonctionnalité a des exigences en retard, son état devient restricted, avec un état status_ de requirements_.
Pour connaître toutes les exigences relatives aux fonctionnalités demandées pour un Account, récupérez le compte et spécifiez les requirements et les types de configuration attribués dans le paramètre include.
L’exemple suivant renvoie l’état et les exigences des fonctionnalités appartenant à la configuration card_.
curl -X POST https://api.stripe.com/v2/core/accounts/\ -H "Authorization: Bearer{{CONNECTED_ACCOUNT_ID}}" \ -H "Stripe-Version: 2025-09-30.preview" \ --json '{ "include": [ "configuration.card_creator", "requirements" ], "configuration": { "card_creator": { "capabilities": { "commercial": { "stripe": { "charge_card": { "requested": true } } } } } } }'sk_test_VePHdqKTYQjKNInc7u56JBrQ
Dans l’exemple de réponse, la fonctionnalité card_ a été demandée, mais ses exigences sont en retard :
{ "id": "{{CONNECTED_ACCOUNT}}", "object": "v2.core.account", "applied_configurations": [ "card_creator" ], "configuration": { "customer": null, "merchant": null, "recipient": null, "storer": null, "card_creator": { "capabilities": { "commercial": { "stripe": { "charge_card": { "requested": true, "status": "restricted", "status_details": [ { "code": "requirements_past_due", "resolution": "provide_info" } ] } } } } } }, "contact_email": "test@example.com", "created": "2025-06-18T00:48:16.000Z", "dashboard": "none", "identity": null, "defaults": null, "display_name": "Test Account", "metadata": {}, "requirements": { "collector": "application", "entries": [ { "awaiting_action_from": "user", "description": "identity.attestations.persons_provided.executives", "errors": [], "impact": { "restricts_capabilities": [ { "capability": "commercial.stripe.charge_card", "configuration": "card_creator", "deadline": { "status": "past_due" } } ] }, "minimum_deadline": { "status": "past_due" }, "reference": null, "requested_reasons": [ { "code": "routine_onboarding" } ] } ] }, "livemode": false }
Si la fonctionnalité est déjà active et que le compte ne satisfait pas les nouvelles exigences propres à cette fonctionnalité avant la date limite actuelle, la fonctionnalité deviendra inactive jusqu ’ à ce que les exigences soient satisfaites.
Téléchargements de documents
S’il est impossible de vérifier les informations d’un compte, Stripe peut exiger un document pour vérifier l’identité d’une personne (par exemple, un passeport) ou des informations sur l’entité juridique (par exemple, une lettre de l’administration fiscale). Pour satisfaire aux exigences relatives aux documents, les plateformes peuvent diriger l’utilisateur vers Connect Onboarding (où il sera invité à télécharger le document) ou à récupérer le document depuis le compte à l’aide d’une autre interface et le télécharger via l’API).
Identité non vérifiée dans les 29 jours suivant la demande initiale
Une fois qu’un compte a transmis toutes les informations requises pour ouvrir un compte Issuing et accepté les conditions d’utilisation du service Issuing, sa demande d’ouverture de compte est complète aux yeux de Stripe. Si nous ne pouvons pas vérifier les informations d’un compte, la fonctionnalité reste inactive jusqu’à ce que le compte fournisse des informations supplémentaires ou télécharge un document.
Si le compte reste inactive 29 jours après avoir rempli le formulaire d’inscription, vous devez envoyer au compte un avis par e-mail l’informant que nous ne pouvions pas vérifier son identité (voir le modèle).
Stripe surveille les demandes d’ouverture de compte traitées dont l’identité n’a pas été vérifiée et prend les mesures suivantes après 29 jours en mode production et après 1 heure dans lesenvironnements de test :
- Génère un avis de compte
- Efface le hachage d’acceptation des conditions d’utilisation du service afin que l’acceptation des conditions devienne une exigence en attente d’action.
Vous pouvez soumettre une nouvelle demande à tout moment en mettant à jour les informations de votre entreprise et en enregistrant une nouvelle acceptation des conditions de Issuing
Stripe vous recommande de présenter les conditions d’utilisation du service à la toute fin du processus d’onboarding des utilisateurs, pour pouvoir suivre l’avancement de la demande en vous référant à la date d’acceptation du formulaire.
Manquement aux conditions d’utilisation du service
Si Stripe identifie un compte Connect qui a enfreint ses conditions d’utilisation du service, Stripe définit la fonctionnalité Issuing sur le compte sur la valeur inactive, désactive toutes les cartes et notifie le compte (voir le modèle d’e-mail). Cela peut se produire lorsque les cartes d’un compte sont utilisées dans le cadre d’activités interdites ou limitées, telles que des activités illégales, des jeux d’argent, des armes à feu, du contenu pour adultes, des cryptomonnaies, ou dans le cadre d’activités interdites pour Issuing, telles que les dépenses de consommation, principalement l’utilisation internationale, le prêt ou toute autre utilisation abusive ou non conforme.
Comptes inactifs depuis plus de 395 jours
Stripe désactive Issuing sur les comptes qui n’ont complété aucune transaction par carte bancaire lors des 13 mois précédents (395 jours). Sur les comptes dotés de fonctionnalités supplémentaires, Stripe désactive Issuing seulement en cas d’absence de paiements ou de transaction de Treasury pour les plateformes lors des 395 jours précédents et si le solde du compte financier est égal ou inférieur à 9,99 USD.
Lorsque Issuing est désactivé pour cause d’inactivité,le statut de la fonctionnalité card_creator du compte Connect est défini sur restricted.
En savoir plus sur la gestion des comptes inactifs avec Issuing.
Webhooks
Lorsque l’état des fonctionnalités demandées change pour un compte connecté, vous recevez un webhook v2. confirmant le changement :
{ "created": "2025-06-18T02:08:15.025Z", "id": "evt_test_321", "object": "v2.core.event", "type": "v2.core.account[configuration.card_creator].capability_status_updated", "data": { "updated_capability": "commercial.stripe.charge_card" }, "related_object": { "id": "acct_123", "type": "v2.core.account", "url": "/v2/core/accounts/{{CONNECTED_ACCOUNT}}?include=configuration.card_creator" }, "changes": ..., ... }
Créer des cartes et des titulaires de carte
Un objet Cardholder représente la personne physique ou morale pour laquelle vous émettez des cartes. Pour émettre une carte virtuelle ou physique, chaque titulaire de carte doit être associé à un compte connecté. Un compte connecté peut avoir plusieurs titulaires de carte.
En savoir plus sur les cartes et titulaires de carte.
Ajout de fonds
La carte bancaire peut utiliser les fonds du solde Issuing ou du solde du compte financier en fonction de sa configuration.
Utiliser le solde Issuing
Le solde Issuing est distinct du solde principal du compte connecté. Lorsque des cartes émises sont utilisées pour effectuer des transactions, les fonds correspondant sont prélevés sur le solde Issuing.
Pour effectuer des transactions avec une carte émise, vous devez d’abord affecter des fonds au solde Issuing du compte connecté associé à cette carte bancaire. Le solde Issuing contient les fonds réservés à une carte bancaire, et permet de séparer en toute sécurité ces fonds de vos bénéfices, Payouts et fonds relevant d’autres produits Stripe. Découvrez comment alimenter des comptes connectés pour Issuing.
Utiliser le Dashboard pour Issuing avec Connect
Affichez les comptes connectés sur votre plateforme et créez de nouveaux comptes à partir de la page comptes connectés du Dashboard. Un compte peut apparaître comme restricted dans le Dashboard si les exigences sont past_ pour l’une des fonctionnalités demandées.
Vous pouvez également effectuer les actions suivantes depuis le Dashboard :
- Afficher l’activité d’un compte sélectionné.
- Modifier les informations professionnelles et personnelles d’un compte sélectionné.
- Créez des titulaire de la carte, des cartes ou des autorisations de test sur le compte. Pour ce faire, consultez les informations du compte connecté, puis accédez à la fonctionnalité émission de cartes.
- Affichez les détails du programme pour un compte sélectionné. Suivez les étapes ci-dessus pour Afficher le Dashboard sous le nom de (nom du compte), accédez à Paramètres, la section émission, puis cliquez sur Programmes de carte bancaire.
Vous pouvez également accéder directement à la page Issuing d’un compte connecté en saisissant l’URL et en remplaçant {{CONNECT_ par la valeur appropriée : https://dashboard.
En tant que plateforme, seul vous pouvez consulter le Dashboard au nom de vos comptes connectés. Vos comptes connectés n’auront pas de nom d’utilisateur ou de mot de passe Stripe, et n’auront pas accès au Dashboard.