Bank feed

Integrating Airwallex transactions directly into your accounting software streamlines the bookkeeping process by automating data entry. This integration minimizes errors and saves valuable time that would otherwise be spent manually inputting transaction details.

To ingest Airwallex transactions, you will need the following OAuth scopes:

• r:awx_action:balances_view

To build the transaction feed:

1. Read balance history by calling GET /api/v1/balances/history API.

2. Note that this API returns transaction data within a 7-day date range. If you attempt to query transactions beyond this range, you will receive a time_range_exceed error. To access the full transaction history, you can set the page parameter to 0 and use the page_before and page_after fields in the response to navigate through pages of transactions. Additionally, you may also adjust the page_size to return more transactions on a single page.

   Shell
   1curl --request GET \
   2--url 'https://api-demo.airwallex.com/api/v1/balances/history?page=0' \
   3--header 'Authorization: Bearer <your_bearer_token>' \
   4--header 'x-api-version: 2025-08-29' \

3. Additionally, this API call includes reserve transactions that don't affect the account balance. These transactions won't appear in the Airwallex web app wallet transactions or the Balance Activity report. You can filter them out by using the transaction_type field and exclude the following transaction types:

   • PAYMENT_RESERVE_HOLD
   • PAYMENT_RESERVE_RELEASE
   • HOLD
   • HOLD_RELEASE
   • ISSUING_AUTHORISATION_HOLD
   • ISSUING_AUTHORISATION_RELEASE

4. Negate the amount for transactions where source_type is set to PAYMENT_RESERVE.