Webhook Event Object
This page describes the generic structure of all webhook payloads sent by Minteo.
Attributes
All webhooks follow this format:
event_idstringUnique identifier for the event (prefixed with EVENT#). Use this for deduplication.
hook_idstringUnique identifier for this specific delivery attempt (prefixed with HOOK#). Changes with each retry.
event_typestringType of event: order.updated, payout.updated, or payout.item.updated. See Webhook Events for available types.
dataobjectEvent-specific data. Structure varies by event type (see below).
signatureobjectDeprecated. Legacy checksum, kept while integrators move to the X-Minteo-Signature header. See Verifying Signatures.
timestampintegerUnix timestamp (seconds) when this hook was sent.
sent_atstringISO 8601 timestamp when this hook was sent. Same time as timestamp, different format.
Data Object Structure
The data object contains the complete entity as returned by the corresponding GET endpoint:
| Event Type | Data Field | Equivalent API Response |
|---|---|---|
order.updated | data.order | GET /orders/{id}Complete example payload |
payout.updated | data.payout | GET /payouts/{id}Get one payout |
payout.item.updated | data.payout_item | GET /payouts/{payout_id}/items/{item_id}Get one payout item |
HTTP Headers
All webhook requests include:
| Header | Description |
|---|---|
Content-Type | Always application/json |
X-Minteo-Signature | t=<timestamp>,v1=<HMAC-SHA256 of the raw body>. Verify it on every request. See Verifying Signatures. |
X-Hook-Checksum | Deprecated. Same value as signature.checksum. |
Related Documentation
JSON Example
{
"event_id": "EVENT#123e4567-e89b-12d3-a456-426614174000",
"hook_id": "HOOK#2f6d8c1b-5f8f-4b3a-9d52-87a6f3bcd8c2",
"event_type": "order.updated",
"data": {
"order": {
"id": "1234-1610641025-49201",
"status": "SUCCEEDED",
"amount": "4490000",
"created_at": "2025-07-21T22:01:11.318Z",
"updated_at": "2025-07-22T22:01:13.049Z",
"type": "TOKENIZE",
"chain": "POLYGON",
"public_data": {
"financial_items": {
"transfer_amount": "4490000"
},
"deposit_originated_at": "2025-07-21T00:00:00.000Z"
},
"activities": [
{
"type": "CREATE_ORDER",
"status": "SUCCEEDED",
"last_update_at": "2025-07-21T22:01:11.303Z"
}
]
}
},
"signature": {
"properties": ["order.id", "order.status", "order.amount"],
"checksum": "124F3E92EA81EAC6DAB684035557433BA1922A7A47FED49F2001E831B5185C7E"
},
"timestamp": 1530291411,
"sent_at": "2023-11-04T01:35:34.165Z"
}