--- title: "The new Xero integration splits Stripe payouts by category" url: https://tidyhq.com/blog/tidyhq-xero-integration-v2-stripe-payouts date: 2026-09-28 updated: 2026-09-30 author: "Isaak Dury" categories: ["Product", "Integrations"] excerpt: "Our rebuilt Xero integration is now self-serve on the Pro plan. Each Stripe payout lands in Xero already split across your accounts, so the treasurer can see how much was memberships and how much was the trivia night." --- # The new Xero integration splits Stripe payouts by category > Our rebuilt Xero integration is now self-serve on the Pro plan. Each Stripe payout lands in Xero already split across your accounts, so the treasurer can see how much was memberships and how much was the trivia night. ![Folklore by Victor Vasarely, illustrating The new Xero integration splits Stripe payouts by category](https://cdn.sanity.io/images/bp0k7h82/production/4f221167c335b32b60347a55c03390d7bc496e7f-402x400.jpg?w=1200&fm=webp) ## Key takeaways - In September 2026, TidyHQ's Xero V2 integration became available self-serve on the Pro plan, after a limited beta that began in November 2025. - The TidyHQ Xero V2 integration posts each Stripe payout to Xero as a bank transaction, split across Xero accounts according to the TidyHQ finance categories of the payments inside it. - The Xero V2 integration requires Stripe to be connected in TidyHQ, and places are limited because Xero limits how many organisations can be connected at once. - Cash and bank transfer payments recorded in TidyHQ can also be posted to Xero with the Xero V2 integration, each as its own line item. - The original TidyHQ Xero integration, covered in 2021 guides, is no longer available for new connections and worked by manually syncing draft invoices. A Stripe payout of $2,847\.60 lands in the club account on a Tuesday\. The treasurer knows it is a mix of senior registrations, a few junior renewals, the trivia night tickets and some hoodies\. What she does not know, without an evening of cross\-referencing, is how much of it was which\. And the accountant who signs off the books before the AGM wants it coded properly in Xero, not dumped into “Sales”\. That is the job our new Xero integration does\. It went into beta with a small group of clubs in November 2025, and in September 2026 it became self\-serve on the Pro plan\. ## Is this the same Xero integration from the 2021 guides? No\. If you have read our older posts, such as the [2021 Xero integration guide](/blog/tidyhq-xero-integration-guide), those describe the original integration\. That one worked by syncing transactions manually from Finances, and they arrived in Xero as draft invoices you then approved and marked as paid\. It is no longer available for new connections\. The new one, called **Xero V2** in the Apps list, works from your Stripe payouts instead, and can post them automatically\. ## How does the Xero V2 integration work? When a Stripe payout reaches your bank account, TidyHQ posts it to Xero as a bank transaction, broken down by the TidyHQ finance categories of the payments inside it\. Each category maps to an account in your Xero chart of accounts\. So the $2,847\.60 arrives already split into membership income, event income and merchandise, with the Stripe processing fees and TidyHQ fees on their own lines as expenses\. The lines add up to what actually hit the bank, so reconciling in Xero is matching one bank line to one transaction, as normal\. ![The Stripe Payouts list in the Xero V2 app, with one payout expanded to show a line items breakdown of income, payment processor fees, TidyHQ application fees and fee tax adding up to the payout total](https://cdn.sanity.io/images/bp0k7h82/production/01e88206c7270c086b36eda4c9b346f992aa43b1-810x918.png?w=1200&fm=webp) *Each payout's breakdown, showing what was posted to Xero and when.* Cash and bank transfer payments you record in TidyHQ \(the “direct payments”\) can go across too\. Choose a date range, tick the payments you want and click **Post to Xero**\. Each comes through as its own line item, and payments already posted are shown so you do not send one twice\. ## Who can use it? Three conditions\. Your organisation needs to be on the Pro plan\. You need Stripe connected in TidyHQ, because the integration works from Stripe payouts\. And there has to be a free place\. Places are limited because Xero limits how many organisations can be connected at once\. If every place is taken, the app says it is full right now, and you can add it to your watchlist so we know you are waiting\. If you already added the app, your settings are kept and you can authorise Xero as soon as a spot frees up\. You also cannot run the old and new integrations side by side\. If the original Xero app is still active, turn it off first\. ## How to set it up 1. Go to **Apps**, then **Xero V2**, and click **Add App**\. 1. Click **Authorise Xero** and sign in to connect your Xero organisation\. 1. Open the **Configuration** tab and choose the Xero bank account your Stripe payouts land in\. It needs to be a “Bank” type account in the same currency as your TidyHQ account\. 1. Decide whether payouts should post automatically, and choose any Roles to notify\. 1. Map each TidyHQ category to a Xero account, then click **Update Account Mapping**\. By default, every income category maps to Sales \(200\) and every expense category to Cost of Goods Sold \(310\)\. Change those\. The whole point is that your accountant sees “Senior subscriptions” and “Canteen” as separate lines\. The full steps, with screenshots, are in the [Xero V2 support article](https://support.tidyhq.com/en/articles/13050041-xero-v2-integration)\. ![The category mapping table in Xero V2, pairing TidyHQ expense categories such as Coaching Expense and Sponsorship Expense with Xero accounts, and a warning that 20 categories need mapping](https://cdn.sanity.io/images/bp0k7h82/production/1ee12d4be9797cc163f30f1f51cb2642ec8ecb2d-829x911.png?w=1200&fm=webp) *Map each TidyHQ category to the right Xero account before you post.* ## What happens if a payout fails to post? A payout will not post if any category or fee account in it is unmapped, or if the payout’s currency does not match your organisation’s\. When Xero rejects a payout, TidyHQ now shows Xero’s actual reason and lets you retry it once you have fixed the problem\. The Roles you chose get notified when a payout is ready, posted or failed\. ## What it does not do It handles Stripe payouts and the cash or bank payments you post yourself\. It is card payments through Stripe only, because that is how TidyHQ takes online payments\. It does not replace your accountant or your chart of accounts, and it will only be as tidy as your categories\. If “Other income” is doing a lot of work in TidyHQ, it will do the same work in Xero\. For more on how the two fit together, see the [Xero integration page](/integrations/xero) and [Finances](/products/finances)\. Everything else from September is on the [changelog](/changelog)\. --- Header image: *Folklore* by Victor Vasarely, via [WikiArt](https://www.wikiart.org/en/victor-vasarely) --- Canonical: https://tidyhq.com/blog/tidyhq-xero-integration-v2-stripe-payouts | Retrieved from: https://tidyhq.com/blog/tidyhq-xero-integration-v2-stripe-payouts.md | Published by TidyHQ (https://tidyhq.com)