Webhooks

Des événements signés et dédupliqués sont votre source de vérité pour les rails asynchrones.

Baraka Pay signe chaque webhook et le délivre avec des tentatives et un backoff. Validez la signature, dédupliquez par event id, et rendez votre gestionnaire idempotent.

Le succès, l'échec, l'attente, l'annulation et l'expiration du paiement sont tous délivrés sous forme d'événements. N'exécutez jamais une commande sur la seule redirection du navigateur.

Événements

Paiements : payment.succeeded, payment.failed, payment.pending, payment.cancelled, payment.expired — plus des diagnostics de livraison que vous pouvez rejouer depuis le portail Merchant.

Virements : payout.pending, payout.approved, payout.processing, payout.succeeded, payout.failed, payout.cancelled, payout.returned. Notez que payout.returned peut arriver plusieurs jours après qu'on vous a annoncé le succès — voir Virements.

Dépôts en espèces : cash_deposit.confirmed, émis une fois l'argent reconnu sur le relevé de la banque.

Chacun porte l'identifiant de l'objet qui a changé, et rien de plus. Un webhook dit QUEL enregistrement a changé ; l'API dit en quoi il a changé, et seule l'API fait foi.