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 à partir de votre Dashboard.

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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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’un utilisateur puisse l’utiliser. Vous pouvez activer des cartes virtuelles dans le même appel à l’API que celui que vous avez utilisé pour le créer, mais vous devez activer les cartes physiques séparément. Lorsque vous êtes prêt, activez la carte en marquant son status comme active :

curl https://api.stripe.com/v1/issuing/cards/ic_1NvPjF2SSJdH5vn2OVbE7r0b \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 :

• Cartes virtuelles
• Cartes physiques
• Utiliser le Dashboard pour Issuing avec Connect
• Créer des cartes avec l’API

Créer une autorisation

Pour observer l’impact de l’activité de la carte sur le solde associé, générez une autorisation de test. Vous pouvez le faire sur la page Issuing du Dashboard ou en appelant l’API Authorization :

curl https://api.stripe.com/v1/test_helpers/issuing/authorizations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:"

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