Créer des cartes virtuelles

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.

curl https://api.stripe.com/v1/issuing/cardholders \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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 à 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 avant d’activer une carte bancaire pour ce titulaire de la carte. Consultez les contrats requis pour Issuing et Financial Accounts pour les plateformes pour plus d’informations sur les contrats que vous devez présenter aux titulaires de compte et de carte.

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

{
  "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 https://api.stripe.com/v1/issuing/cardholders/
{{CARDHOLDER_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 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.

curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d cardholder=
"{{CARDHOLDER_ID}}" \
  -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.

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.

Définir une expiration personnalisée

Lors de la création de la carte, définissez l’année (exp_year) et le mois (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.