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.