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.

disbursement.status

This event is sent whenever a disbursement request has been made.

Example Disbursement Status Webhook

JSON

{
  "data": {
    "amount": 100,
    "currency": "NGN",
    "entryId": "44e2cb",
    "metadata": {
      "batchId": "df6c9824e093",
      "trackingId": "cc2520ea-aff8-4841-a3c1-b899e7ceec89"
    },
    "recipient": {
      "accountName": "N/A",
      "accountNumber": "1234567890",
      "bankCode": "123456",
      "bankName": "N/A"
    },
    "status": "pending"
  },
  "event": "disbursement.status",
  "timestamp": "2025-07-19T12:37:00Z"
}

escrow.deposit_successful

This event is sent once a customer makes a deposit into escrow hold.

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"
}

escrow.transaction_fulfilled

This event is sent when an escrow transaction has been complete and both parties have completed their part of the agreement.

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"
}

payment.successful

This event is sent whenever an payment has been received from either an Invoice, Escrow, or Payment Link.

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"
}