Integrate with Xero

Xero is an easy-to-use online accounting software that's designed specifically for small businesses. For more information, please visit Xero.

How does the integration work?

Zettle lets you import your sales and payments data daily into your Xero account. The integration is easy and simple to set up, and once you've connected your Xero account, Zettle will automatically import your data into the bookkeeping accounts of your choice.

In order to get a better understanding of your Zettle payments and fees, we suggest that you create separate bookkeeping accounts for each set of data, making it easier to get a clear overview of transactions going in and out of your Zettle account and your bank account.

The guide below is a suggestion on how to set up your connection with Xero in the most straightforward way.

Does the integration offer tax rate advice for my business? 

The integration does not provide tax rate advice, and it dosn’t automatically populate tax rates that are suitable for your business. This is due to the fact that your business type, products and services type are not validated by Zettle, and you need to consult the tax rules and / or your accountant to be accurate with the tax rates. Please also be aware that tax rates are subject to permanent or temporary changes by the applicable tax rules. It is strongly recommeded that you adjust the tax rates for your business in your Zettle and Xero account, when there is a tax rate change from the tax rules. 

Unsupported plans

Certain Xero plans are not supported on Zettle because of their limited functionalities. Check if you need to change your plan before connecting to Zettle.

Not supported on Zettle:

  • Xero Ledger
  • Xero Cashbook

All other Xero plans are supported. Make sure you’re on one of the supported plans in order to connect to Zettle.

How to connect your Zettle account with Xero? (step-by-step)

  1. Sign in to your Zettle account at my.zettle.com
  2. Go to "Integrations"
  3. Click "Connect" on the Xero integration. A window will open up where you need to insert your Xero login details. Please select which Xero organisation Zettle can access and click "Authorise". You can connect only one Zettle account to one Xero organisation.
  4. In order for the import to work seamlessly, you need to specify which Zettle data goes into which Xero account. Each transaction type can have a dedicated account in Xero.
  5. Map the Zettle Accounts to your Xero Accounts.
  6. Choose start date for when in time you want to retroactively export data.
  7. Click “Save”. 

Done! If everything is set up correctly, you will see your Zettle data in Xero the following day.   

Xero account type mapping

For the import to work seamlessly, you need to specify which Zettle data goes into which Xero account. Each transaction type can have a dedicated account in Xero. Read more about account mapping under How does the data mapping work between Zettle and Xero?. 

Zettle Account

Xero Account

Zettle sales

Revenue

Zettle refunds

Revenue

Zettle tipping

Current Liability, Non-current Liability, Revenue

Zettle gift card

Current Liability, Non-current Liability, Revenue

Zettle fees

Direct Costs, Overhead

Zettle payments (card, cash, invoice, online card, PayPal, mobile)

Bank Account. Current Liability

Cash Advance

Current Liability, Non-current Liability

Zettle liquid account

Bank Account. Clearing account

Can I connect multiple Zettle accounts to Xero?

You can only connect one Zettle business account to one Xero organisation. 

When does the import happen?

When you set up the integration, you can select any date in the past to start the import. This will retroactively import data from Zettle to Xero for each day since the date selected. We recommend selecting a date within your current fiscal year in order to not alter any data in the period before the last closing of your books.

Zettle automatically imports data to Xero once every day at 00:00 GMT. Once you set up the integration, the first Zettle data will appear in Xero the next day. 

Can I change the start date after setting up the integration?

After the first successful data import between Zettle and Xero you cannot change the start date, as it would result in duplicated data for overlapping days.

What data is shared between Zettle and Xero?

When you authorise the connection between Zettle and Xero you give permission to Xero to read your Zettle sales and financial data. You also give permission to Zettle to read your Xero organisation’s company, accounts, tax rates, customers, suppliers, invoices, bills, payments, balance sheets and bank statements.

How can I avoid double-counting purchases if I am using a POS other tha Zettle and have already integrated with Xero?

If you are using a point-of-sale app other tha Zettle that is already connected to Xero, switch off the “‘Synchronise sales data” option in order to avoid double-counting. In this case, you only need to sync Zettle fees data to Xero. You can do this by selecting an account for “Zettle fees” to record fees as an expense (bill), and you should also select an account for “Zettle Card Payments” to record payments for the expense. The Zettle fees are subtracted from card payments upon payout from Zettle to your bank account.

What should I do when I get errors regarding a missing tax rate?

This is often due to a missmatch of tax rate settings between your Zettle account and Xero account. If you are actively using one or more tax rates, please make sure to set up the tax rates in both your Zettle and Xero accounts. You can then view and configure the tax rates in your Zettle account and map them to your Xero account. 

Bank reconciliation 

