Comptes connectés, cartes et titulaires de carte
Découvrez comment créer et gérer des cartes et titulaires de carte avec Stripe Connect.
Les comptes connectés représentent des entités commerciales. Les titulaires de carte représentent les personnes associées à ces entités commerciales. Un compte connecté peut avoir plusieurs titulaires de carte. Par exemple, un compte connecté appartenant à une petite entreprise peut disposer de plusieurs titulaires de carte pour le propriétaire et les employés. Une fois le titulaire de carte créé, vous pouvez émettre une carte virtuelle ou physique pour ce titulaire.
Créer des titulaires de carte
Pour créer un objet Cardholder, utilisez l’API Cardholders et fournissez les informations requises. L’utilisation de portefeuilles électroniques nécessite un numéro de téléphone et une adresse e-mail valides, mais ces informations sont facultatives pour les cartes physiques.
Remarque
En tant que plateforme Connect, vous effectuez des appels à l’API au nom de vos comptes connectés en incluant l’ID du compte connecté dans l’en-tête Stripe-Account.
| Champ | Paramètre | Description |
|---|---|---|
| Informations de facturation | billing | L’adresse de facturation du titulaire de la carte (généralement l’adresse principale de l’entreprise). Vous ne pouvez pas utiliser une boîte postale, une boîte « highway contract »ou une adresse de boîte aux lettres privée (en revanche, vous pouvez les utiliser comme adresse de livraison des cartes). |
| Type | type | Indique si le titulaire de la carte est de type company ou individual. Consultez la page Choisir un type de titulaire de carte pour obtenir des conseils. for guidance. |
| Numéro de téléphone | phone_ | Obligatoire pour les portefeuilles numériques |
email | Adresse e-mail du titulaire de la carte. Obligatoire pour les portefeuilles numériques |
Stripe renvoie un objet Cardholder qui contient les informations que vous avez fournies et envoie l’événement webhook issuing_.
En vertu des dispositions légales et réglementaires applicables, Stripe est tenue de contrôler l’identité des titulaires de carte. Les autorisations peuvent donc être bloquées en fonction des attributs des titulaires de carte. En savoir plus sur la vérification des listes de surveillance.
Après avoir créé un objet Cardholder, appelez l’endpoint de modification de titulaire de carte en précisant les paramètres à modifier. Un objet Cardholder mis à jour est renvoyé à la réussite de l’appel.
Les titulaires de carte sont à l’état active par défaut, ce qui signifie que toute carte associée à un titulaire de carte peut approuver des autorisations. Vous pouvez modifier le titulaire de la carte pour faire passer son paramètre status à inactive. Si un titulaire de carte est à l’état inactif, les autorisations de toutes ses cartes seront refusées pour le motif cardholder_ (titulaire inactif).
Créer des cartes
Après avoir créé un Cardholder, émettez une carte pour ce titulaire à l’aide de l’API Cards.
Un objet Card représente une carte physique ou virtuelle. Pour créer une carte physique, vous devrez préciser une adresse de livraison. Vous pouvez également fournir des arguments supplémentaires pour préciser l’emballage et le service de livraison souhaités.
| Titulaire de la carte | cardholder | ID du titulaire de carte |
|---|---|---|
| Devise | currency | Code ISO à trois lettres de la devise, en minuscules. Les devises prises en charge sont usd aux États-Unis, gbp au Royaume-Uni et eur dans les pays de la zone euro. |
| Type | type | Peut être physical ou virtual |
L’appel suivant illustre une émission de carte virtuelle associée au titulaire de carte spécifié :
Stripe renvoie un objet Card lors de la création et envoie l’événement webhook issuing_.
Activer des cartes
Pour que des autorisations soient approuvées, les cartes doivent d’abord être activées.
Si vous n’indiquez pas d’état lors de la création de la carte, celle-ci sera par défaut à l’état inactive. Une carte reste inactive tant que son état n’a pas été modifié via l’endpoint de modification de carte.
Pour activer une carte :
Désactiver des cartes
Vous pouvez désactiver les cartes en assignant au paramètre status la valeur inactive à l’aide de l’endpoint de modification de carte. Cela signifie que vous ne pouvez pas approuver de nouvelles autorisations pour cette carte, mais vous pouvez toujours approuver les autorisations qui ont été ouvertes sur la carte avant que son état ne passe à inactive. Pour approuver de nouvelles autorisations, vous devez faire passer l’état de la carte à active.
En savoir plus sur la gestion des autorisations.
Annuler des cartes
Vous pouvez annuler une carte en la faisant passer à l’état canceled (annulée) à l’aide de l’endpoint de modification de carte. L’annulation d’une carte est irréversible. Si une carte est à l’état canceled, vous ne pourrez pas approuver de nouvelles autorisations pour cette carte, mais vous pourrez approuver les autorisations qui ont été ouvertes sur la carte avant que son état ne passe à canceled.
Liste des titulaires de carte
Vous pouvez consulter les titulaires de carte associés à un compte connecté en envoyant une requête GET à l’API Cardholders et en indiquant le Stripe-Account concerné dans l’en-tête.
Sauf échec de l’opération, la réponse renvoie la liste des titulaires de carte :
{ "object": "list", "data": [ { "id": "ich_1234a", "object": "issuing.cardholder", "billing": { "address": { "city": "San Francisco", "country": "US", "line1": "510 Townsend Street", "line2": null, "postal_code": "94111", "state": "CA" } }, "company": null, "created": 1657144326, "email": "jenny.rosen@example.com", "individual": null, "livemode": false, "metadata": {}, "name": "Jenny Rosen", "phone_number": "+18008675309", "requirements": { "disabled_reason": null, "past_due": [] }, "spending_controls": { "allowed_categories": [], "blocked_categories": [], "spending_limits": [], "spending_limits_currency": null }, "status": "active", "type": "individual" }, { "id": "ich_1234b", "object": "issuing.cardholder", "billing": { "address": { "city": "San Francisco", "country": "US", "line1": "510 Townsend Street", "line2": null, "postal_code": "94111", "state": "CA" } }, "company": null, "created": 1656537695, "email": "jenny.rosen@example.com", "individual": null, "livemode": false, "metadata": {}, "name": "Jenny Rosen", "phone_number": "+18008675309", "requirements": { "disabled_reason": null, "past_due": [] }, "spending_controls": { "allowed_categories": [], "blocked_categories": [], "spending_limits": [], "spending_limits_currency": null }, "status": "active", "type": "individual" } ], "has_more": false, "url": "/v1/issuing/cardholders" }
Liste des cartes
Vous pouvez également afficher la liste des cartes créées sur un compte connecté en envoyant une requête GET à l’API Cards et en indiquant le Stripe-Account concerné dans l’en-tête.
Sauf échec de l’opération, la réponse renvoie la liste des cartes :
{ "object": "list", "data": [ { "id": "ic_1234a", "object": "issuing.card", "brand": "Visa", "cancellation_reason": null, "cardholder": { "id": "ich_1234a", "object": "issuing.cardholder", "billing": { "address": { "city": "San Francisco", "country": "US", "line1": "510 Townsend Street", "line2": null, "postal_code": "94111", "state": "CA" } }, "company": null, "created": 1656537695, "email": "jenny.rosen@example.com", "individual": null, "livemode": false, "metadata": {}, "name": "Jenny Rosen", "phone_number": "+18008675309", "requirements": { "disabled_reason": null, "past_due": [] }, "spending_controls": { "allowed_categories": [], "blocked_categories": [], "spending_limits": [], "spending_limits_currency": null }, "status": "active", "type": "individual" }, "created": 1656537950, "currency": "usd", "exp_month": 5, "exp_year": 2025, "last4": "0021", "livemode": false, "metadata": {}, "pin": null, "replaced_by": null, "replacement_for": null, "replacement_reason": null, "shipping": null, "spending_controls": { "allowed_categories": [ "car_rental_agencies" ], "blocked_categories": null, "spending_limits": [ { "amount": 8000, "categories": [], "interval": "per_authorization" } ], "spending_limits_currency": "usd" }, "status": "active", "type": "virtual", "wallets": { "apple_pay": { "eligible": true, "ineligible_reason": null }, "google_pay": { "eligible": true, "ineligible_reason": null }, "primary_account_identifier": null } }, { "id": "ic_1234b", "object": "issuing.card", "brand": "Visa", "cancellation_reason": null, "cardholder": { "id": "ich_1234a", "object": "issuing.cardholder", "billing": { "address": { "city": "San Francisco", "country": "US", "line1": "510 Townsend Street", "line2": null, "postal_code": "94111", "state": "CA" } }, "company": null, "created": 1656537695, "email": "jenny.rosen@example.com", "individual": null, "livemode": false, "metadata": {}, "name": "Jenny Rosen", "phone_number": "+18008675309", "requirements": { "disabled_reason": null, "past_due": [] }, "spending_controls": { "allowed_categories": [], "blocked_categories": [], "spending_limits": [], "spending_limits_currency": null }, "status": "active", "type": "individual" }, "created": 1656537947, "currency": "usd", "exp_month": 5, "exp_year": 2025, "last4": "0013", "livemode": false, "metadata": {}, "pin": null, "replaced_by": null, "replacement_for": null, "replacement_reason": null, "shipping": null, "spending_controls": { "allowed_categories": null, "blocked_categories": null, "spending_limits": [ { "amount": 50000, "categories": [], "interval": "daily" } ], "spending_limits_currency": "usd" }, "status": "active", "type": "virtual", "wallets": { "apple_pay": { "eligible": true, "ineligible_reason": null }, "google_pay": { "eligible": true, "ineligible_reason": null }, "primary_account_identifier": null } } ], "has_more": false, "url": "/v1/issuing/cards" }
Vous pouvez consulter la liste des cartes associées à un titulaire de carte spécifique en incluant le paramètre cardholder dans votre requête GET à l’API Cards. Précisez le Stripe-Account concerné dans l’en-tête et l’ID du titulaire de la carte dans le paramètre cardholder.