Skip to main content
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

​
Authorization
string
header
required

API key sent in the Authorization header.

Headers

​
X-Signature
string
required

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_updated
object
required

Order representation for WebSocket messages

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.