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.

You can add funds from your 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"
}

You need to activate the card before a user can use it. While you can activate virtual cards in the same API call you used to create it, you must activate physical cards separately. When ready, activate the card by marking the status as 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 :

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

Créer une autorisation

To observe the impact of card activity on the associated balance, generate a test authorization. You can do this in the Issuing page of the Dashboard, or with the following call to the Authorization API:

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.