{
"event_id": "<string>",
"order": {
"order_id": "prv-9f0e...",
"provider_order_id": "<string>",
"from": "<string>",
"to": "<string>",
"amount_from": "<string>",
"amount_to_expected": "<string>",
"amount_to_actual": "<string>",
"deposit_address": "<string>",
"deposit_extra_id": "<string>",
"payout_address": "<string>",
"failed_reason_message": "<string>",
"refund_window_hours": 123,
"refund_sla_hours": 123,
"tx_in_hash": "<string>",
"tx_out_hash": "<string>",
"expires_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"tracking_url": "<string>",
"timeline": [
{
"status": "<string>",
"at": "2023-11-07T05:31:56Z"
}
]
},
"ts": "2023-11-07T05:31:56Z"
}API Reference
Order lifecycle event
Sent to your registered webhook URL on every order status change.
Signed with HMAC-SHA256 using your webhook secret in header X-Privata-Signature.
Body includes a deterministic event_id used for deduplication.
WEBHOOK
order.event
{
"event_id": "<string>",
"order": {
"order_id": "prv-9f0e...",
"provider_order_id": "<string>",
"from": "<string>",
"to": "<string>",
"amount_from": "<string>",
"amount_to_expected": "<string>",
"amount_to_actual": "<string>",
"deposit_address": "<string>",
"deposit_extra_id": "<string>",
"payout_address": "<string>",
"failed_reason_message": "<string>",
"refund_window_hours": 123,
"refund_sla_hours": 123,
"tx_in_hash": "<string>",
"tx_out_hash": "<string>",
"expires_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"tracking_url": "<string>",
"timeline": [
{
"status": "<string>",
"at": "2023-11-07T05:31:56Z"
}
]
},
"ts": "2023-11-07T05:31:56Z"
}Authorizations
Partner API key issued in the dashboard. Use pk_live_... in production, pk_test_... against sandbox.
Body
application/json
Response
200
Acknowledge with 2xx within 5 s.