# 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. # grâce à l'API ; 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`.