Webhook Event Object

This page describes the generic structure of all webhook payloads sent by Minteo.

Attributes

All webhooks follow this format:

event_idstring

Unique identifier for the event (prefixed with EVENT#). Use this for deduplication.

hook_idstring

Unique identifier for this specific delivery attempt (prefixed with HOOK#). Changes with each retry.

event_typestring

Type of event: order.updated, payout.updated, payout.item.updated, or payin.updated. See Webhook Events for available types.

dataobject

Event-specific data. Structure varies by event type (see below).

signatureobject

Signature information for payload verification.

timestampinteger

Unix timestamp (seconds) when this hook was sent.

sent_atstring

ISO 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
payin.updated	data.payin	GET /payins/{id} Get one payin

HTTP Headers

All webhook requests include:

Header	Description
Content-Type	Always application/json
X-Hook-Checksum	Same value as signature.checksum. Use for convenience.

Related Documentation

• Available webhook events
• How to receive webhooks
• Complete example payload
• Signature verification

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