Passer au contenu principal

​
Types d’événements

Yabetoo prend actuellement en charge les types d’événements webhook suivants. Chaque événement correspond à une action spécifique qui se produit sur votre compte et peut être utilisé pour déclencher une logique dans votre backend (par exemple, mettre à jour les statuts des commandes, envoyer des notifications, etc.).

​
intent.completed

Déclenché lorsqu’un paiement a été reçu avec succès sur votre compte.
  • Cas d’utilisation : Confirmer qu’un client a effectué son paiement.
  • Actions typiques :
    • Marquer une commande comme payée
    • Envoyer un email ou SMS de confirmation
    • Mettre à jour le statut du paiement dans votre base de données

​
disbursement.succeeded

Déclenché lorsqu’un décaissement a été traité avec succès depuis votre compte vers un destinataire.
  • Cas d’utilisation : Suivre les paiements sortants ou automatiser les tâches comptables.
  • Actions typiques :
    • Notifier le destinataire
    • Enregistrer la transaction dans votre système financier
    • Mettre à jour le statut du paiement dans votre tableau de bord administrateur

​
disbursement.failed

Déclenché lorsqu’un décaissement échoue, y compris lorsqu’une revue le rejette ou expire (failureCode : risk_review_rejected, risk_review_expired, ou risk_blocked pour un décaissement retenu puis refusé après coup, voir Gestion des erreurs). Les fonds réservés sont libérés.

​
disbursement.review_opened

Déclenché lorsqu’un décaissement en production est retenu pour vérification avant envoi à l’opérateur. Il suit disbursement.created ; le payload porte review (status: "open").
  • Non terminal : le décaissement reste processing. L’issue arrive par disbursement.succeeded ou disbursement.failed.
  • Actions typiques :
    • Afficher « en vérification » plutôt que « en cours d’envoi » à votre utilisateur
    • Ne pas relancer le décaissement : il sera traité ou annulé sous 48 h

​
deposit_disbursement.review_opened

Même événement pour un décaissement financé par le portefeuille de dépôt. Ses issues sont deposit_disbursement.succeeded et deposit_disbursement.failed. Le seul autre événement du cycle de vie d’un décaissement est disbursement.created.

​
checkout.session.completed

Déclenché lorsqu’une session de paiement est payée avec succès.
  • Identifiant à utiliser : data.checkoutSessionId (ne vous appuyez pas sur data.orderId).
  • Actions typiques :
    • Marquer la commande liée à la session comme payée
    • Livrer le bien ou le service

​
checkout.session.payment_failed

Déclenché lorsqu’une tentative de paiement d’une session échoue.
  • Non terminal : la session reste ouverte, le client peut réessayer.
  • Émis quand l’échec est connu à la réponse de confirmation ; un dépassement de délai est porté par intent.expired.
  • data.error est une chaîne opaque, à journaliser, pas à interpréter.
Un paiement par lien de paiement émet payment_link.checkout.completed / payment_link.checkout.failed à la place de checkout.session.*. checkout.session.expired n’est pas émis aujourd’hui.