Transfers

Subscribe to webhook events for transfer and batch transfer status changes.

The following webhook events are available for your Payouts integration.

Transfers

This section describes transfer webhooks for the latest API version. For older API versions, see transfer webhooks (older versions).

Event	Description
payout.transfer.in_approval	The transfer is submitted and waiting for approval. Approvers can review the transfer in the web app.
payout.transfer.approval_recalled	Transfer is recalled by a user through the web app.
payout.transfer.approval_rejected	Transfer is rejected by an approver through the web app.
payout.transfer.approval_blocked	Transfer is blocked as the next approver cannot be found.
payout.transfer.scheduled	The transfer is scheduled to be processed on the transfer date if it is funded and passes review by Airwallex.
payout.transfer.overdue	The transfer has not been funded by the scheduled date.
payout.transfer.processing	The transfer is funded and being processed.
payout.transfer.sent	The transfer has been sent from Airwallex.
payout.transfer.paid	The transfer has been processed successfully by our banking partner.
payout.transfer.failed	The transfer has failed our banking partner's processing or was rejected by the recipient bank.
payout.transfer.cancellation_requested	Transfer cancellation has been requested before `SENT`.
payout.transfer.cancelled	The transfer has been successfully cancelled. Funds will be returned to the Wallet.
payout.transfer.funding.requires_funding_confirmation	The funding of this transfer requires your confirmation.
payout.transfer.funding.scheduled	The funding is scheduled to be processed on the transfer date.
payout.transfer.funding.processing	The funding for this transfer is being processed.
payout.transfer.funding.funded	This transfer is successfully funded.
payout.transfer.funding.failed	This transfer failed to be funded.
payout.transfer.funding.cancelled	The funding for this transfer has been cancelled.
payout.transfer.funding.reversed	The funding status has been updated to `REVERSED` and the corresponding amount has been deducted from your Wallet balance.

Batch transfers

This section describes transfer webhooks for the latest API version. For older API versions, see batch transfer webhooks (older versions).

Event	Description
payout.batch_transfers.drafting	The batch transfer is being drafted.
payout.batch_transfers.in_approval	The batch transfer is submitted for approval.
payout.batch_transfers.approval_recalled	The batch transfer is recalled by a user in the web app.
payout.batch_transfers.approval_rejected	The batch transfer is rejected by an approver in the web app.
payout.batch_transfers.approval_blocked	Batch transfer is blocked as next approver cannot be found.
payout.batch_transfers.scheduled	The batch transfer is scheduled and will be processed to book transfers once it is funded.
payout.batch_transfers.overdue	The batch transfer has not been funded beyond the scheduled date.
payout.batch_transfers.booking	The batch transfer is being processed to book transfers.
payout.batch_transfers.partially_booked	Some items in the batch failed to be booked.
payout.batch_transfers.booked	All valid items in the batch transfer has been booked.
payout.batch_transfers.failed	The batch transfer failed to be booked.
payout.batch_transfers.cancellation_requested	Batch transfer cancellation has been requested before `BOOKING`.
payout.batch_transfers.cancelled	The batch transfer has been successfully cancelled.
payout.batch_transfers.funding.scheduled	The funding is scheduled to be processed on the transfer date.
payout.batch_transfers.funding.processing	The funding for this batch transfer is being processed.
payout.batch_transfers.funding.funded	This batch transfer is successfully funded.
payout.batch_transfers.funding.cancelled	The funding for this batch transfer is cancelled.
payout.batch_transfers.funding.failed	Deposit via direct debit from a Linked Account is rejected.
payout.batch_transfers.funding.reversed	The funding status has been updated to `REVERSED` and the corresponding amount has been deducted from your Wallet balance.

Payload examples

Transfers

Relevant webhook events:

payout.transfer.in_approval
payout.transfer.scheduled
payout.transfer.overdue
payout.transfer.processing
payout.transfer.sent
payout.transfer.failed
payout.transfer.paid
payout.transfer.cancellation_requested
payout.transfer.cancelled

Payload example:

The data object is the same as the response body of Get transfer by ID API. See example below.

JSON

