Guide d'intégration de paiements B2B

Pour utiliser vos cartes, vous devez ajouter des fonds au solde Issuing de votre compte. Ce solde représente les fonds réservés pour Issuing et est totalement distinct de vos gains, de vos virements et de vos fonds provenant d’autres produits Stripe.

Vous pouvez ajouter des fonds depuis votre Dashboard ou à l’aide de l’endpoint de création de recharge.

curl https://api.stripe.com/v1/topups \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d destination_balance=issuing \
  -d amount=2000 \
  -d currency=usd \
  -d description="Top-up for Issuing, 21 décembre 2024" \
  -d statement_descriptor=Top-up

Créer un titulaire de carte

Le titulaire de la carte est l’entreprise ou l’entité commerciale autorisée à utiliser les fonds de la carte à partir du solde Issuing. L’objet Cardholder comprend des informations pertinentes, telles que le nom à afficher sur les cartes et une adresse de facturation, qui est généralement l’adresse de l’entreprise.

L’appel à l’API suivant crée un nouvel objet Cardholder :

curl https://api.stripe.com/v1/issuing/cardholders \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d name="Company Card" \
  --data-urlencode email="company@example.com" \
  --data-urlencode phone_number="+18008675309" \
  -d status=active \
  -d type=company \
  -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 de webhook issuing_cardholder.created.

Créer une carte

Créez une carte et associez-la à l’objet Cardholder que vous souhaitez définir comme utilisateur autorisé de la carte.

Dans les exemples suivants, nous vous montrons comment créer une carte virtuelle. Vous pouvez toutefois créer des cartes physiques et les envoyer à leurs titulaires en mode production.

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

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

{
  "id": "ic_1NvPjF2SSJdH5vn2OVbE7r0b",
  "object": "issuing.card",
  "brand": "Visa",
  ...
  "status": "inactive",
  "type": "virtual"
}

Vous devez activer la carte pour qu’elle puisse être utilisée. Même si vous pouvez activer des cartes virtuelles dans le même appel à l’API que celui utilisé pour leur création, les cartes physiques doivent être activées séparément. Au moment voulu, activez la carte en lui attribuant le status active :

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

À ce stade, la carte est active et associée à un titulaire de carte. Consultez la page Issuing pour voir des informations relatives à la carte et à son titulaire.

{
  "id": "ic_1NvPjF2SSJdH5vn2OVbE7r0b",
  "object": "issuing.card",
  "brand": "Visa",
  ...
  "status": "active",
  "type": "virtual",
}

Pour en savoir plus, consultez les pages suivantes :

• Virtual cards
• Cartes physiques
• Use the Dashboard for Issuing with Connect
• Create cards with the API

Créer une autorisation

Pour observer l’impact des activités de carte sur le solde associé, générez une autorisation test. Vous pouvez le faire sur la page Issuing du Dashboard du compte connecté ou en effectuant l’appel suivant à l’API Authorization :

curl https://api.stripe.com/v1/test_helpers/issuing/authorizations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d card=
{{CARD_ID}} \
  -d amount=1000 \
  -d authorization_method=chip \
  -d "merchant_data[category]"=taxicabs_limousines \
  -d "merchant_data[city]"="San Francisco" \
  -d "merchant_data[country]"=US \
  -d "merchant_data[name]"="Rocket Rides" \
  -d "merchant_data[network_id]"=1234567890 \
  -d "merchant_data[postal_code]"=94107 \
  -d "merchant_data[state]"=CA

Après approbation, Stripe crée une Authorization à l’état pending en attendant la capture. Notez l’id d’autorisation que vous utiliserez pour capturer les fonds :

{
  "id": "iauth_1NvPyY2SSJdH5vn2xZQE8C7k",
  "object": "issuing.authorization",
  "amount": 1000,
  ...
  "status": "pending",
  "transactions": [],
}

Capturer les fonds

Capturez les fonds à l’aide du code suivant :

curl -X POST https://api.stripe.com/v1/test_helpers/issuing/authorizations/
{{AUTHORIZATION_ID}}
/capture \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

Une fois l’autorisation capturée, Stripe crée une transaction Issuing et l’attribut status de l’autorisation reçoit la valeur closed.