Définissez un webhook_url sur un paiement (ou un checkout) et Orqex POST un événement
JSON à chaque changement de statut. C’est la façon fiable de connaître le statut final.
Pour le fonctionnement global des webhooks (livraison, retries, sécurité), voir
Webhooks dans Get started.
Événements
Toutes les tentatives ont échoué.
payment.partially_refunded
Partiellement remboursé.
payment.attempt.completed
Une tentative a réussi.
payment.attempt.action_required
Une tentative requiert une action.
X-Payment-Event, avec X-Payment-Id.
Charge utile et handler
{
"event": "payment.completed",
"payment": {
"id": "TRX1A2B3C4D",
"amount": { "value": 5000, "formatted": "50.00 XOF", "currency": "XOF" },
"status": "completed",
"metadata": { "order_id": "1024" }
},
"attempt": { "id": "att_...", "status": "completed", "method_code": "momo_mtn", "is_fallback": false },
"customer": { "id": "cus_...", "email": "[email protected]" },
"timestamp": "2026-06-08T12:00:00+00:00"
}
Les livraisons vers un webhook_url par paiement ne sont pas signées. Re-récupérez le
paiement via l’API et agissez sur ce statut faisant autorité (ci-dessus). Pour des
livraisons signées, enregistrez un endpoint de webhook de
projet — chacun a un secret de signature et un en-tête x-orqex-signature à
vérifier. 
