Webhooks

CaurisPay notifie votre callbackUrlà 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 général

Toutes les requêtes webhook suivent le même format : un event et un objet data contenant le token de la demande concernée.

POST {votre callbackUrl}

{
  "event": "payment_request.paid",
  "data": {
    "token": "CAURISPAY-PAYMENT-20260705T113416274Z-161"
  }
}

Le webhook ne contient que le token — pour connaître le montant, la devise ou le détail complet de la demande, appelez Consulter le statut avec ce token.

Événements disponibles

payment_request.notifiedEnvoyé immédiatement après la création, dès que la notification part au payeur

{
  "event": "payment_request.notified",
  "data": {
    "token": "CAURISPAY-PAYMENT-20260705T113416274Z-161"
  }
}

payment_request.paidLe payeur a confirmé avec son code PIN, le transfert est exécuté

{
  "event": "payment_request.paid",
  "data": {
    "token": "CAURISPAY-PAYMENT-20260705T113416274Z-161"
  }
}

payment_request.rejectedLe payeur a explicitement refusé la demande

{
  "event": "payment_request.rejected",
  "data": {
    "token": "CAURISPAY-PAYMENT-20260705T113416274Z-161"
  }
}

payment_request.expiredLe délai de 5 minutes a été dépassé sans réponse du payeur

{
  "event": "payment_request.expired",
  "data": {
    "token": "CAURISPAY-PAYMENT-20260705T113416274Z-161"
  }
}

payment_request.cancelledVous avez annulé la demande via l'endpoint DELETE

{
  "event": "payment_request.cancelled",
  "data": {
    "token": "CAURISPAY-PAYMENT-20260705T113416274Z-161"
  }
}

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.