How to integrate Xero with Airwallex: Bank feed setup, bills, and multi-currency reconciliation

Taylor Whitfield
Canadian Business Finance Writer, Billing and Integration

Key takeaways
Cross-border B2B payment flows reached US$30.2 trillion in 2023 and are projected to hit US$56 trillion by 2030, which means more foreign-currency activity lands on the general ledger every year.1
Integrating Xero with Airwallex means connecting up to four modules from the Airwallex Connections page (Bank Feed, Expenses and Bills, Invoice Payment, and Payments Feed) and mapping each currency wallet to its own Xero bank account.
Airwallex Global Accounts offer multi-currency accounts that feed into Xero by currency. This ensures that deposits, conversions, payouts, card spend, and bill payments reach the correct ledger without manual CSV imports.
Integrating Xero with Airwallex can shave days off month-end close. Once connected, every Airwallex currency wallet becomes a live bank feed in Xero, bills sync in both directions, and gross online payments post with fees transparently broken out. This guide covers the setup for each module, the reconciliation workflows for bills and FX, and troubleshooting tips for the most common connector errors.
What is a Xero Airwallex integration?
A Xero Airwallex integration connects an Airwallex account directly to a Xero organization. It pushes transaction data from Airwallex into Xero. Additionally, it pulls accounting data such as chart of accounts, tax rates, tracking categories, and contacts from Xero into Airwallex.
The Xero App Store lists the integration, giving finance teams visibility into financial activities within Xero's general ledger (GL).2 Airwallex builds and maintains the integration, requiring users to perform all setup tasks from the Airwallex web app.
For Canadian businesses running Xero, the main benefit is structure. Instead of one bank account that mixes CAD, USD, and EUR activity, each currency in an Airwallex Global Account maps to its own Xero bank account, which keeps reconciliation and FX reporting clean.
How does Airwallex integrate with Xero?
The Airwallex integration with Xero includes four separate modules. Each one requires an independent connection from the Xero tile on the Airwallex Connections page, allowing teams to add them one at a time.
Bank feed module
The bank feed syncs every transaction that affects an Airwallex account balance: deposits, conversions, payouts, card transactions, and adjustments. Airwallex creates a separate Xero bank account for each currency, because a Xero bank account can only hold one currency.
Card transactions include the company name or employee cardholder name plus the last four digits of the card in the reference field. These details make it easy to create Xero bank rules that auto-code recurring spend to the right GL account.
Spend module for bills and card expenses
The Expenses and Bills module imports the Xero chart of accounts along with up to two tracking categories, tax rates, and contacts into Airwallex. Employees and AP teams then code expenses and bills against real Xero values before anything syncs back.
Approved bills sync to Xero with line items, taxes, categories, comments, and the original invoice attached. This module shares its entity and currency mappings with the bank feed.
Invoice payment module
The Invoice Payment module adds an Airwallex checkout link in Xero invoices for customers to pay by card or local payment methods. The payment is automatically attached to the invoice and a receipt goes to the payer.
Payments feed module for net-to-gross reconciliation
The Payments Feed posts an itemized breakdown of online payments activity (sales, refunds, and fees associated with gateway, fraud, and payment method) into a dedicated Airwallex Payments - {CCY} bank account in Xero. It works with Airwallex payment links, eCommerce plugins, and online payment processing products.
Without this module, the bank feed only shows a single batch settlement line, requiring a net-to-gross calculation. With it, teams can record revenue at gross and fees as an expense.
Stop reconciling by hand
Airwallex syncs your payments, cards, and bills with your ERP automatically, so your team can focus on growth.
Requirements for Airwallex to Xero integration
Confirm these requirements before connecting:
An active Airwallex account: Sign up here
The right Airwallex user role: Owner, Admin, or Finance Admin
Xero access to the target organization
A Xero plan that supports multiple currencies: In Canada, multi-currency is included only on Xero's Premium plan, listed at C$80 per month (plus applicable taxes)3
One-to-one entity mapping: Each Xero organization can be mapped to only one Airwallex entity
Online payment approval on Airwallex (for invoice payments)
How to set up the Xero Airwallex bank feed
The bank feed forms the foundation for every other module. After configuring the bank feed, layer on bills and payments.
1. Connect Airwallex to Xero and authorize access
Log in to Airwallex, select Settings, then Connections. Select the Xero tile, click See details on the Bank Feed tile, and click Connect.
Sign in to Xero when prompted, choose the organization (or organizations) to connect from the dropdown, and approve the requested permissions. Then map each Airwallex entity to its matching Xero organization and click Continue.
2. Map each currency wallet to a new or existing Xero bank account
Select the Airwallex currencies to sync. Accounts with prior Airwallex activity are pre-selected, and Airwallex recommends connecting every currency the business might transact in later.
For each currency, choose an existing Xero bank account in that currency or let Airwallex create a new one. New accounts follow the naming convention AWX_{account nickname}_{currency}, which helps prevent duplicate names. Renaming these accounts in Xero is possible but not recommended.
3. Confirm the sync schedule and 4-hour settlement buffer
Review the mapping and click Complete. Automated syncing happens hourly (with up to a 1–6 hour lag depending on the four-hour settlement buffer). To protect data accuracy, transactions from the most recent four hours are excluded from each sync.
4. Backfill transaction history with the initial and manual syncs
When enabling a currency for the first time, Airwallex backfills the last seven days of transactions, which can take up to six hours to complete. The automated sync includes no more than 90 days prior if a feed has been inactive. For older history, select Sync older transactions to pull up to 365 days for a chosen currency and date range.
How to sync billing between Xero and Airwallex
Connecting Airwallex Bill Pay to Xero puts coding, approvals, and bill payment in one place while Xero serves as the source of truth. Set it up from the Expenses and Bills tile on the Xero connections page.
Syncing the chart of accounts, tax rates, tracking categories, and suppliers
During setup, Airwallex imports the Xero chart of accounts, up to two tracking categories, tax rates (such as GST, HST, PST, or QST), and contacts.
Vendors entered in Airwallex map to Xero contacts. If a vendor doesn't exist in Xero yet, a new contact is created when the bill syncs.
Paying Xero bills from Airwallex
Bills already entered in Xero can be imported into Airwallex for payment. Imported bills arrive with an Awaiting payment status and skip the Airwallex approval flow.
When a transfer fully covers the bill and completes, the bill status changes to Paid in both Airwallex and Xero automatically. Partial payments keep the bill in Awaiting payment until the balance is cleared.
Creating, coding, and approving bills in Airwallex
Bills can also start in Airwallex. Upload the vendor invoice, code each line, and route it for approval. Only fully approved bills sync to Xero, where they appear as Awaiting payment with every detail populated.
If a bill is in a currency other than the Xero base currency, Xero applies its own conversion rate. The original invoice file is attached to the Xero bill, which keeps the audit trail in one place.
Reconciling batch bill payments with Find & Match
When Airwallex marks a bill as paid, Xero records the payment against the mapped Airwallex bank account. The matching bank feed line then syncs with that payment for a one-click reconciliation.
If a single bank feed line covers several bill payments, open the line in Xero's reconcile screen and use Find & Match to select every payment it includes. The totals must align before Xero reconciles the line.
Every global transaction, right in your ERP
Airwallex brings multi-currency payments and spend into your ERP as they happen. No spreadsheets, no re-keying.
How to integrate Xero invoice payments with Airwallex
Invoice Payment turns Xero invoices into payable checkout pages backed by Airwallex Payments. See the note on current regional availability.
Adding Pay now links to Xero branding themes
During setup, select the Xero branding themes that should use Airwallex as the default payment service. Every invoice created with those themes includes an Airwallex checkout page showing the invoice amount, invoice number, and merchant name.
The Xero organization must be the same one connected to the bank feed. Branding theme preferences can be changed later in Xero settings.
How the invoices and online payments clearing accounts work
When a customer pays, the payment posts to the invoice and to an AWX - {CCY} Invoices account in Xero, where {CCY} is the invoice currency. That account acts as a clearing account until the funds settle.
After settlement, the Payments Feed account (Airwallex Payments - {CCY}) shows each transaction with its fees. The bank feed account then shows the net batch settlement.
Recording processing fees and clearing both accounts to zero
In the Payments Feed account, transfer each payment amount to the AWX - {CCY} Invoices account. Matching references means Xero usually suggests the match automatically.
Next, code Airwallex fees and surcharges to an expense account. Finally, reconcile the batch settlement as a transfer to the bank feed account (AWX_{nickname}_{currency}), reducing both clearing accounts back to zero.
How does Xero multi-currency reconciliation work with Airwallex?
Multi-currency reconciliation with Airwallex works because each multi-currency account has its own Xero bank account. Xero calculates FX differences between those accounts and the base currency.
Reconciling conversions between Airwallex multi-currency accounts
A conversion made with Airwallex FX & Transfers appears in Xero as a Spend money line in the sell currency and a Receive money line in the buy currency. Each lands in its own currency's bank account.
Reconcile both lines as a single transfer between the two bank accounts, entering the amount sent and the amount received. Xero records any difference against its own exchange rate as a currency gain or loss.
Realized vs unrealized FX gains and losses
A realized gain or loss is recorded once a foreign-currency transaction settles, while an unrealized gain or loss reflects the value of an open balance at period end.4 In Xero, settled invoices, bills, and transfers generate realized amounts automatically.
Open foreign-currency balances, including Airwallex account balances held in Xero, are revalued at current rates, which produces unrealized amounts. Unreconciled lines don't revalue correctly, meaning FX reporting is only as accurate as the bank reconciliation behind it.
Settling a foreign currency bill from a third currency
Consider a Canadian company that owes a supplier €10,000 but pays from its GBP balance. Airwallex converts GBP to EUR and pays the supplier. The bank feed then shows GBP spent, EUR received, and a EUR payout.
Reconcile the conversion as a transfer from the GBP account to the EUR account. Then match the EUR payout to the EUR bill, and Xero posts the realized FX difference in CAD.
Month-end controls
Before closing the period, confirm every Airwallex bank account in Xero shows zero unreconciled lines and that both invoice clearing accounts net to zero. Xero's Bank Reconciliation Summary report will flag missing, deleted, or duplicated transactions when balances don't match.4
Then compare each Xero bank account balance with the matching Airwallex account balance at the same cutoff, allowing for the four-hour sync buffer. After all lines reconcile, generate the foreign currency gains and losses report last.
Go global without changing your finance stack
Airwallex connects to the ERP you already use, so growing across borders doesn’t mean starting over.
How to troubleshoot the Airwallex Xero connector
Most connector issues come from changes made in Xero after setup. Here are fixes for the common issues.
Duplicate bank account names
This error appears when choosing Create new Xero bank account during mapping and an archived Xero bank account already uses that name, preventing duplicates. To fix it, either restore the archived account in Xero and retry, or select a different active bank account from the dropdown on the Airwallex mapping page.
The Existing feed connection error
This means the chosen Xero bank account already has another bank feed attached. In Xero, go to Accounting > Bank Accounts, open the account, select Manage Account > Edit Account details, clear the Your Bank field, and enter AWX. Alternatively, map the Airwallex currency to a different Xero bank account.
Broken syncs: Refresh the connection instead of disconnecting
If transactions stop syncing, don't click Disconnect. Open the Xero Bank Feed tile in Airwallex Connections, select Refresh connection, and reconnect the affected Xero organization.
If the mapped Xero bank account was archived, restore it in Xero and re-save the existing mapping in Airwallex. If it was deleted, edit the mapping and select a different Xero bank account.
Missing historical transactions
Transactions dated before a feed was first activated don't sync automatically. Use Sync older transactions to choose a currency, start date, and end date within the past 365 days. Anything older than that can't be synced through the feed, because Xero bank feeds accept statements only within that window.
Outdated invoice payment services in Xero
Disconnecting Invoice Payment in Airwallex doesn't remove the payment service from Xero. A leftover service can stay attached to branding themes and cause confusion on new invoices.
In Xero, go to Business > Online Payments, click Manage connected services, find Airwallex under Connected Payment Services, and click Remove. Then check each branding theme for stale payment settings.
Why Xero customers choose Airwallex
Xero handles the accounting. Airwallex provides the global financial infrastructure underneath it, with accounts, payments, and spend data that reach Xero by currency.
Multi-currency accounts that feed Xero by currency
Airwallex multi-currency accounts give businesses local account details in 20+ currencies to receive funds from customers in more than 70 countries. There are no account opening fees, monthly maintenance charges, or minimum transaction requirements.
Each currency held in Airwallex becomes its own Xero bank account, avoiding double conversions and reducing both FX costs and FX reconciliation lines.
Bill pay, cards, and online payments in one ledger
Bills, corporate card spend, and online payment settlements all flow through the same Airwallex account and the same Xero bank accounts. One mapping covers AP, expenses, and receivables.
Businesses that outgrow Xero can keep the same structure, because Airwallex also supports a NetSuite integration. Find more details about setup on the Airwallex Xero integration page, or open an Airwallex account to connect multi-currency bank feeds to Xero, automate vendor bills, and cut manual reconciliation across global ledgers.
Separate business and personal expenses with a zero-monthly-fee account.
Organize finances from day one to speed up tax season and month-end close.
Frequently asked questions about integrating Xero with Airwallex
How long does it take for Airwallex transactions to sync to Xero?
Airwallex transactions take roughly 1-6 hours to sync to Xero. The automated sync runs hourly and excludes the most recent four hours of activity, while the first backfill for a new currency can take up to six hours.
Can I connect multiple Airwallex accounts or business entities to one Xero organization?
No, you can’t connect multiple Airwallex accounts or business entities to one Xero organization because each Xero organization can only be mapped to one Airwallex entity. Within that entity, multiple currencies within Airwallex accounts each map to their own Xero bank accounts, but a multi-entity group needs one Xero organization per entity.
Do I need a multi-currency Xero plan to connect Airwallex?
Yes, you need a multi-currency Xero plan to connect to Airwallex if you want feeds for more than one currency. Xero plans without multi-currency features included only support bank feeds in the home currency. In Canada, multi-currency is included with Xero’s Premium plan.
What should I do if my Airwallex transactions stop syncing to Xero?
If Airwallex transactions stop syncing to Xero, click Refresh connection on the Xero Bank Feed tile rather than disconnecting. Then check whether the mapped Xero bank account was archived or deleted, and restore it or remap it to a new account.
How does Airwallex handle payment processing fees on Xero invoices?
Airwallex handles payment processing fees on Xero invoices by reporting them separately in the Payments Feed, which records payments at gross and fees to an expense account.
How do I reconcile batched bill payments in Xero?
To reconcile batched bill payments in Xero, open the bank feed line and use Find & Match to select every bill payment it covers. Bills paid through Airwallex are marked as paid automatically, with the matching payments already in Xero.
How do I reconcile Airwallex currency conversions in Xero?
To reconcile Airwallex currency conversions in Xero, record the spend line and receive line as one transfer between the two currency bank accounts. Xero calculates and posts the realized FX gain or loss.
Sources
https://fxcintel.com/research/press-releases/banks-take-92-of-global-b2b-payments-but-are-still-waking-up-to-56tn-opportunity
https://apps.xero.com/ca/app/airwallex
https://www.xero.com/ca/pricing-plans
https://corporatefinanceinstitute.com/resources/accounting/foreign-exchange-gain-loss
View this article in another region:Canada - FrançaisUnited States
The material presented here is for informational purposes only and does not constitute legal, regulatory, taxation, or investment advice. Readers should engage their own advisors or counsel for advice unique to their circumstances.
Posted in:
Embedded financeShare
- What is a Xero Airwallex integration?
- How does Airwallex integrate with Xero?
- Requirements for Airwallex to Xero integration
- How to set up the Xero Airwallex bank feed
- How to sync billing between Xero and Airwallex
- How to integrate Xero invoice payments with Airwallex
- How does Xero multi-currency reconciliation work with Airwallex?
- How to troubleshoot the Airwallex Xero connector
- Why Xero customers choose Airwallex


