Webhook payloads

Every webhook request contains an event envelope.

Field	Type	Description
id	string	Event ID with the evt_ prefix.
type	string	Event type.
created_at	string	ISO 8601 timestamp.
data	object	Event-specific data.

Invoice paid

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

Payment completed

{
  "id": "evt_a91f20",
  "type": "payment.completed",
  "created_at": "2026-09-10T08:45:02Z",
  "data": {
    "payment": {
      "id": "pay_72bd13",
      "invoice_id": "inv_91ac20",
      "amount": 161250,
      "currency": "NGN",
      "status": "completed"
    }
  }
}