Skip to main content
This project currently supports four webhook event types end-to-end:

​
Paygen webhook shape

Paygen webhook deliveries use this envelope: 
{
  "_id": "evt_paygen_01",
  "environment": "production",
  "business": "business_123",
  "type": "transaction.created",
  "createdAt": 1713878400,
  "data": {
    "_id": "wh_paygen_tx_01",
    "object": {}
  }
}
  • _id: unique Paygen event identifier
  • environment: Paygen environment
  • business: Paygen business identifier
  • type: event name
  • createdAt: provider event timestamp
  • data.object: resource payload for the specific event

​
Outbound client webhook shape

Outbound webhook deliveries use this envelope: 
{
  "event": "event.name",
  "data": {},
  "client": "client_id",
  "createdAt": "2026-04-23T10:00:00.000Z"
}
If a webhook token is configured, Paygen also sends:
  • Authorization: Bearer <token>
  • X-Paygen-Webhook-Token: <token>
  • X-Paygen-Signature: <sha256-hmac>
Every outbound webhook also includes:
  • X-Paygen-Event
  • X-Paygen-Timestamp

​
Event pages

Each event page in this section documents both:
  • the outbound Paygen client webhook sample payload