Créer des cartes virtuelles avec l'API

L’objet Cardholder représente une personne physique ou morale pour laquelle vous pouvez émettre des cartes. Créez un objet Cardholder en renseignant un nom à afficher sur la carte et une adresse de facturation, le plus souvent requise lorsque le titulaire de la carte effectue des achats en ligne. Il s’agit habituellement de l’adresse de l’entreprise du compte connecté ou de la 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 portefeuilles électroniques. Vous pouvez également spécifier des preferred_locales afin de personnaliser la langue du titulaire de la carte pour des fonctionnalités telles que 3D Secure.

curl https://api.stripe.com/v1/issuing/cardholders \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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 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 (ce n’est pas obligatoire pour les titulaires de carte de type company), 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.

curl https://api.stripe.com/v1/issuing/cardholders/ich_1MGlTC2eZvKYlo2CJnowP9Z5 \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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éez un objet Card attribuez-le au titulaire de carte. Cette requête contient l’ID de l’objet Cardholder ainsi que l’attribut currency et le type de carte virtual.

curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d cardholder=ich_1MGlTC2eZvKYlo2CJnowP9Z5 \
  -d currency=usd \
  -d type=virtual

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

Pour que les autorisations sur une carte soient approuvées, son status doit être défini sur active. Veuillez noter que les exigences non satisfaites bloquent l’activation des cartes.

Activer la carte à sa création

La carte peut être activée au moment de sa création via le Dashboard ou l’API. Sur le Dashboard, lors de la création de la carte, cliquez sur Activer la carte. À l’aide de l’API, définissez son status sur active lorsque vous utilisez l’endpoint Create 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 concernée, puis cliquez sur Activer la carte. Pour l’activer avec l’API, utilisez l’endpoint Update card afin de définir son status sur active.

curl https://api.stripe.com/v1/issuing/cards/ic_1Cm3paIyNTgGDVfzBqq1uqxR \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d status=active

Réactiver une carte bancaire après blocage

Dans certains cas, plusieurs tentatives de saisie incorrecte du code PIN dans le cadre d’une transaction désactivent une carte, empêchant ainsi toute nouvelle autorisation. Pour réactiver la carte, utilisez le Dashboard ou l’API Update Card et définissez le status de la carte sur active.