Webhooks
Notifications de paiement envoyées à votre serveur, et webhook Sandbox pour les tests.
Vue d’ensemble
AIFI PAY envoie une notification signée (POST JSON, en-tête AIFI-Signature) à l’URL de notification de votre boutique quand un paiement réussit, échoue, est annulé, expire ou est remboursé. Configurez l’URL et récupérez le secret de signature dans Tableau de bord → Clés API. Format, vérification de la signature et exemples PHP / Node.js : Paiement hébergé → Notification.
Ci-dessous : l’endpoint entrant réservé au simulateur Sandbox.
Webhook Sandbox
/v1/webhooks/sandboxPublic (non authentifié par clé API). Réservé à l’environnement Sandbox. Sert à injecter un événement de statut pour une référence provider : le providerReference reçu à la création du paiement.
{
"providerReference": "sim_…",
"status": "SUCCEEDED",
"eventId": "evt_demo_001"
}Alternative : header x-sandbox-event-id pour l’identifiant d’événement.
{
"ok": true,
"transactionId": "…",
"status": "SUCCEEDED",
"eventId": "evt_demo_001"
}