Callbacks marchands

Lorsque le statut d’un paiement change (notamment vers SUCCES), EretuPay notifie l’URL callbackUrl de votre compte via HTTP POST JSON. Les notifications sont asynchrones (file d’attente + retries).

Configurer l’URL

Dans votre profil marchand, définissez une URL HTTPS publique, par exemple :

https://api.votredomaine.com/webhooks/eretupay

Payload (exemple TMoney)

{
  "payment_id": "…",
  "command_id": "ORDER-1001",
  "requete_id": "631328001ps61b",
  "status": "SUCCES",
  "amount": 1000,
  "payment_method": "tmoney",
  "address": "22890123456",
  "message": null
}

Payload (exemple Flooz / Paygate)

{
  "payment_id": "…",
  "command_id": "ORDER-1001",
  "requete_id": "TX-123",
  "tx_reference": "TX-123",
  "status": "SUCCES",
  "amount": 1000,
  "payment_method": "flooz",
  "address": "90123456",
  "message": null
}

Bonnes pratiques

• Répondez rapidement (HTTP 2xx). Les 5xx / 429 déclenchent des retries.
• Traitez de façon idempotente sur command_id / payment_id.
• Ne vous fiez pas uniquement au callback : confirmez avec /api/v2/payment/status si besoin.