Créer des cartes virtuelles

Créez un titulaire de carte et émettez une carte virtuelle.

Vous pouvez utiliser le Dashboard ou l’endpoint Create a card 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 ou l’API Cardholders pour créer un titulaire de carte.

L’objet Titulaire de carte représente une personne physique ou morale à laquelle vous pouvez émettre des cartes. Créez un Cardholder avec un nom à afficher sur les cartes et l’adresse de facturation. 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. Vous pouvez également spécifier des preferred_locales de façon à personnaliser la langue du titulaire de la carte pour des fonctionnalités telles que 3D Secure.

Stripe renvoie un objet Cardholder qui contient les informations que vous avez fournies et envoie l’événement webhook issuing_cardholder.created.

Conditions nécessaires pour un titulaire de carte de type « particulier »

Le type de titulaire de carte est défini sur individual par défaut, mais vous pouvez définir le type sur company si vous le souhaitez.

Vous devez donner une valeur de prénom et de nom pour les particuliers titulaires de carte ; Stripe les contrôle alors conformément à la réglementation. Si possible, indiquez également une date de naissance, car cela permet de possiblement réduire les vérifications des listes de surveillance.

Accepter les conditions applicables aux utilisateurs autorisés

Si vous émettez des cartes pour des particuliers dans le cadre de programmes couverts par la Celtic Bank, vous devez enregistrer le consentement du futur titulaire aux Conditions applicables aux utilisateurs autorisés par la Celtic Bank avant d’activer sa carte. Pour en savoir plus sur les contrats que vous devez présenter aux titulaires de compte et de carte, veuillez consulter les Contrats requis pour les produits Issuing et Treasury.

Le cas échéant, Stripe vous avertit de cette exigence dans la propriété requirements de l’objet Cardholder :

{
  "id": "ich_1MGlTC2eZvKYlo2CJnowP9Z5",
  "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.

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

Stripe renvoie un objet Card lors de la création et envoie l’événement webhook issuing_card.created.

Activer la carte

For authorizations to be approved on a card, its status must be set to active. Past-due requirements block card activation.

Activate on creation

You can activate the card when creating it using the Dashboard or the API. In the Dashboard, when creating a card, click Activate card. Using the API, set status to active when using the create card endpoint.

Activate after creation

Alternatively, after creating an inactive card, you can activate it using the Dashboard or the API. To activate it using the Dashboard, select the card you want to activate, then click Activate card. To activate it using the API, use the update card endpoint to set its status to active.

Re-activate after blocking

In some cases, multiple incorrect PIN attempts on a transaction deactivates a card, preventing further authorizations. To reactivate the card, use the Dashboard or the update card API to set the card’s status to active.