Skip to main content
Webhooks allow your application to receive real-time notifications when events happen in your Bullring account. Instead of polling the API, we will send an HTTP POST request to your configured URL.

​
Deposit Paid

{
  "event": "deposit.status.paid",
  "data": {
    "id": "0a484300-33a6-435f-ba44-8d9c10c51457",
    "reference": "13360e66-bc53-44d8-98c8-25df91eb525c",
    "account_id": "28007014-1855-4559-8da0-fdca137e97aa",
    "net_amount": {
      "value": 960,
      "currency": "NGN"
    },
    "gross_amount": {
      "value": 980,
      "currency": "NGN"
    },
    "fee": {
      "value": "20.00000000",
      "currency": "NGN"
    },
    "status": "completed",
    "created_at": "2026-02-03T13:29:01.910Z",
    "updated_at": "2026-02-03T13:29:01.910Z",
    "payer": {
      "bank_account_number": "0000000000",
      "bank_account_name": "Mr. Linwood Emmerich III",
      "bank_name": "Maplerad",
      "bank_code": ""
    },
    "receiver": {
      "bank_account_number": "5953717576",
      "bank_account_name": "Cornelius Langworth",
      "bank_name": "Maplerad"
    },
    "settlement": {
      "settlement_at": "2026-02-03T13:29:01.910Z"
    }
  }
}

{
  "event": "deposit.status.paid",
  "data": {
    "id": "4d3aae75-defd-4f34-856d-0efc5eca211d",
    "reference": "4d3aae75defd4f34856d0efc5eca211d",
    "account_id": "28007014-1855-4559-8da0-fdca137e97aa",
    "net_amount": {
      "value": 210,
      "currency": "BRL"
    },
    "gross_amount": {
      "value": 210,
      "currency": "BRL"
    },
    "fee": {
      "value": 0,
      "currency": "BRL"
    },
    "status": "completed",
    "created_at": "2026-02-03T16:34:31.138Z",
    "updated_at": "2026-02-03T16:35:46.634Z",
    "payer": {},
    "receiver": {
      "name": "Unegbu"
    },
    "settlement": {
      "settlement_at": "2026-02-03T16:35:46.634Z",
      "end_to_end_id": "4d3aae75defd4f34856d0efc5eca211d"
    }
  }
}

​
Deposit Unpaid

{
  "event": "deposit.status.unpaid",
  "data": {
    "id": "4d3aae75-defd-4f34-856d-0efc5eca211d",
    "reference": "4d3aae75defd4f34856d0efc5eca211d",
    "account_id": "28007014-1855-4559-8da0-fdca137e97aa",
    "net_amount": {
      "value": 210,
      "currency": "BRL"
    },
    "gross_amount": {
      "value": 210,
      "currency": "BRL"
    },
    "fee": {
      "value": 0,
      "currency": "BRL"
    },
    "status": "completed",
    "created_at": "2026-02-03T16:34:31.138Z",
    "updated_at": "2026-02-03T16:35:46.634Z",
    "payer": {},
    "receiver": {
      "name": "Unegbu"
    },
    "settlement": {
      "settlement_at": "2026-02-03T16:35:46.634Z",
      "end_to_end_id": "4d3aae75defd4f34856d0efc5eca211d"
    }
  }
}