Skip to content

Mestra Network

Xero sync

The Xero sync posts your card bookings into your own Xero organisation, so your books follow what happened without anyone typing it in. It is off until an owner turns it on, and you choose every account it uses.

It is for landlords whose card payments go to their own payments account. Open Billing, then Accounting: Xero.

What it posts

  • Each tax invoice or receipt, under the number it already has. Mestra’s document is the only one: Xero never makes a second number. The PDF is attached to it, and it is marked as sent.
  • Each card payment, as a payment on that invoice.
  • Each credit note, and the refund as a payment on it.
  • A booking paid twice, and the refund of the second payment.
  • Your payments account’s fees and disputes, as money spent (and, when money came back, money received).
  • Our monthly fee invoice as a bill from Mestra, with its GST, paid from the clearing account.
  • Each payout as a transfer from the clearing account to your bank account, ready to match against the line in your bank feed.

A booking paid in the Mestra checkout is posted like any other: its own invoice, under its own number, with the payment on it. Fees and dispute money on a charge that covered several bookings belong to no single booking, so they are labelled Cart and the first characters of the cart’s id.

The clearing account

Card money doesn’t reach your bank account the day it is paid. So the sync keeps a clearing account: a bank account in Xero that stands for the balance of your payments account.

  • Payments go in. Refunds, fees, disputes and our fee invoice come out.
  • Each payout leaves it as a transfer to your real bank account.
  • What is left is what your payments account still holds for you.

For example, you take two bookings of $110.00. Your payments account’s fee is $1.65 on each and ours is $3.30 on each. Until the month’s fee invoice is posted, the clearing account holds $220.00 less the fees your payments account took ($3.30), so $216.70, less any payout. Say a payout of $210.10 goes to your bank: clearing then holds $6.60, which is our fees for the month. When the month ends our fee invoice for $6.60 is posted and paid from clearing, and it is empty.

So during the month the clearing account holds our fees as well as what hasn’t been paid out. The Accounting page shows them as Mestra fees waiting for this month’s bill.

Turning it on

Only an owner can turn it on, connect it or turn it off. Before it turns on you are shown what it needs, stores, reads and sends, and what it never does:

  • Needs: a Xero login that can add apps to your organisation.
  • Stores: your Xero connection (encrypted), the organisation’s name, your choice of accounts and tax rates, the contacts we made or matched, and a record of everything we posted with its Xero id.
  • Reads: your Xero organisation’s currency, country and lock dates, its accounts, tax rates and the contacts we look up.
  • Sends: your card bookings’ tax invoices, receipts and credit notes (with their PDFs), the payments and refunds, your payments account’s fees and disputes, our monthly fee invoice, and your payouts as transfers.
  • Never: changes or deletes anything in Xero we didn’t post, sends your other sales, or posts before the date you choose.

Connecting

Select Connect Xero and sign in to Xero. If you ticked more than one organisation, choose which one to use. Each Xero organisation connects to one Mestra organisation, because invoice numbers are unique within a Xero organisation.

Choosing your accounts

Nothing is posted until you save your choices. We suggest each one from your own Xero, and say why under it (“Your Sales account (200)”). You confirm or change every one:

  • Clearing account: a bank account for card money. Select Create a clearing account for me to have one made, or choose one you have. We never make an account unless you press it.
  • Your bank account: where payouts arrive.
  • Sales account and tax rates: where invoices are coded, and the rate on taxed invoices and on receipts.
  • Card fees: the account, the tax rate and the contact (Create contact makes one named for your payments provider).
  • Mestra fees: the account, the tax rate and the contact for our fee invoice.
  • Disputes: the account and tax rate for money taken back.
  • Post from: nothing dated before this is posted. A month that started before it is billed for the part from this date.
  • Other activity on your payments account: left out unless you choose an account for it.

Change accounts applies to what is posted next. Anything already posted stays as it is.

What needs you

The page lists every posting with its state. Needs you means something is held and says why, in words:

  • A locked period: Xero is locked up to a date. Unlock that period in Xero, then select Post again. It is posted on its own date, never another.
  • Another currency: it isn’t in your Xero’s own currency, so it isn’t posted. Record it in Xero by hand.
  • A number already used in your books: Xero already has an invoice with that number that we didn’t post. We never take over or change it. Rename it in Xero or change your invoice prefix.
  • A total your software worked out differently: Xero’s total didn’t match our document to the cent, so nothing was posted. Check your tax rates, then select Post again.
  • A rejected item: Xero refused it. Its own words are shown.

Payouts and fees wait until the payments they cover are in Xero, and say so.

Our fee invoice to a UK landlord is posted with no tax, and its first line says the customer accounts for the VAT. A UK landlord applies their own reverse-charge rate in Xero.

Owners are emailed when something new needs them.

Turning off or disconnecting

Turning off, or Disconnect, forgets the connection. What was posted stays in Xero and in our record, and so do your choices. Reconnecting the same organisation never posts anything twice.

Ask Mestra and AI agents

Ask Mestra can open the page on what needs you, point at one held posting, and fill in your accounts. It never saves them, and never presses Post again, turns Xero on or connects it: those are yours. An AI agent you connect yourself can read the sync’s state and what was posted, choose the accounts, and post a held item again. It can’t turn Xero on, connect it or disconnect it. See Network tools.

What’s next