Fonctionnement des cartes Stripe Issuing

Demandez la fonctionnalité card_issuing pour les comptes connectés de votre plateforme et fournissez les informations requises pour l’inscription.

curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "capabilities[treasury][requested]"=true \
  -d "capabilities[card_issuing][requested]"=true \
  -d "capabilities[transfers][requested]"=true

Sauf échec de l’opération, la réponse renvoie l’objet Account. Le hachage capabilities répertorie les fonctionnalités demandées comme active.

Si ce n’est pas encore fait, demandez également l’accès à la fonctionnalité card_issuing pour le compte financier.

curl https://api.stripe.com/v1/treasury/financial_accounts/
{{FINANCIAL_ACCOUNT_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "treasury[access][requested]"=true \
  -d "card_issuing[access][requested]"=true

Sauf échec de l’opération, la réponse renvoie l’objet FinancialAccount avec les fonctionnalités présentes dans le tableau active_features ou pending_features.

Une fois la fonctionnalité card_issuing activée, les marchands et les fournisseurs de services propriétaires d’un compte connecté sur votre plateforme peuvent créer des titulaires de cartes et des cartes. Vous ne pouvez émettre des cartes que via l’API.

Un objet Cardholder représente une entité (particulier ou entreprise) pour laquelle des cartes peuvent être émises. Pour commencer, créez un Cardholder en renseignant le nom, les informations de facturation et en précisant s’il s’agit d’un individual ou d’une company.

curl https://api.stripe.com/v1/issuing/cardholders \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d name="Jenny Rosen" \
  --data-urlencode email="jenny.rosen@example.com" \
  --data-urlencode 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]"="1234 Main Street" \
  -d "billing[address][city]"="San Francisco" \
  -d "billing[address][state]"=CA \
  -d "billing[address][postal_code]"=94111 \
  -d "billing[address][country]"=US

Sauf échec de l’opération, la réponse renvoie le nouvel objet Cardholder.

Créez un objet Card et affectez-le au Cardholder que vous venez de créer et à un compte financier. Pour affecter le titulaire de la carte et le compte financier, indiquez l’ID du titulaire dans le paramètre cardholder et l’ID du compte financier dans le paramètre financial_account de la requête /v1/issuing/cards.

curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d cardholder={{CARDHOLDER_ID}} \
  -d financial_account=
{{FINANCIAL_ACCOUNT_ID}} \
  -d currency=usd \
  -d type=virtual \
  -d status=active

Sauf échec de l’opération, la réponse renvoie le nouvel objet Card.

Pour gérer les autorisations en bonne et due forme, consultez le guide consacré aux autorisations Issuing.

Créer des autorisations de test

Vous pouvez tester les cartes que vous venez d’émettre en suivant les étapes de la section Tests Issuing pour simuler des achats.

Si le compte financier associé à la carte émise présente des restrictions pour les outbound_flows, les autorisations sur la carte ne sont pas accordées.

Pour en savoir plus sur les différents types de transactions que vous pourriez tester, consultez le guide consacré aux transactions Issuing.

Pour en savoir plus sur la gestion des remboursements et des captures, consultez le guide consacré aux transactions Issuing.

Pour comprendre comment gérer des litiges en bonne et due forme, consultez le guide consacré aux litiges Issuing.