{
"event": "payment_link.paid",
"data": {
"id": "64b2c1234567890",
"code": "xyz789abc012",
"title": "Invoice 1001",
"amount": 25000,
"currency": "naira",
"type": "fiat",
"status": "completed",
"metadata": {
"partnerReference": "invoice-1001"
},
"payment": {
"reference": "6a51a0000000000000000201",
"amount": 25000,
"fee": 250,
"amountSettled": 24750,
"currency": "NGN",
"sender": {
"accountName": "JANE DOE",
"accountNumber": 123456789,
"bankName": "Access Bank"
},
"paidAt": "2026-07-10T14:00:00.000Z"
},
"expiresAt": "2026-07-11T12:00:00.000Z",
"createdAt": "2026-07-10T12:00:00.000Z",
"updatedAt": "2026-07-10T14:00:00.000Z"
}
}Webhooks
Payment link paid
Sent when a payment is received on a payment link. The received payment is under payment. Delivered as a POST to your webhook URL; return a 2xx to acknowledge.
WEBHOOK
payment_link.paid
{
"event": "payment_link.paid",
"data": {
"id": "64b2c1234567890",
"code": "xyz789abc012",
"title": "Invoice 1001",
"amount": 25000,
"currency": "naira",
"type": "fiat",
"status": "completed",
"metadata": {
"partnerReference": "invoice-1001"
},
"payment": {
"reference": "6a51a0000000000000000201",
"amount": 25000,
"fee": 250,
"amountSettled": 24750,
"currency": "NGN",
"sender": {
"accountName": "JANE DOE",
"accountNumber": 123456789,
"bankName": "Access Bank"
},
"paidAt": "2026-07-10T14:00:00.000Z"
},
"expiresAt": "2026-07-11T12:00:00.000Z",
"createdAt": "2026-07-10T12:00:00.000Z",
"updatedAt": "2026-07-10T14:00:00.000Z"
}
}Authorizations
Your Business API Key
Headers
Hex HMAC-SHA512 of the raw request body, keyed with your webhook secret. Verify it before trusting the payload.
Body
application/json
Response
200
Return any 2xx once the event is stored.
