DRAVPAY developer resources / Webhooks

Event delivery.

DRAVPAY notifies your website about payment collection, wallet, transfer, and payout status changes.

How it works

DRAVPAY notifies an ecommerce, NGO, or other website when a payment collection, wallet transaction, SACCO transfer, or payout changes state.

Payload shape

Each event is delivered as JSON with the following shape.

JSON
{
  "event_id": "<unique-event-reference>",
  "event_type": "payment.completed",
  "created_at": "<ISO-8601-timestamp>",
  "data": {
    "transfer_id": "<transfer-reference>",
    "status": "completed"
  }
}

Receiver requirements

  • Signature algorithm, header format, secret provisioning, and rotation procedure.
  • Retry schedule, timeout policy, duplicate delivery, and idempotent event handling.
  • Event versioning, status vocabulary, payload fields, and personal-data minimization.
  • Endpoint registration, environment separation, incident response, and delivery logs.

Verify each event with its HMAC signature before processing it.