1{
2  "id": "afcee0a3-ea9d-4ce7-88d2-c92f971a6e24",
3  "name": "payout.transfer.scheduled",
4  "account_id": "acct_T_DLJt7NMEKmDaH9gjywcg",
5  "data": {
6    "amount_beneficiary_receives": 50,
7    "amount_payer_pays": 68.14,
8    "beneficiary": {
9      "additional_info": {
10        "personal_email": "[email protected]"
11      },
12      "address": {
13        "city": "Seattle",
14        "country_code": "US",
15        "postcode": "98104",
16        "state": "Alaska",
17        "street_address": "412 5th Avenue"
18      },
19      "bank_details": {
20        "account_currency": "USD",
21        "account_name": "John Walker",
22        "account_number": "50001121",
23        "account_routing_type1": "aba",
24        "account_routing_value1": "021000021",
25        "bank_account_category": "Checking",
26        "bank_country_code": "US",
27        "bank_name": "JP Morgan Chase Bank",
28        "local_clearing_system": "ACH"
29      },
30      "company_name": "Complete Concrete Pty Ltd",
31      "entity_type": "COMPANY",
32      "type": "BANK_ACCOUNT"
33    },
34    "conversion": {
35      "currency_pair": "USDSGD",
36      "rate": 1.285682
37    },
38    "created_at": "2025-07-09T15:41:50+0000",
39    "fee_amount": 3.86,
40    "fee_currency": "SGD",
41    "fee_paid_by": "PAYER",
42    "funding": {
43      "status": "SCHEDULED"
44    },
45    "id": "43217eec-6053-4fe6-b760-6a0d29bf9d51",
46    "lock_rate_on_create": true,
47    "payer": {
48      "additional_info": {
49        "business_incorporation_date": "2024-03-04",
50        "business_registration_number": "HK-575-92-5785",
51        "business_registration_type": "COMPANY"
52      },
53      "address": {
54        "city": "Melbourne",
55        "country_code": "HK",
56        "postcode": "3000",
57        "state": "VIC",
58        "street_address": "Melbourne St, Melbourne St"
59      },
60      "company_name": "Complete Concrete Pty Ltd",
61      "entity_type": "COMPANY"
62    },
63    "prepayment": {
64      "amount": 3.22,
65      "currency": "SGD"
66    },
67    "reason": "travel",
68    "reference": "PMT1936398",
69    "remarks": "",
70    "request_id": "133f6801-0dfe-40a6-9d74-2d1c4b9a89ea",
71    "short_reference_id": "P250709-K61UKW4",
72    "source_currency": "SGD",
73    "status": "SCHEDULED",
74    "swift_charge_option": "SHARED",
75    "transfer_amount": 50,
76    "transfer_currency": "USD",
77    "transfer_date": "2025-07-25",
78    "transfer_method": "LOCAL",
79    "updated_at": "2025-07-09T15:41:50+0000"
80  },
81  "created_at": "2025-07-09T15:41:51+0000",
82  "version": "2025-06-30"
83}

You can also find payload examples of legacy API versions from the Example Response of Get transfer by ID API.

Batch transfers

Relevant webhook events:

payout.batch_transfers.drafting
payout.batch_transfers.in_approval
payout.batch_transfers.approval_recalled
payout.batch_transfers.approval_rejected
payout.batch_transfers.approval_blocked
payout.batch_transfers.scheduled
payout.batch_transfers.overdue
payout.batch_transfers.booking
payout.batch_transfers.partially_booked
payout.batch_transfers.booked
payout.batch_transfers.failed
payout.batch_transfers.cancellation_requested
payout.batch_transfers.cancelled
payout.batch_transfers.funding.scheduled
payout.batch_transfers.funding.processing
payout.batch_transfers.funding.funded
payout.batch_transfers.funding.cancelled
payout.batch_transfers.funding.failed
payout.batch_transfers.funding.reversed

Payload example:

JSON

1{
2  "id": "2a396f97-92f4-3075-98fa-43acf6e87412",
3  "name": "payout.batch_transfers.funding.funded",
4  "account_id": "acct_t6nlGSCgPpWIBE-3ncOTxA",
5  "data": {
6    "funding": {
7      "deposit_type": "DIRECT_DEBIT",
8      "funding_source_id": "ff621b96-9ee9-4429-9dd7-9defef411d11",
9      "status": "FUNDED"
10    },
11    "id": "378e0df8-2c64-460b-921a-9ee69fdd38cd",
12    "metadata": {
13      "id": "5"
14    },
15    "name": "batch-name",
16    "quote_summary": {
17      "expires_at": "2024-03-04T03:09:05+0000",
18      "last_quoted_at": "2024-03-04T03:06:05+0000",
19      "quotes": [
20        {
21          "amount_beneficiary_receives": 100,
22          "amount_payer_pays": 100,
23          "fee_amount": 0,
24          "fee_currency": "AUD",
25          "transfer_currency": "AUD",
26          "source_currency": "AUD"
27        },
28        {
29          "amount_beneficiary_receives": 200,
30          "amount_payer_pays": 308.12,
31          "client_rate": 0.649109,
32          "currency_pair": "AUDUSD",
33          "fee_amount": 0,
34          "fee_currency": "AUD",
35          "transfer_currency": "USD",
36          "source_currency": "AUD"
37        }
38      ],
39      "validity": "MIN_15"
40    },
41    "remarks": "Any information",
42    "request_id": "8be90dda-cce4-4c70-b5b8-bcff408f599f",
43    "short_reference_id": "B240304-3GK4EPI",
44    "status": "SCHEDULED",
45    "total_item_count": 4,
46    "transfer_date": "2024-03-04",
47    "updated_at": "2024-03-04T03:06:05+0000",
48    "valid_item_count": 3
49  },
50  "created_at": "2024-03-20T09:05:54+0000",
51  "version": "2024-09-27"
52}

Was this page helpful?