{
"event": "orderUpdated",
"eventId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"occurredAt": "2023-11-07T05:31:56Z",
"order": {
"id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",
"organizationId": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
"status": "created",
"memo": "Invoice 1042",
"source": {
"paymentAccountId": "3f9a2c1e-5b7d-4e8f-9a01-2b3c4d5e6f70",
"amount": "1000",
"asset": "MXN",
"rail": "spei",
"accountLabel": "Operating account"
},
"destination": {
"paymentAccountId": "8c1d2e3f-4a5b-4c6d-8e7f-901a2b3c4d5e",
"amount": "54.120000",
"asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
"rail": "stellar",
"accountLabel": "Treasury wallet"
},
"fees": [
{
"type": "transactionFee",
"amount": "2.50",
"asset": "MXN",
"bps": 25
}
],
"fundingInstructions": {
"rail": "spei",
"reference": "1000042",
"destination": {
"expiresAt": null,
"clabe": "646180000000000009",
"bankName": "Ejemplo Banco",
"recipientName": "Ejemplo Receptor"
},
"fundingDeadline": "2026-09-29T17:05:02Z"
},
"claimInstructions": null,
"createdAt": "2026-09-28T17:05:02.114Z",
"updatedAt": "2026-09-28T17:05:02.114Z",
"completedAt": null
}
}Webhook Events
orderUpdated
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
{
"event": "orderUpdated",
"eventId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"occurredAt": "2023-11-07T05:31:56Z",
"order": {
"id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",
"organizationId": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
"status": "created",
"memo": "Invoice 1042",
"source": {
"paymentAccountId": "3f9a2c1e-5b7d-4e8f-9a01-2b3c4d5e6f70",
"amount": "1000",
"asset": "MXN",
"rail": "spei",
"accountLabel": "Operating account"
},
"destination": {
"paymentAccountId": "8c1d2e3f-4a5b-4c6d-8e7f-901a2b3c4d5e",
"amount": "54.120000",
"asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
"rail": "stellar",
"accountLabel": "Treasury wallet"
},
"fees": [
{
"type": "transactionFee",
"amount": "2.50",
"asset": "MXN",
"bps": 25
}
],
"fundingInstructions": {
"rail": "spei",
"reference": "1000042",
"destination": {
"expiresAt": null,
"clabe": "646180000000000009",
"bankName": "Ejemplo Banco",
"recipientName": "Ejemplo Receptor"
},
"fundingDeadline": "2026-09-29T17:05:02Z"
},
"claimInstructions": null,
"createdAt": "2026-09-28T17:05:02.114Z",
"updatedAt": "2026-09-28T17:05:02.114Z",
"completedAt": null
}
}Authorizations
API key sent in the Authorization header, with no Bearer prefix.
Headers
HMAC-SHA256 signature: sha256={hex}. Computed over the canonicalized (RFC 8785) request body using your subscription's secret.
Body
application/json
Allowed value:
"orderUpdated"Unique per event. Use it to drop duplicate deliveries.
Show child attributes
Show child attributes
Example:
{ "id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b", "organizationId": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d", "status": "created", "memo": "Invoice 1042", "source": { "paymentAccountId": "3f9a2c1e-5b7d-4e8f-9a01-2b3c4d5e6f70", "amount": "1000", "asset": "MXN", "rail": "spei", "accountLabel": "Operating account" }, "destination": { "paymentAccountId": "8c1d2e3f-4a5b-4c6d-8e7f-901a2b3c4d5e", "amount": "54.120000", "asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN", "rail": "stellar", "accountLabel": "Treasury wallet" }, "fees": [ { "type": "transactionFee", "amount": "2.50", "asset": "MXN", "bps": 25 } ], "fundingInstructions": { "rail": "spei", "reference": "1000042", "destination": { "expiresAt": null, "clabe": "646180000000000009", "bankName": "Ejemplo Banco", "recipientName": "Ejemplo Receptor" }, "fundingDeadline": "2026-09-29T17:05:02Z" }, "claimInstructions": null, "createdAt": "2026-09-28T17:05:02.114Z", "updatedAt": "2026-09-28T17:05:02.114Z", "completedAt": null }
Response
200
Return any 2xx to acknowledge the delivery.