Exchange

Receive FX order creation or FX order status updates.

You can expect to receive webhook events whenever a FX order is created or its status is updated.

Event Category:

  • MULTI_CURRENCY_ACCOUNT

Event Type:

  • MULTI_CURRENCY_ACCOUNT.EXCHANGE

Event Action:

  • CREATE
  • UPDATE

Example webhook event

The data object is expected to have the same structure as the response from the the Retrieve a fx order endpoint.

{
    "id": "dc93b3d3-ae96-4bd6-848f-7e96adb0082f",
    "createdAt": "2025-02-11T15:23:59.811266+00:00",
    "updatedAt": "2025-02-11T15:24:02.604+00:00",
    "requestId": "bf068b04-66cb-4658-b84d-7ecea493de85",
    "userId": "7a8ac012-f5e7-45e0-bda5-851f542b2e01",
    "rateId": "736c17bd-fcb1-4bb5-ad9b-76d74d7f8ca0",
    "source": {
        "amount": 10,
        "currency": "USD"
    },
    "destination": {
        "amount": 9.62,
        "currency": "EUR"
    },
    "reference": null,
    "status": "SUCCESS",
    "failedReason": ""
}