Webhooks

MabiPay sends an HTTP POST notification to your notifyUrl on every status change.

Payload format

{
  "event": "payment.success",
  "reference": "TXN-20240615-ABCD1234",
  "merchantRef": "ORDER-12345",
  "status": "success",
  "amount": 5000,
  "currency": "XOF",
  "customerPhone": "+2250700000000",
  "timestamp": "2024-06-15T10:30:00Z"
}

Events

Event	Description
payment.success	Payment successful
payment.failed	Payment failed
payment.expired	Payment expired
payment.cancelled	Payment cancelled by client
payout.success	Payout successful
payout.failed	Payout failed

BPay notification endpoint

POST /api/v1/webhooks/bpay

info

Your endpoint must respond with HTTP 200. On failure, MabiPay retries up to 3 times with exponential backoff.