In order for Xero to reconcile your Zettle card and cash payments, we need to do an initial 'Create' for your Zettle deposits. Once a deposit has been made into your bank account, this transaction will show up under your bank reconciliation page in Xero. The first time Zettle makes a deposit to your bank account in Xero, please create a match and select your Zettle Card or Cash Payments account as applicable. The next time you visit your Xero bank reconciliation page, Xero should automatically suggest the receive money transaction – you just need to click "OK".

The data sync has stopped and I’m missing Zettle data in Xero. What can I do?

Log in to my.zettle.com and navigate to "Integrations". Verify that your connection to Xero is still active, if not, your connection to Xero has been deauthorised – usually due to password or permission change in Xero – and you have to connect again.

If your connection is active, navigate to the Xero settings page and verify that you have a valid account selected for each required field. If an account is missing or has become archived in Xero, you will see an error message on the field. Make sure to select a new account and save the new settings. The integration will automatically backfill data for the missing period with the new settings from the next day. 

If all settings look good on the Xero page in Zettle, please check your Xero account and make sure that your subscription is active and you have not reached the maximum amount of invoices allowed within your subscription.

In case all of the above checks up, but the issue persists, please contact our support.

How does the data mapping between Zettle and Xero work exactly?

Zettle Sales 

Account mapping
Switch on to sync Zettle sales data in Xero if you are using Zettle Go as your point of sale. Switch off if you are using another point-of-sale system (e.g. Lightspeed, The Good Till, Revel) that already syncs sales data in Xero to prevent double counting. With the daily sales recording switched off, the Zettle integration needs only to record the fees and fee refunds (see below).

Sales are booked on a nominal account in the “Revenue” category.

How does this data appear in Xero?
With daily sales recording switched on, Zettle pushes a single sales invoice to Xero each day. This invoice represents all sales made over the course of that day. The invoice will contain one line item for each tax rate, with this line item representing the total of all sales at that tax rate. If no sales have been made for a given tax rate on that day, the corresponding line item will be omitted. The sale will be recorded against the Zettle customer, and the sales account for all line items will be set to the Zettle sales account.

The sales invoice is marked as paidand is balanced by current asset accounts in Xero representing cash payments, card payments and other payment methods, which when settled can be reconciled in the Xero bank feed to reduce their respective balances to zero.

Zettle Refunds

Account mapping
Refunds are also booked on a nominal account of type “Revenue” and will appear on the Income section of a profit and loss report. When purchase refunds are recorded in Xero, the negative revenue will be booked to this account. It is typical to select the same account as for the Zettle sales account (see “Sales” above). However, a different account could be used if you want to report refunds separately within Xero.

How does this data appear in Xero?
Zettle pushes a single sales credit note to Xero each day. This invoice represents all refunds made over the course of that day. The credit note will contain one line item for each tax rate, with this line item representing the total of all refunds at that tax rate. If no refunds have been made for a given tax rate on that day, the corresponding line item will be omitted. The credit note will be recorded against the Zettle customer (see “Sales” above), and the sales account for all line items will be set to the Zettle refund account.

Zettle pushes refund payment data as “cash refunds”. A transaction will be recorded against the credit note for each payment type refunded. This refund will be taken from the selected account to receive payments for each payment type (see payment types below). 


Zettle Tipping

Account mapping
Your customers can add an extra amount to their bill when taking payments via a Zettle reader. Tips (also known as a gratuity) are booked on a nominal account in the “Liability” category.

How this data appears in Xero
Gratuity is pushed to Xero as part of the daily sales invoice as a separate line item.

Zettle Fees

Zettle take a percentage commission on every card transaction processed by the Zettle card reader. Zettle also charges fees for Zettle invoice payments and Cash Advance, if these are applicable to you. The fees affect the amount deposited in your bank account, as they are subtracted from the card payment amounts upon payout. Due to this, the current asset (Zettle card payments) account would not be zero after completing reconciliation against the bank feed. The integration, therefore, creates a purchase invoice in Xero to account for Zettle fees. The payment for Zettle fees will be applied to the account used for Zettle card payments.

Account mapping

  • Zettle fees account – This is a nominal account of type “Expenses”, and will appear in the Expense section of a profit and loss report. When fees are recorded in Xero, they will be booked against this account.
  • Zettle fees supplier – Accounts Payable in Xero must be booked against a contact, representing the supplier to which the cash is paid.
  • The cash movement is from the account selected to receive Zettle card payments into (see “Payments” below), as this account should represent the Zettle liquid account.

How this data appears in Xero
Zettle pushes a single purchase invoice (bill) to Xero each day. This bill represents all fees taken by Zettle over the course of that day. The bill will contain a single line.

The bill will be recorded against the Zettle fees supplier, and the expense account for the line item will be set to the Zettle fees account.

A single payment is pushed for the full payment of the bill, representing the transfer of money out of the liquid account to pay the fees. This payment is taken from the account selected to receive Zettle card payments into.

