# Créer des cartes virtuelles Créez un titulaire de carte et émettez une carte virtuelle. Vous pouvez utiliser le [Dashboard](https://dashboard.stripe.com/issuing/cards) ou l’endpoint [Create a card](https://docs.stripe.com/api/issuing/cards.md) pour émettre des cartes virtuelles aux titulaires de carte, qui peuvent les utiliser immédiatement après leur création. ## Créer un titulaire de carte Vous pouvez utiliser le [Dashboard](https://dashboard.stripe.com/issuing/cardholders) ou l’[API Cardholders](https://docs.stripe.com/api/issuing/cardholders.md) pour créer un titulaire de carte. > Pour les programmes de cartes bancaires destinées aux consommateurs adossées à des stablecoins, Bridge gère la création des titulaires de carte bancaire et la vérification d’identité. Consultez la [documentation Bridge](https://apidocs.bridge.xyz/platform/cards/overview/kyc) pour plus de détails. # Dashboard > This is a Dashboard for when testing-method is without-code. View the full page at https://docs.stripe.com/issuing/cards/virtual/issue-cards?testing-method=without-code. 1. Accédez à l’[onglet Titulaires de carte](https://dashboard.stripe.com/issuing/cardholders) dans le Dashboard Issuing. ![Page des titulaires de carte Issuing](https://b.stripecdn.com/docs-statics-srv/assets/cardholders-page.636c014a4cc28707df5118006f76eb6c.png) 1. Cliquez sur **Créer un titulaire de carte** en haut à droite. 1. Sélectionnez le type de titulaire de carte : particulier ou entreprise. Le nom du titulaire de la carte et le nom de l’entreprise sont tous deux limités à 24 caractères. Ils peuvent être composés de caractères alphanumériques ainsi que des caractères `/ -&:().'`. ![Champs de type et de nom du formulaire de titulaire de carte Issuing](https://b.stripecdn.com/docs-statics-srv/assets/cardholder-form-type-name.580d1c848e5cd8c4cf4af9d50fac3d27.png) 1. Ajoutez une adresse de facturation. ![Champs d’adresse de facturation du formulaire de titulaire de carte Issuing](https://b.stripecdn.com/docs-statics-srv/assets/cardholder-form-billing-address.889782c18b84111b57f0fd8152ebb4ad.png) 1. Si vous créez une carte d’entreprise, ajoutez le numéro fiscal. 1. Ajoutez des coordonnées, qui sont obligatoires pour certaines fonctionnalités comme les wallets. ![Champs coordonnées du formulaire de titulaire de la carte Issuing](https://b.stripecdn.com/docs-statics-srv/assets/cardholder-form-contact-information.389c419fa3ab62f8df53ed06084b20ff.png) 1. Cliquez sur **Créer un titulaire de carte**. ### Conditions nécessaires pour un titulaire de carte de type « particulier » Lorsque vous sélectionnez le type de titulaire de carte, vous devez ajouter le prénom et le nom du titulaire ainsi que sa [date de naissance](https://docs.stripe.com/api/issuing/cardholders/create.md#create_issuing_cardholder-individual-dob). Vous pouvez également charger une [pièce d’identité officielle](https://docs.stripe.com/api/issuing/cardholders/create.md#create_issuing_cardholder-individual-verification), ce qui contribuera peut-être à réduire le nombre de [vérifications des listes de surveillances](https://support.stripe.com/questions/issuing-watchlist-reviews). ![Champs de vérification de l’identité du formulaire de titulaire de carte Issuing](https://b.stripecdn.com/docs-statics-srv/assets/cardholder-form-identity-fields.ac65dc239b5c14e3eb85e550d23b8f34.png) Si vous émettez des cartes bancaires à des particuliers pour des programmes pris en charge par Cross River Bank ou Fifth Third Bank, vous devez enregistrer l’acceptation des conditions d’utilisation applicables avant d’[activer](https://docs.stripe.com/issuing/cards/physical/issue-cards.md?testing-method=without-code#activate-the-card) une carte pour ce titulaire. - [Conditions d’utilisation pour les utilisateurs autorisés de Cross River Bank](https://stripe.com/legal/issuing/crb-authorized-user-terms) - [Conditions d’utilisation pour les utilisateurs autorisés de Fifth Third Bank](https://stripe.com/legal/issuing/fifth-third-authorized-user-terms). Consultez la section [Accords requis pour Issuing et Treasury pour les plateformes](https://docs.stripe.com/issuing/compliance-us.md) pour plus d’informations sur les accords que vous devez présenter aux titulaires de compte et aux titulaires de carte. ### Exigences relatives aux titulaires de carte de type entreprise Lorsque vous ajoutez un nom d’entreprise, assurez-vous qu’il comporte au moins deux mots, par exemple : Stripe Inc. ## Créer une carte bancaire Vous pouvez utiliser le [Dashboard](https://dashboard.stripe.com/issuing/cards) pour créer une carte. 1. Accédez à [l’onglet Cartes](https://dashboard.stripe.com/issuing/cards) du Dashboard Issuing. ![Page des cartes Issuing](https://b.stripecdn.com/docs-statics-srv/assets/cards-page.e8e9728de4c5cbf6bf3b557dc634ed56.png) 1. Cliquez sur **Créer une carte** en haut à droite. 1. Recherchez le titulaire de carte que vous avez créé dans [Créer un titulaire de carte](https://docs.stripe.com/issuing/cards/virtual/issue-cards.md#create-cardholder). 1. Sélectionnez le type **Virtuel**. 1. Sélectionnez **Activer la carte**. ![Créer un volet de carte virtuelle](https://b.stripecdn.com/docs-statics-srv/assets/create-virtual-card.c049ecd7b3aa31853fb43d870c9680ad.png) 1. Cliquez sur **Créer**. # grâce à l'API ; > This is a grâce à l'API ; for when testing-method is with-code. View the full page at https://docs.stripe.com/issuing/cards/virtual/issue-cards?testing-method=with-code. L’objet [Titulaire de carte](https://docs.stripe.com/api/.md#issuing_cardholder_object) représente une personne physique ou morale à laquelle vous pouvez émettre des cartes. Créez un `Cardholder` avec un [nom](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-name) à afficher sur les cartes et l’adresse de [facturation](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-billing). L’adresse de facturation est souvent demandée lorsque le titulaire de la carte effectue des achats en ligne. Il s’agit généralement de l’adresse professionnelle du compte connecté ou de votre plateforme. Lorsque vous créez un titulaire de carte, ou que vous le mettez à jour ultérieurement, vous pouvez inclure des informations supplémentaires, telles qu’un numéro de téléphone (`phone_number`) ou une adresse e-mail (`email`), qui sont requises pour certaines fonctionnalités, comme les [wallets](https://docs.stripe.com/issuing/cards/digital-wallets.md). Vous pouvez également spécifier des [preferred_locales](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-preferred_locales) de façon à personnaliser la langue du titulaire de la carte pour des fonctionnalités telles que [3D Secure](https://docs.stripe.com/issuing/3d-secure.md). #### curl ```bash curl https://api.stripe.com/v1/issuing/cardholders \ -u <>: \ -d "name"="Jenny Rosen" \ -d "email"="jenny.rosen@example.com" \ -d "phone_number"="+18008675309" \ -d "status"="active" \ -d "type"="individual" \ -d "individual[first_name]"="Jenny" \ -d "individual[last_name]"="Rosen" \ -d "individual[dob][day]"=1 \ -d "individual[dob][month]"=11 \ -d "individual[dob][year]"=1981 \ -d "billing[address][line1]"="123 Main Street" \ -d "billing[address][city]"="San Francisco" \ -d "billing[address][state]"="CA" \ -d "billing[address][postal_code]"="94111" \ -d "billing[address][country]"="US" ``` Stripe renvoie un objet `Cardholder` qui contient les informations que vous avez fournies et envoie l’événement [webhook](https://docs.stripe.com/webhooks.md) `issuing_cardholder.created`. ### Conditions nécessaires pour un titulaire de carte de type « particulier » Le [type](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-type) de titulaire de carte est défini sur `individual` par défaut, mais vous pouvez [définir le type](https://docs.stripe.com/issuing/other/choose-cardholder.md) sur `company` si vous le souhaitez. Vous devez donner une valeur de prénom et de [nom](https://docs.stripe.com/api/issuing/cardholders/create.md#create_issuing_cardholder-individual-last_name) pour les particuliers titulaires de carte ; Stripe les contrôle alors conformément à la réglementation. Si possible, indiquez également une [date de naissance](https://docs.stripe.com/api/issuing/cardholders/create.md#create_issuing_cardholder-individual-dob), car cela permet de possiblement réduire les [vérifications des listes de surveillance](https://support.stripe.com/questions/issuing-watchlist-reviews). ### Accepter les conditions applicables aux utilisateurs autorisés Si vous émettez des cartes bancaires à des particuliers pour des programmes soutenus par Celtic Bank, vous devez enregistrer l’acceptation des [conditions d’utilisation pour les utilisateurs autorisés de Celtic Bank](https://stripe.com/legal/issuing/celtic-authorized-user-terms) avant d’[activer](https://docs.stripe.com/issuing/cards/virtual/issue-cards.md#activate-the-card) une carte bancaire pour ce titulaire de la carte bancaire. Consultez les [contrats requis pour Issuing et Treasury pour les plateformes](https://docs.stripe.com/issuing/compliance-us.md#issuing-terms) pour plus d’informations sur les contrats que vous devez présenter aux titulaires de compte et de carte bancaire. Le cas échéant, Stripe vous avertit de cette exigence dans la propriété `requirements` de l’objet `Cardholder` : ```json { "id": "{{CARDHOLDER_ID}}", "name": "Jenny Rosen", ... "requirements": { "disabled_reason": "requirements.past_due", "past_due": [ "individual.card_issuing.user_terms_acceptance.date", "individual.card_issuing.user_terms_acceptance.ip" ] } ... } ``` Vous pouvez accepter les conditions au nom du `Cardholder` en transmettant l’horodatage Unix de la date à laquelle le titulaire de la carte a accepté les conditions, ainsi que son adresse IP. ```curl curl https://api.stripe.com/v1/issuing/cardholders/{{ISSUINGCARDHOLDER_ID}} \ -u "<>:" \ -d "individual[card_issuing][user_terms_acceptance][date]=1470266163" \ -d "individual[card_issuing][user_terms_acceptance][ip]=91.121.146.224" ``` Lorsque les conditions d’activation sont remplies (par exemple, vous avez fourni les nom et prénom de l’utilisateur ainsi que la preuve d’acceptation des conditions d’utilisation), vous pouvez activer des cartes pour le titulaire concerné. ## Créer une carte bancaire Créez un objet [Card](https://docs.stripe.com/api.md#issuing_card_object) et attribuez-le au titulaire de la carte. Cette requête contient l’ID de l’objet `Cardholder`, `currency`, et `virtual` pour le type de carte. #### Issuing uniquement ```curl curl https://api.stripe.com/v1/issuing/cards \ -u "<>:" \ -d "cardholder={{ISSUINGCARDHOLDER_ID}}" \ -d currency=usd \ -d type=virtual ``` #### Issuing avec Treasury pour les plateformes Pour créer une carte bancaire qui prélève des fonds sur un [FinancialAccount](https://docs.stripe.com/api/treasury/financial_accounts.md), transmettez le paramètre `financial_account` dans la requête. ```curl curl https://api.stripe.com/v1/issuing/cards \ -u "<>:" \ -d "cardholder={{ISSUINGCARDHOLDER_ID}}" \ -d financial_account=fa_1KsZDkACgxNDEoMCVZko5z5F \ -d currency=usd \ -d type=virtual ``` Stripe renvoie un objet `Card` lors de la création et envoie l’événement [webhook](https://docs.stripe.com/webhooks.md) `issuing_card.created`. ### Date d’expiration Les cartes virtuelles ont par défaut une date d’expiration fixée à 3 ans, variable de manière aléatoire jusqu’à 3 mois pour des raisons de sécurité. Cette date d’expiration peut se situer entre 2 ans et 9 mois et 3 ans et 3 mois après l’émission. > Lors de l’émission d’une [carte de remplacement](https://docs.stripe.com/issuing/cards/replacements.md), nous définissons une date d’expiration différente afin d’éviter la délivrance de deux cartes identiques. #### Définir une expiration personnalisée Lors de la création de la carte, définissez l’année [(exp_year)](https://docs.stripe.com/api/issuing/cards/create.md#create_issuing_card-exp_year) et le mois [(exp_month)](https://docs.stripe.com/api/issuing/cards/create.md#create_issuing_card-exp_month) d’expiration afin de contrôler sa date d’expiration. Cette date doit être comprise entre un mois et cinq ans. Par exemple, si la date d’expiration est avril 2024, définissez-la entre mai 2024 et mars 2029 inclus. > Vous devez spécifier à nouveau la date d’expiration souhaitée lors de l’émission d’une [carte de remplacement](https://docs.stripe.com/issuing/cards/replacements.md), sinon la nouvelle carte pourrait revenir à la date d’expiration par défaut. ## Activer la carte Pour que les [autorisations](https://docs.stripe.com/issuing/purchases/authorizations.md) sur une carte soient approuvées, son `status` doit être défini sur `active`. Les [exigences](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-requirements-past_due) non satisfaites bloquent l’activation des cartes. ### Activer la carte à sa création Vous pouvez activer la carte lors de sa création à l’aide du Dashboard ou de l’API. Dans le Dashboard, lors de la création d’une carte, cliquez sur **Activer la carte**. À l’aide du API, définissez `status` sur `active` lorsque vous utilisez l’endpoint de [création de carte](https://docs.stripe.com/api/.md#create_issuing_card). ### Activer la carte après sa création Vous pouvez également créer une carte inactive, puis l’activer dans un second temps à l’aide du Dashboard ou de l’API. Pour l’activer à l’aide du Dashboard, sélectionnez la carte que vous souhaitez activer, puis cliquez sur **Activer la carte**. Pour l’activer à l’aide du API, utilisez l’endpoint de [mise à jour de carte](https://docs.stripe.com/api.md#update_issuing_card) afin de définir son `status` sur `active`. ```curl curl https://api.stripe.com/v1/issuing/cards/{{ISSUINGCARD_ID}} \ -u "<>:" \ -d status=active ``` ### Réactiver une carte bancaire après blocage Dans certains cas, plusieurs tentatives incorrectes de code PIN pour une transaction désactivent une carte, empêchant ainsi toute nouvelle autorisation. Pour réactiver la carte, utilisez le Dashboard ou l’API de [mise à jour de carte](https://docs.stripe.com/api.md#update_issuing_card) afin de définir le `status` de la carte sur `active`.