Transfer

Receive payout transfer order creation or transfer status updates.

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

Event Category:

  • MULTI_CURRENCY_ACCOUNT

Event Type:

  • MULTI_CURRENCY_ACCOUNT.TRANSFER

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 fiat transfer endpoint.

{
    "id": "ba1ed885-30f3-427d-a5f1-0404db7fef89",
    "createdAt": "2025-02-14T22:21:02.280578+00:00",
    "updatedAt": "2025-02-14T22:21:06.024+00:00",
    "requestId": "ba1ed885-30f3-427d-a5f1-0404db7fef89",
    "type": "PAYOUT",
    "status": "PENDING",
    "description": null,
    "paymentMethod": "CROSS-BORDER",
    "paymentNetwork": "SWIFT",
    "source": {
        "userId": "0e965562-047c-43ae-9481-fd894f7e6706",
        "amount": 11,
        "currency": "USD"
    },
    "destination": {
        "amount": 10,
        "currency": "USD",
        "recipientId": "6e6316b0-630f-4775-9f6c-21bc4a0bd0fe",
        "userId": null
    },
    "rateId": null,
    "feeBearer": "OUR",
    "purpose": "1001",
    "gpi": null,
    "failedReason": null,
    "remark": null
}