For fee refunds, a single bill credit note is pushed each day representing all fee refunds processed that day. A “cash refund” payment for the whole value of the credit note is simultaneously pushed, so the bill credit note is fully paid (as no further cash is owed by Zettle). This payment is paid into the same account selected to receive Zettle card payments into.

Zettle deposits 

Deposits are the revenue from your sales after deducting any fees owed to Zettle.  

When your funds are paid out, your bank will process and deposit it in your bank account. You must reconcile the Zettle deposit transaction against the deposit amount from your bank statement on Xero.

Accounting mapping
Deposits are booked on a nominal account that represents the bank account you’ve connected to Zettle.

Make sure the bank account you selected on Xero represents the account where you receive your Zettle deposits, which is different from the account you chose for the Zettle liquid account.

How this data appears on Xero
It will show up as a transfer from Zettle's liquid account to your business's bank account.

Zettle payments by card, Alipay and PayPal QR codes

Account mapping
You can assign your liquid account to either a Xero bank account (labeled as a Current account), or continue to use a Current nominal account if you are already doing so. For best accounting consistency, we recommend using a Xero bank account.

Your payments data will appear in the Current assets section of the balance sheet report. 

The account configured for Zettle card payments represents the Zettle liquid account.

How this data appears in Xero
Zettle pushes a single payment to Xero per day per payment type which has been used that day. So if you process ten card payments and twenty cash payments in one day, two payments are pushed. These payments are recorded against the daily sales invoice.



Zettle Online Card Payments

Customers can pay with Zettle Online Card Payments either via “Pay by link” in Zettle Go or in Zettle’s e-commerce platform. In Xero, online card payments work the same way as in-store card payments. We recommend you select the same nominal or bank account as for card payments.

Zettle Invoice

Account mapping

  • Invoice payments account – This is a bank account (or current asset nominal account) where payments against invoices are received. As invoice payments are handled by Zettle, this account should represent the Zettle liquid account, and thus be the same as the card payment account.
  • Invoice fees account – This is a nominal account of type "Expenses", and will appear on the expenses section of a profit and loss report. Payment fee transactions will be reconciled against this account.

How this data appears in Xero
An invoice is pushed to Xero as normal when an invoice purchase is made, however, a payment is not immediately pushed against the invoice, so the invoice is displayed with an outstanding balance.

When the customer has made a payment against the invoice, the payment is pushed against the original invoice. This payment is booked against the Invoice payments account, which should match the Zettle liquid account as this is where invoice payments are paid into. If the payment pays the invoice in full, at this point the invoice will be marked as paid in Xero.

Please note: only invoices that are paid before the due date in Zettle will automatically be reconciled in Xero by the integration. 


Invoice fees are pushed in a similar way to standard Zettle card fees (see "Fees" above). A bill is pushed, recorded against the Zettle fees supplier, with a single line item with the expense account set to the Invoice fees account. A single payment is simultaneously pushed for the full payment of the bill, representing the transfer of money out of the liquid account to pay the fees. This payment is taken from the Invoice payments account.

Zettle Cash Advance

Account mapping

  • Cash Advance account – a nominal account of type “Current Liability”. This account will appear in the Liabilities section of a balance sheet report. The value of this account represents the amount of the loan principal that is yet to be repaid.
  • Cash Advance Fees account – a nominal account of type “Expense”. This account will appear in the Expenses section of a profit and loss report. Transactions pushed to this account represent fees on the advance paid to Zettle.
  • All flows of cash are pushed to the account configured for Zettle card payments, as this represents the Zettle liquid account. These cash flows are attributed to the Zettle contact (configured as part of the sales/fees sections of the config).

How this data appears in Xero
The advance transaction is pushed to Xero as a “receive money” transaction into the card payment bank account (the liquid account). This transaction is reconciled to the Cash Advance liability account, and thus increases the value on that account.


Repayments of the advance are pushed as “spend money” transactions into the card payment bank account (the liquid account). These transactions are reconciled to the Cash Advance liability account, and thus decrease the value on that account (representing the outstanding principal going down).

Advance fees are likewise pushed as “spend money” transactions into the liquid account but are reconciled against the Advance Fees expense account, representing a one-off cost to the business.


Zettle Gift Cards

Account mapping

  • Gift card sales: a nominal account of type “Liability”. The value of this account represents the amount of outstanding gift cards. Selling a gift card goes to a Prepaid account in Xero, set up as a liability account. When a customer pays with a gift card it will be debited from the selected liability account.

  • Gift card payment:The payment representing selling an item with a gift card is the PrepaidPayment account. 

How this data appears in Xero

Selling a gift card will appear as a line item on the daily sales invoice.

Items paid by gift card will be represented on the daily sales invoice:

Items paid by gift card will be also represented as a bank transaction:

Was this article helpful?