The Airwallex and Microsoft Business Central connection automates your financial bookkeeping by establishing a direct bank feed between the two platforms. This integration automatically syncs multi-currency transactions and balances directly into Business Central, eliminating manual data entry and streamlining the reconciliation process.
This set up guide covers
- Part 1: Prerequisites – AWX App Installation
- Part 2: Prerequisites – User Permissions
- Part 3: Initiate Connection from Airwallex
- Part 4: Enable Bank Feed Job Queue
Part 1: Prerequisites – AWX App Installation
Before initiating the connection from Airwallex, ensure the Airwallex App is installed in your Microsoft Business Central environment.
Installation via AppSource: In Business Central, navigate to Extension Management and search for "Airwallex", or visit the Microsoft AppSource store directly to complete the installation.
Part 2: Prerequisites – User Permissions
Before initiating the connection from Airwallex, the authorised user must have the correct permission sets in place. Incorrect or missing permissions are the most common cause of setup issues.
Note: You will need an Azure Admin for Microsoft Business Central to assist with this setup. The Azure Admin will have the information needed to complete the steps below.
How to verify and assign permissions
Follow these steps to check and update the permission sets for the relevant user:
- Open the Users list: In Business Central, use the search bar to search for Users and open the Users page.
- Open the relevant User Card: Select the user account configured for the Airwallex integration to open their User Card.
- Review User Permission Sets: Scroll down to the User Permission Sets table. Confirm that the AWX INTEGRATION permission set appear for each company the user needs access to.
- Add any missing permission sets: Click ‘New Line’ to add a missing permission set. Select the permission set name and specify the company if the permission should be scoped to a single company.
Understanding Company-Level Scoping
How you configure the Company column in each permission set row determines the scope of access:
- Company specified (e.g. CRONUS AU): The permission applies only to that specific company. Use this when the user should be restricted to a single entity.
- No company specified (blank): The permission applies to all companies in the environment for this user. Use this for users who need cross-company access.
Note: If your user needs access to multiple companies, it is simpler to leave the Company field blank so the permission applies universally — rather than adding a separate row for each company.
Part 3: Initiate Connection from Airwallex
Once the prerequisites above are complete, initiate the connection from within your Airwallex account.
- Log in to your Airwallex account.
- Navigate to Connections: Select Connections from the left sidebar and search for Business Central.
- Click Connect: Click the Connect button and log in to your Business Central instance when prompted.
- Map Airwallex entities to Business Central companies: Map each Airwallex entity to the corresponding company in Business Central.
- Select currencies to sync: Select the bank accounts in Business Central to match with Airwallex accounts and currencies.
Part 4: Enable Bank Feed Job Queue
The Bank Feed Job Queue is created automatically when the Airwallex app is installed from AppSource, but it remains inactive by default. Consequently, synced transaction data will only appear on the Airwallex Bank Feeds staging page and not on the Bank Account Reconciliation page until you manually enable and schedule the job.
How to Enable the Job Queue
- Search for Job Queue Entries: In Business Central, use the search bar to search for Job Queue Entries and open the list.
- Find the Airwallex Bank Feed entry: Look for the entry named AWX Bank Feed Job Queue with the description Airwallex Bank Feed Processing. Its status will show as ‘On Hold’ by default.
- Open the Job Queue Entry Card: Click the entry to open its detail card. You'll see a banner at the top: "To edit the job queue entry, you must first choose the Set On Hold action." — this confirms the job is currently inactive.
- Configure the recurrence schedule: Under the Recurrence section, toggle on the days you want the job to run and set a value for No. of Minutes between Runs to control how frequently it syncs. See the recommended settings below.
- Set the job to Ready: Once configured, change the Status field from ‘On Hold’ to ‘Ready’. The job will now run automatically on your chosen schedule.
Recommended Settings
Use the following as a starting point. You can adjust based on how frequently your business needs transactions to sync.
| Field | Recommended Value | Notes |
| Recurring Job | On | Must be enabled for the schedule to apply |
| Run on [weekdays] | Mon – Fri (at minimum) | Enable weekends too if you process transactions daily |
| No. of Minutes between Runs | 60 | Set lower (e.g. 15–30) for more frequent syncing |
| Job Timeout | 12 hours | Default — no change needed |
| Status | Ready | Must be set to Ready for the job to run |
Note: You can also use the Starting Time and Ending Time fields to restrict syncing to business hours only — useful if you want to avoid unnecessary background processing overnight.
Verifying the Job is Running
To confirm the job is active and running as expected:
- Return to the Job Queue Entry Card and check that Status shows ‘Ready’.
- Click Log Entries in the top action bar to view a history of past runs and check for any errors.
How to Trigger an Immediate Sync
If you need transactions to appear right away without waiting for the next scheduled run, use the ‘Run Bank Feed Job Queue Job’ button on the Airwallex App Setup page. This is the recommended way to trigger an immediate sync.