Airwallex logo
Airwallex logo

Wallet transfer webhooks (legacy)

This page describes webhooks for the beta released Wallet Transfers API API on API version 2024-02-14 or earlier.

Webhook events

Web app LabelEvent TypeDescription
Transfer to an Airwallex account -> Createdwallet_transfer.createdYou have successfully created the transfer.
Transfer to an Airwallex account -> Processingwallet_transfer.processingThe transfer is under processing by Airwallex.
Transfer to an Airwallex account -> Sentwallet_transfer.sentThe transfer has been sent to the beneficiary.
Transfer to an Airwallex account -> Settledwallet_transfer.settledThe transfer has been received by the beneficiary.
Transfer to an Airwallex account -> Failedwallet_transfer.failedThe transfer has failed after being reviewed by Airwallex.

Webhook examples

Relevant webhook events:

  • wallet_transfer.created
  • wallet_transfer.processing
  • wallet_transfer.sent
  • wallet_transfer.settled
  • wallet_transfer.failed

Payload example:

JSON
1{
2    "accountId":"acct_TOslkS7-MnyXlQuV8Lb4og",
3    "data":Object{...},
4    "id":"86b69f91-06f0-3fe8-8faf-4de58954ca8e",
5    "name":"wallet_transfer.created",
6    "created_at": "2023-05-09T03:38:56+0000"
7}

The data object is the same as the response body of Wallet Transfers API:

JSON
1\{
2  "beneficiary": {
3    "account_name": "Lueilwitz-Price",
4    "account_number": "20599530027050"
5  \},
6  "created_at": "2023-05-09T03:38:56+0000",
7  "reason": "investment_proceeds",
8  "reference": "reference123abc",
9  "request_id": "81f5b4d8-5e7d-41df-a846-6124d0db8cb7",
10  "short_reference_id": "T230509-NYH1XWO",
11  "status": "CREATED",
12  "transfer_amount": "100",
13  "transfer_currency": "USD",
14  "wallet_transfer_id": "e9bbd0c0-e41f-419b-ae91-dee5144aee79"
15}
16
Was this page helpful?