Order updated

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

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.

User Authentication

Ramp API

Lookup API

Authorizations

Headers

Body

Response