{
"order_updated": {
"orderId": "7b9c1e2d-3f4a-5b6c-7d8e-9f0a1b2c3d4e",
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"createdAt": "2026-05-02T09:15:00Z",
"updatedAt": "2026-05-02T09:16:30Z",
"amountInFiat": "1000.00",
"amountInTokens": "58.42",
"walletId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"bankAccountId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"depositClabe": "646180157000000004",
"depositBankName": "Example Bank",
"depositAccountHolder": "Etherfuse MX",
"orderType": "onramp",
"status": "completed",
"statusPage": "https://pay.etherfuse.com/order/7b9c1e2d-3f4a-5b6c-7d8e-9f0a1b2c3d4e",
"confirmedTxSignature": "5KtPn1...",
"trackingCode": "2025011540014000000012345678",
"sourceAsset": "MXN",
"targetAsset": "CETES",
"blockchain": "solana",
"exchangeRate": "17.12",
"etherfuseMidMarketRate": "17.15",
"feeBps": 20,
"feeAmountInFiat": "2.00"
}
}Webhook Events
Order updated
Fired when an onramp or offramp order changes status.
Statuses: created → funded → completed (or failed, refunded, canceled). Offramp orders additionally emit finalized after the reversal window closes.
The X-Signature header contains an HMAC-SHA256 signature over the RFC 8785-canonicalized JSON body. See Verifying Webhooks.
WEBHOOK
orderUpdated
{
"order_updated": {
"orderId": "7b9c1e2d-3f4a-5b6c-7d8e-9f0a1b2c3d4e",
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"createdAt": "2026-05-02T09:15:00Z",
"updatedAt": "2026-05-02T09:16:30Z",
"amountInFiat": "1000.00",
"amountInTokens": "58.42",
"walletId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"bankAccountId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"depositClabe": "646180157000000004",
"depositBankName": "Example Bank",
"depositAccountHolder": "Etherfuse MX",
"orderType": "onramp",
"status": "completed",
"statusPage": "https://pay.etherfuse.com/order/7b9c1e2d-3f4a-5b6c-7d8e-9f0a1b2c3d4e",
"confirmedTxSignature": "5KtPn1...",
"trackingCode": "2025011540014000000012345678",
"sourceAsset": "MXN",
"targetAsset": "CETES",
"blockchain": "solana",
"exchangeRate": "17.12",
"etherfuseMidMarketRate": "17.15",
"feeBps": 20,
"feeAmountInFiat": "2.00"
}
}Authorizations
API key sent in the Authorization header.
Headers
HMAC-SHA256 signature: sha256={hex}. Computed over the canonicalized (RFC 8785) request body using your webhook secret.
Body
application/json
Webhook envelope for order status changes. The payload is keyed by event name.
Order representation for WebSocket messages
Show child attributes
Show child attributes
Example:
{
"amountInFiat": "1000.00",
"amountInTokens": "58.42",
"bankAccountId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"blockchain": "stellar",
"completedAt": "2026-05-02T09:16:30Z",
"createdAt": "2026-05-02T09:15:00Z",
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"depositAccountHolder": "Etherfuse MX",
"depositBankName": "Example Bank",
"depositClabe": "646180157000000004",
"etherfuseMidMarketRate": "17.15",
"exchangeRate": "17.12",
"feeAmountInFiat": "2.00",
"feeBps": 20,
"orderId": "7b9c1e2d-3f4a-5b6c-7d8e-9f0a1b2c3d4e",
"orderType": "onramp",
"sourceAsset": "MXN",
"status": "completed",
"statusPage": "https://pay.etherfuse.com/order/7b9c1e2d-3f4a-5b6c-7d8e-9f0a1b2c3d4e",
"stellarClaimTransaction": "AAAAAgAAAABk...base64_xdr...",
"stellarClaimableBalanceId": "00000000abc1230000000000000000000000000000000000000000000000000000",
"targetAsset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
"updatedAt": "2026-05-02T09:16:30Z",
"walletId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}
Response
200
Return any 2xx to acknowledge receipt. Process the event asynchronously — a slow handler triggers retries.