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

Pour que les autorisations sur une carte soient approuvées, son status doit être défini sur active. Les exigences 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.

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 afin de définir son status sur 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 afin de définir le status de la carte sur active.