Transfer

Receive payout transfer order creation or transfer status updates.

Webhook events will be triggered whenever a payout transfer order is created or its status is updated.

Event Category:

  • MULTI_CURRENCY_ACCOUNT

Event Type:

  • MULTI_CURRENCY_ACCOUNT.TRANSFER.CREATE
  • MULTI_CURRENCY_ACCOUNT.TRANSFER.UPDATE

Example webhook event

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

{
  eventId: 'evt_195716dcbe114d0aa7',
  eventCategory: 'MULTI_CURRENCY_ACCOUNT',
  eventType: 'MULTI_CURRENCY_ACCOUNT.TRANSFER.UPDATE',
  eventAction: 'UPDATE',
  data: {
    id: '748956e4-0ca6-4da9-88af-5b7288cc3a95',
    fee: { 
      amount: 0, 
      currency: 'USD' 
    },
    gpi: null,
    pobo: true,
    rate: null,
    type: 'PAYOUT',
    refund: null,
    remark: null,
    source: {
      amount: 1000,
      userId: '42c784f4-eb84-4e87-b0de-8c2183aed67c',
      currency: 'USD'
    },
    status: 'COMPLETED',
    purpose: '1001',
    createdAt: '2025-03-07T16:26:12.784366+00:00',
    feeBearer: 'OUR',
    reference: 'refer',
    requestId: '748956e4-0ca6-4da9-88af-5b7288cc3a95',
    updatedAt: '2025-03-07T16:26:15.275+00:00',
    description: null,
    destination: {
      amount: 1000,
      userId: null,
      currency: 'USD',
      recipientId: '9fe80b3f-b7d4-4ea9-a3c3-745808e332e6'
    },
    failedReason: null,
    paymentMethod: 'CROSS-BORDER',
    paymentNetwork: 'SWIFT'
  },
  createdAt: '2025-03-07T16:26:16.015Z',
  timestamp: '2025-03-07T16:26:18.182Z',
  version: 'v2'
}