Search...
Log inGet started
Airwallex logo
Home
Core API
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewHow Airwallex Payouts work
Payout network
Use cases
Beneficiaries
Create beneficiariesValidate a beneficiaryRetrieve beneficiariesManage beneficiaries
Using API and form schemas Embedded Beneficiary component
Test and go live
Older API versions

Manage beneficiaries

You can perform the following operations on beneficiaries after you have created them.

Update a beneficiary

After a beneficiary is created, you can call Update existing beneficiary API to update the saved beneficiary information. Specify the beneficiary_id in the endpoint URL and any parameters you wish to update in your request body. The same schema validation and response body as in Create a new beneficiary API will apply.

Example request

Shell

If you are registered as a platform account, you can call this endpoint on behalf of your connected accounts by specifying the open ID in the x-on-behalf-of header.

Delete a beneficiary

Call Delete existing beneficiary API to delete a beneficiary. Specify the beneficiary_id in the endpoint URL. A successful deletion returns true in the response.

Example request

Shell

If you are registered as a platform account, you can call this endpoint on behalf of your connected accounts by specifying the open ID in the x-on-behalf-of header.

On this page
  • Update a beneficiary
  • Delete a beneficiary