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

POST/v1/webhooks/sandbox

Public (non authentifié par clé API). Réservé à l’environnement Sandbox. Sert à injecter un événement de statut pour une référence provider.

Body

{
  "providerReference": "sandbox_ref_…",
  "status": "SUCCEEDED",
  "eventId": "evt_demo_001"
}

Alternative : header x-sandbox-event-id pour l’identifiant d’événement.

Réponse

{
  "ok": true,
  "transactionId": "…",
  "status": "SUCCEEDED",
  "eventId": "evt_demo_001"
}