{
"event": "payment_link.expired",
"data": {
"id": "64b2c1234567890",
"code": "xyz789abc012",
"title": "Invoice 1001",
"amount": 25000,
"currency": "naira",
"type": "fiat",
"status": "expired",
"isActive": false,
"metadata": {
"partnerReference": "invoice-1001"
},
"expiresAt": "2026-07-11T12:00:00.000Z",
"createdAt": "2026-07-10T12:00:00.000Z",
"updatedAt": "2026-07-11T12:00:00.000Z"
}
}Webhooks
Payment link expired
Sent when a payment link expires, including when you call POST /payment-links/{id}/expire. Delivered as a POST to your webhook URL; return a 2xx to acknowledge.
WEBHOOK
payment_link.expired
{
"event": "payment_link.expired",
"data": {
"id": "64b2c1234567890",
"code": "xyz789abc012",
"title": "Invoice 1001",
"amount": 25000,
"currency": "naira",
"type": "fiat",
"status": "expired",
"isActive": false,
"metadata": {
"partnerReference": "invoice-1001"
},
"expiresAt": "2026-07-11T12:00:00.000Z",
"createdAt": "2026-07-10T12:00:00.000Z",
"updatedAt": "2026-07-11T12: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.