Webhooks

Webhooks allow an integration to react when important Cedius events occur.

Portfolio note: This webhook model belongs to the illustrative Cedius API specification.

Event flow

1. An event occurs.
2. Cedius creates an event object.
3. Cedius sends an HTTP POST to the registered endpoint.
4. Your server verifies the signature.
5. Your server returns a 2xx response quickly.
6. Your application processes the event.

{
  "id": "evt_49bc21",
  "type": "invoice.paid",
  "created_at": "2026-09-10T08:45:00Z",
  "data": {
    "invoice": {
      "id": "inv_91ac20",
      "customer_id": "cus_4d7c21",
      "status": "paid",
      "total": 161250,
      "currency": "NGN"
    }
  }
}