Webhooks pour Stripe Issuing et Stripe Treasury
Découvrez les événements de webhook pour Stripe Issuing et Stripe Treasury et pourquoi ils surviennent.
Stripe utilise des webhooks pour notifier votre application lorsqu’un événement se produit sur votre compte. Utilisez des webhooks pour traiter les événements asynchrones, par exemple la création d’une autorisation Issuing ou un virement ACH. Pour voir les événements de webhook Treasury, connectez-vous à votre compte Stripe en ayant activé Stripe Treasury.
Événements de webhook Issuing
Le tableau suivant établit la liste des événements de webhook pour Issuing et Treasury.
Remarque
Les webhooks Connect concernent l’activité de tous les comptes connectés. Tous les événements qui se produisent sur les comptes connectés sont envoyés aux webhooks Connect. Cela comprend les événements générés par les intégrations Treasury et Issuing. Pour en savoir plus, consultez la page consacrée aux webhooks Connect.
| Type d’événement | Explication | Remarque |
|---|---|---|
| issuing_authorization.created | Se produit lorsqu’une autorisation est créée. | |
| issuing_authorization.request | Représente une requête synchrone pour l’autorisation (consultez Utilisation de votre intégration pour gérer les demandes d’autorisation). Vous devez créer un endpoint de webhook qui s’abonne explicitement à ce type d’événement pour y accéder. Les endpoints de webhook qui s’abonnent à tous les événements n’incluent pas ce type d’événement. | |
| issuing_authorization.updated | Se produit lorsqu’une autorisation est modifiée. | |
| issuing_card.created | Se produit lorsqu’une carte est créée. | |
| issuing_card.updated | Se produit lorsqu’une carte est modifiée. | |
| issuing_cardholder.created | Se produit lorsqu’un titulaire de carte est créé. | |
| issuing_cardholder.updated | Se produit lorsqu’un titulaire de carte est modifié. | |
| issuing_dispute.closed | Se produit lorsqu’un litige est gagné, perdu ou expiré. | |
| issuing_dispute.created | Se produit lorsqu’un litige est créé. | |
| issuing_dispute.funds_reinstated | Se produit quand des fonds sont transférés vers votre solde Issuing (généralement associé à l’état litige remporté). | |
| issuing_dispute.submitted | Se produit lorsqu’un litige est soumis. | |
| issuing_dispute.updated | Se produit lorsqu’un litige est modifié. | |
| issuing_transaction.created | Se produit quand une transaction Issuing est créée. | |
| issuing_transaction.updated | Se produit quand une transaction Issuing est modifiée. | |
| topup.created | Se produit lorsqu’une recharge est créée. | Uniquement pertinent pour les intégrations Issuing. |
| topup.canceled | Se produit lorsqu’une recharge est annulée. | |
| topup.failed | Se produit lorsqu’une recharge échoue. | |
| topup.reversed | Se produit lorsqu’une recharge est annulée. | |
| topup.succeeded | Se produit lorsqu’une recharge est effectuée. | |
| balance_transfer.created | Nouvelle API de transfert de solde : transférer des fonds de l’acquisition à l’émission | |
| balance.available | Reflète le nouveau solde Stripe et le nouveau solde Issuing après le transfert de solde |
Événements de webhook Treasury
Le tableau suivant établit la liste des événements de webhook pour Treasury et le moment auquel ils se produisent.
| Événement | Description |
|---|---|
| treasury.credit_reversal.created | Se produit lorsqu’un CreditReversal est créé. |
| treasury.credit_reversal.posted | Se produit lorsqu’un CreditReversal est comptabilisé. |
| treasury.debit_reversal.completed | Se produit lorsqu’un DebitReversal est finalisé. |
| treasury.debit_reversal.created | Se produit lorsqu’un DebitReversal est créé. |
| treasury.debit_reversal.initial_credit_granted | Se produit lorsqu’un crédit d’origine est accordé sur un DebitReversal. |
| treasury.financial_account.closed | Se produit quand l’état du FinancialAccount passe à clôturé. |
| treasury.financial_account.created | Se produit quand un nouveau FinancialAccount est créé. |
| treasury.financial_account.features_status_updated | Se produit quand les états de toutes les fonctionnalités d’un FinancialAccount existant sont modifiés. |
| treasury.inbound_transfer.canceled | Se produit lorsqu’un InboundTransfer est annulé. |
| treasury.inbound_transfer.created | Se produit lorsqu’un InboundTransfer est créé. |
| treasury.inbound_transfer.failed | Se produit lorsqu’un InboundTransfer a échoué. |
| treasury.inbound_transfer.succeeded | Se produit lorsqu’un InboundTransfer a été effectué. |
| treasury.outbound_payment.canceled | Se produit lorsqu’un OutboundPayment est annulé. |
| treasury.outbound_payment.created | Se produit lorsqu’un OutboundPayment est créé. |
| treasury.outbound_payment.expected_arrival_date_updated | Se produit lorsque la date de réception d’un OutboundPayment est modifiée. |
| treasury.outbound_payment.failed | Se produit lorsqu’un OutboundPayment échoue. |
| treasury.outbound_payment.posted | Se produit lorsqu’un OutboundPayment est comptabilisé. |
| treasury.outbound_payment.returned | Se produit lorsqu’un OutboundPayment est renvoyé. |
| treasury.outbound_payment.tracking_details_updated | Se produit à chaque mise à jour de l’attribut tracking_details d’un OutboundPayment. |
| treasury.outbound_transfer.canceled | Se produit lorsqu’un OutboundTransfer est annulé. |
| treasury.outbound_transfer.created | Se produit lorsqu’un OutboundTransfer est créé. |
| treasury.outbound_transfer.expected_arrival_date_updated | Se produit lorsque la date de réception d’un OutboundTransfer est modifiée. |
| treasury.outbound_transfer.failed | Se produit lorsqu’un OutboundTransfer a échoué. |
| treasury.outbound_transfer.posted | Se produit lorsqu’un OutboundTransfer est comptabilisé. |
| treasury.outbound_transfer.returned | Se produit lorsqu’un OutboundTransfer est renvoyé. |
| treasury.outbound_transfer.tracking_details_updated | Se produit à chaque mise à jour de l’attribut tracking_details d’un OutboundTransfer. |
| treasury.received_credit.created | Se produit lorsqu’un received_credit est créé à la suite de fonds versés par un autre compte. |
| treasury.received_credit.failed | Se produit lorsqu’un received_credit passe à l’état en échec. Uniquement applicable à l’acceptation des chèques. |
| treasury.received_credit.succeeded | Se produit chaque fois qu’un received_credit passe à l’état réussi. Uniquement applicable à l’acceptation des chèques. |
| treasury.received_debit.created | Se produit lorsqu’un received_debit est créé à la suite de fonds débités par un autre compte. |
Événements de webhook Connect Onboarding
Les événements de webhook suivants peuvent survenir durant l’inscription à Connect :
- Account.updated
- Persons.updated
- Capability.updated
Pour plus d’informations, consultez la page Réalisation d’appels à l’API pour les comptes connectés
Événements de webhook Financial Connections
Consultez la page sur les webhooks Financial Connections. Ces webhooks sont utiles quand un compte connecté utilise Financial Connections pour vérifier instantanément un compte bancaire externe afin d’activer les InboundTransfers.
Bonnes pratiques relatives aux événements de webhooks
Pour en savoir plus sur les bonnes pratiques en matière de webhooks, consultez les bonnes pratiques en matière de webhooks.