Intégrer le modèle Issuing limité aux prestations de services de paiement

Créez un objet Cardholder pour représenter l’entreprise ou la personne autorisée à utiliser la carte. La réponse comprend un identifiant unique pour le titulaire de la carte.

curl https://api.stripe.com/v1/issuing/cardholders \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d name="Jenny Rosen" \
  --data-urlencode email="jenny.rosen@example.com" \
  --data-urlencode phone_number="+18008675309" \
  -d status=active \
  -d type=individual \
  -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

Émettez la carte auCardholder en transmettant l’identifiant id de l’étape précédente. Vous devez également inclure la devise et le type de carte (physical ou virtual). Dans l’exemple suivant, nous incluons également les informations de livraison du titulaire de la carte.

curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d type=physical \
  -d cardholder=ich_123 \
  -d "shipping[name]"="Jenny Rosen" \
  -d "shipping[address][line1]"="123 Main St" \
  -d "shipping[address][city]"="San Francisco" \
  -d "shipping[address][state]"=CA \
  -d "shipping[address][postal_code]"=94111 \
  -d "shipping[address][country]"=US

Pour suivre l’état de livraison de la carte, utilisez les attributs tracking_url ou tracking_number. Vous pouvez également écouter le webhook issuing_card.updated pour suivre les mises à jour de shipping.status. Pour que vous receviez des mises à jour, le transporteur doit prendre en charge le suivi.

Lorsque vous recevez un webhook indiquant que shipping.status est égal à delivered, activez la carte en mettant à jour son état. (Vous pouvez également utiliser cette API pour désactiver temporairement la carte.) Par défaut, les cartes sont inactives au moment de leur création.

curl https://api.stripe.com/v1/issuing/cards/ic_123 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d status=active

Configurez le webhook issuing_authorization.request pour recevoir immédiatement une notification lorsqu’une demande d’autorisation est effectuée sur une carte émise. Vous pouvez ainsi approuver ou refuser l’autorisation instantanément, ce qui vous permet de décider d’autoriser ou de bloquer une transaction avant qu’elle ne se termine. Pour en savoir plus, consultez la page Autorisations Issuing en temps réel.

Inscrivez-vous aux événements de webhook issuing_authorization.create. Ce webhook vous informe lorsque une personne crée une nouvelle autorisation pour une carte émise. Il fournit des détails sur le résultat de l’autorisation, notamment si elle a été approuvée ou refusée. Vous pouvez ainsi suivre les autorisations, gérer les cas particuliers (par exemple, les refus du réseau après approbation) et bloquer le solde du titulaire de la carte lorsqu’une autorisation est terminée.

Inscrivez-vous aux événements de webhook issuing_transaction.create. Ce webhook vous informe lorsqu’une nouvelle transaction est créée pour une carte émise, ce qui se produit lorsque Stripe reçoit l’enregistrement de compensation pour une autorisation. Vous ne pouvez pas refuser l’enregistrement de compensation, mais vous pouvez contester la transaction si nécessaire. Utilisez ce webhook pour suivre les dépenses finalisées et mettre à jour les soldes des titulaires de carte en conséquence.

Une transaction ne doit pas nécessairement être associée à une autorisation (dans le cas d’une capture forcée). En outre, le montant de la transaction ne doit pas nécessairement correspondre au montant d’une autorisation associée (dans le cas d’une partial_capture ou d’une over_capture).

Pour déterminer le montant de votre règlement quotidien avec le réseau de cartes, abonnez-vous au webhook issuing_settlement. Vous pouvez également utiliser ce webhook pour vérifier que le montant correspond aux transactions de la journée.

L’événement issuing_settlement.created indique le montant que vous devez régler auprès du réseau de cartes un jour donné. Vous pouvez effectuer un rapprochement avec le montant prélevé sur votre compte bancaire. Stripe associe les transactions Issuing et les litiges à l’objet Settlement. Lorsque nous trouvons toutes les transactions, nous marquons l’état du règlement comme completed. Pour en savoir plus, consultez l’API Settlement.

Pour comprendre et suivre l’impact sur le solde d’un titulaire de carte spécifique, additionnez les objets transaction et Dispute Settlement Detail associés au règlement.