Autorisations Issuing
Lorsqu’une carte bancaire est utilisée pour effectuer un achat, une demande d’autorisation est générée, puis approuvée ou refusée en fonction des étapes suivantes :
Stripe vérifie que les fonds disponibles sur le solde utilisé pour Issuing sont suffisants, que la carte est active et que vos contrôles de dépense permettent l’autorisation. Parfois, Stripe approuve ou refuse immédiatement la demande d’autorisation à ce stade.
Stripe envoie un événement
issuing_authorization.request
. Si vous n’avez pas de webhook d’autorisation en temps réel, nous approuvons l’autorisation sans envoyer l’événementissuing_authorization.request
.Écouter les événements Stripe
Configurez un webhook d’autorisation en temps réel pour écouter cet événement afin de pouvoir approuver ou refuser les autorisations de manière synchrone.
Vous pouvez approuver ou refuser l’autorisation en répondant directement à l’événement webhook. Si vous n’approuvez pas ou ne refusez pas la
issuing_authorization.request
sous 2 secondes, Stripe utilise vos paramètres de délai d’attente du webhook pour approuver ou refuser l’autorisation.Stripe envoie un événement
issuing_authorization.created
, vous informant de la création de l’Autorisation et de la décision.
Scénarios sans demande d’autorisation en temps réel
Il arrive que Stripe reçoive du réseau de cartes une demande d’autorisation qu’elle approuve ou refuse sans vous envoyer d’événement issuing_authorization.request
:
- Si Stripe décide que la demande d’autorisation ne peut être approuvée (par exemple, parce que la carte est inactive ou que vos contrôles de dépenses ne l’autorisent pas), nous la refuserons.
- Si vous n’avez pas configuré de webhook d’autorisation en temps réel et que nous n’avons pas de raison de refuser la demande d’autorisation, nous l’approuverons.
En pareil cas, Stripe envoie quand même un événement issuing_authorization.created
pour vous informer de la création de l’autorisation.
Mises à jour des autorisations
Lorsque Stripe reçoit une demande d’autorisation, nous envoyons un événement webhook issuing_authorization.created
. Si vous approuvez cette autorisation, nous déduisons le montant amount
de votre solde Issuing et le plaçons en réserve jusqu’à ce que l’autorisation soit capturée, annulée ou expirée sans capture. Si vous refusez l’autorisation, l’état prend la valeur closed
et nous n’effectuons pas de mise en réserve.
Lorsque l’autorisation est capturée, une transaction est créée et le status
de l’autorisation est défini sur closed
.
Si la demande d’autorisation est annulée, nous envoyons un événement de webhook issuing_authorization.updated
avec un status
défini sur reversed
et un amount
sur 0
. Nous reversons le montant annulé de sur votre solde Issuing, ce qui annule l’opération sur solde initiale.
Si la demande d’autorisation a expiré avant d’être capturée, nous envoyons un événement webhook issuing_authorization.updated
avec son status
défini sur reversed
et le amount
représentant tout montant restant autorisé pour d’éventuelles captures en retard. Nous reversons le montant expiré de sur votre solde Issuing, ce qui annule l’opération sur solde initiale.
Achats dans plusieurs devises
Les cartes peuvent être utilisées pour effectuer des achats dans n’importe quelle devise prise en charge par le réseau de la carte. Stripe convertit automatiquement la devise de l’achat dans la devise de la carte lors du blocage des fonds, en appliquant le taux de change du jour du réseau de la carte.
Le merchant_amount
reflète le coût de l’achat dans la devise locale. Le champ amount
reflète le montant attendu de la Transaction
dans la devise de la carte. Ce montant reste provisoire jusqu’à ce que l’Authorization
ait été capturée.
Gestion d’autres autorisations
En plus des autorisations standard, il existe quelques cas particuliers que vous devriez savoir gérer.
Transactions des distributeurs de carburant
Lorsqu’un titulaire de carte tente d’effectuer un achat dans une station-service (MCC 5542), une issuing_authorization.request
d’un montant de 1 USD (appelée « contrôle d’état ») est envoyée. Le montant bloqué par défaut pour couvrir un montant d’achat inconnu est de 100 USD. Lorsque le client a fini de se servir à la pompe, l’autorisation est mise à jour et un événement issuing_authorization.updated
reflétant le montant de l’achat est envoyé.
Lorsque le distributeur de carburant admet les autorisations partielles en définissant le champ is_amount_controllable
sur true
, vous pouvez répondre avec un montant approuvé inférieur (par exemple, 50 USD). Toutefois, si le distributeur de carburant interdit les autorisations partielles, vous devez soit approuver le montant par défaut du réseau (Stripe ignorera tout autre montant spécifié), soit refuser l’autorisation.
Utilisation avec Stripe Treasury
Les autorisations sur les cartes qui utilisent des fonds stockés dans des FinancialAccounts de Treasury ont un champ treasury
field avec des références aux ressources Treasury : Transaction, ReceivedCredit et ReceivedDebit.
Scenarios with no record of declined transactions in the Dashboard or API
In some cases, a transaction made with an Issuing Card might be declined and neither you or your connected accounts will receive a webhook event or an authorization record (iauth_
).
In these cases, make sure that you collect as much information as possible about the declined transaction before reaching out to Stripe support for assistance.
We recommend including the following information:
- The time of the decline
- The cardholder (
ich_
) who made the purchase - The card (
ic_
) used for the transaction - The merchant involved in the transaction
- Any other circumstances surrounding the transaction
It’s possible that the transaction is declined before any related information is transmitted to Stripe. In these cases, the cardholder involved must directly contact the business to determine the cause of the decline because Stripe hasn’t received a record of the transaction.
You might encounter additional instances of declines without an associated webhook event or authorization object that Stripe can assist with. To determine the classification of the decline, contact Stripe support with the information provided above. We can help to determine the most appropriate steps to investigate the decline(s).