Webhook Guide
Payload Reference
Detailed payload structure for every webhook event type with field descriptions and examples.
Every webhook delivery follows a common envelope structure with event-specific data. This page documents the payload format for each event type.
Common Envelope
All webhook payloads share this structure:
| Field | Type | Description |
|---|---|---|
eventId | string | Unique event identifier — use for idempotency |
eventType | string | Event type (see Events for full list) |
timestamp | string | ISO 8601 timestamp of when the event occurred |
tenantId | string | Your tenant identifier |
data | object | Event-specific payload (see below) |
signature | string | HMAC-SHA256 signature for verification |
{
"eventId": "evt_20260306_abc123def456",
"eventType": "transaction.credit.completed",
"timestamp": "2026-03-06T10:30:00.000Z",
"tenantId": "YOUR_TENANT",
"data": {
// Event-specific fields
},
"signature": "sha256=a1b2c3d4e5f6..."
}