Webhooks

CaurisPay notifie votre serveur à chaque changement de statut d'une demande de paiement. Chaque requête est signée, vérifiez toujours la signature avant de traiter l'événement.

Format de la requête reçue

POST {votre callbackUrl}

{
  "event": "payment_request.paid",
  "data": {
    "id": "pr_a1b2c3d4",
    "token": "PAY-A1B2C3D4",
    "amount": "5000.00",
    "currency": "XOF",
    "status": "paid"
  }
}

Événements disponibles

payment_request.notifiedLe payeur a reçu la notification push

payment_request.paidPaiement confirmé et transfert exécuté

payment_request.rejectedRefusé explicitement par le payeur

payment_request.expiredDélai dépassé sans réponse du payeur

payment_request.cancelledAnnulée par vous via DELETE

payment_request.failedErreur technique lors du traitement

Répondez toujours 200 rapidement, même si le traitement métier prend du temps — faites-le en asynchrone après avoir répondu.

Étape suivante

Apprenez à vérifier la signature de chaque webhook reçu.