Centiiv Webhook Event Types
This is the list of event types that we currently send.
For guidance on how to listen to these events, take a look at Svix's guide to consuming webhooks.
data
object
6 Items
event
string
timestamp
string
(date-time)
Example Disbursement Status Webhook
JSON
{
"data": {
"amount": 15000,
"currency": "NGN",
"entryId": "entry_5678",
"metadata": {
"batchId": "batch_888",
"trackingId": "track_123"
},
"recipient": {
"accountName": "John Doe",
"accountNumber": "0123456789",
"bankCode": "044",
"bankName": "Access Bank"
},
"status": "pending"
},
"event": "disbursement.status",
"timestamp": "2025-07-19T12:37:00Z"
}data
object
6 Items
event
string
timestamp
string
(date-time)
Example Escrow Deposit Successful Webhook
JSON
{
"data": {
"amount": 10000,
"currency": "NGN",
"depositor": {
"email": "buyer@example.com",
"id": "user_123",
"name": "Buyer User"
},
"metadata": {
"resourceId": "escrow_456",
"resourceType": "escrow",
"trackingId": "track_789"
},
"status": "successful",
"transactionId": "escrow_txn_001"
},
"event": "escrow.deposit_successful",
"timestamp": "2025-07-19T12:35:00Z"
}data
object
7 Items
event
string
timestamp
string
(date-time)
Example Escrow Transaction Fulfilled Webhook
JSON
{
"data": {
"amountToBeReleased": 12000,
"buyer": {
"email": "buyer@example.com",
"id": "buyer_321",
"name": "Buyer Jane"
},
"currency": "NGN",
"metadata": {
"resourceId": "order_123",
"resourceType": "order",
"trackingId": "track_999"
},
"status": "successful",
"transactionId": "txn_fulfilled_001",
"verifiedAt": "2025-07-19T12:35:45Z"
},
"event": "escrow.transaction_fulfilled",
"timestamp": "2025-07-19T12:36:00Z"
}data
object
7 Items
event
string
timestamp
string
Example
JSON
{
"data": {
"amount": 7200000,
"currency": "NGN",
"customer": {
"email": "john@doe.com",
"id": "CUS-76bdf9",
"name": "string"
},
"metadata": {
"resourceId": "INV-98b7c8",
"resourceType": "invoice"
},
"paymentMethod": "bank_transfer",
"status": "successful",
"transactionId": "TXN_554cb7"
},
"event": "payment.successful",
"timestamp": "2025-06-19T10:33:12.762Z"
}