Xero payment gateway integration 2026
Connect an available Xero payment gateway to your invoices, compare payment options and check how the receipt, fees and remaining balance are recorded.
- Published
- Last updated
Yes, Xero payment gateway integration lets customers pay online from a Xero invoice through a connected payment service. For Australian retailers, choose Stripe for cards and digital wallets or GoCardless for direct debit, subject to provider approval.
Connect the service to the invoices you send, then check the payment against the invoice balance. A customer payment and the later payout to your bank are separate records.
Choose an available Xero payment service
The best payment gateway for Xero depends on how your customers pay. Xero’s Australian online-payment guidance documents Stripe and GoCardless connections. Xero also documents PayPal as an invoice payment service. Start with the options available to your organisation and its country.
Compare invoice payment options
| Service | Customer payment method | Merchant requirement | Invoice workflow |
|---|---|---|---|
| Stripe | Credit and debit cards, with supported digital wallets | An activated Stripe account for the correct country | The customer pays from the invoice’s online payment option. |
| GoCardless | Direct debit from the customer’s bank account | A GoCardless account and customer authorisation | Collect against an invoice under the customer’s mandate. |
| PayPal | PayPal’s supported checkout methods | A PayPal business account | Apply the connected service to an invoice. |
Stripe fits customers who want to pay a single invoice by card. GoCardless fits recurring collections where customers authorise debits. Xero’s Australian GoCardless guidance explains that collection can follow invoice due dates. PayPal is an additional choice when it is available in your payment services and suits your customers.
Compare the provider’s transaction-fee structure and any international-payment or currency-conversion charges. Keep the Xero subscription separate from processing fees. For settlement, compare when the provider confirms collection with when it pays out to your bank. Don’t assume the invoice payment methods or payout timing are identical across providers.
Adding your bank details to invoice text gives customers transfer instructions. It doesn’t authorise a payment provider or add a connected checkout. A storefront checkout connection also doesn’t automatically connect Xero-owned invoices.
Connect the service to the right invoices
Use a Xero account with permission to add payment services and an authorised provider account. Xero’s Stripe instructions specify an administrator or standard user role. Complete provider onboarding before relying on the connection to receive money.
For Stripe, follow Xero’s documented connection route:
- In Sales, open Online payments and select Add a new service.
- Under Cards and digital wallets, choose Set up cards & digital wallets. Sign up for Stripe or select the existing-account option.
- Complete the provider sign-in and onboarding steps for the correct business account.
- Back in Xero, select the bank account that receives Stripe payouts. Choose the expense account for fees and the tax rate when creating a new expense account.
- Complete setup and save. Open the intended invoice and check its Online payments setting. Use Manage or Add to confirm Cards is selected.
- Preview the online invoice and confirm the customer can see the payment option. Check an invoice using each template you actually send.
Xero can also start Stripe setup from a draft or approved invoice through Online payments. Its connection guide explains how services attach to invoice templates. An additional Stripe account needs its template assignment checked separately.
For direct debit, use the GoCardless setup instructions. Authorise the connection and select the receiving account. The customer must authorise the debit before collection. Xero’s PayPal connection guide requires a business account. Use the service offered in your organisation, with the matching country and business details.
Keep provider authorisation with the person authorised to manage that merchant account. The bookkeeper owns the Xero account mapping. Confirm both before sending payment-enabled invoices.
Check the payment and invoice records
Verify the customer payment at the provider, its allocation in Xero and the later bank settlement. The invoice balance tells support what remains due. It doesn’t establish that a provider payout has already reached the bank.
Consider fictional invoice XR-410 for $1,000. The customer pays the full amount through the connected service. Retain the provider’s payment reference and confirm that Xero applies $1,000 to XR-410, leaving zero due.
Next, compare the provider’s payout breakdown with the bank deposit. The deposit can contain several invoice payments and have processing fees deducted. Stripe’s Xero guidance describes matching relevant payments and fees when funds reach the bank. A net deposit smaller than the invoice total doesn’t, by itself, mean the customer underpaid. The fee belongs in the fee record, not in the customer’s outstanding balance.
Record a part payment against the invoice
For a separate fictional example, XR-411 totals $1,000 and the customer transfers $400 directly to your bank. Use this manual route only when Xero hasn’t already recorded that receipt.
Xero documents part payments on customer invoices. In the web interface:
- Open Sales, then Invoices. Find XR-411 under Awaiting Payment.
- Under Record payment, replace the prefilled full amount with the $400 actually received. Enter the receipt details and the receiving account.
- Add the payment reference and select Record payment.
- Confirm the payment under the invoice total. XR-411 must have $600 remaining due.
- When the corresponding bank statement line arrives, reconcile it to the recorded payment. Don’t create a second receipt.
Recording $400 changes the accounting record. It doesn’t collect money. Only enter it after confirming receipt.
Allocating one receipt across several invoices is different: each allocation reduces a particular invoice balance, and the allocations must total the receipt. Splitting a bank transaction among accounting categories doesn’t itself allocate a payment to a customer invoice. An agreed instalment plan sets future payment terms. Recording one part payment doesn’t create that agreement or schedule future collections.
Handle refunds and duplicate records
For a fictional $200 refund on fully paid XR-410, confirm the refund against the original provider payment. Record the related credit and refund in Xero, then reconcile the outgoing money. Xero’s credit-note guidance explains that refunding a credit note creates a payment transaction for reconciliation. Recording that transaction doesn’t send the customer money through the provider.
If XR-410 appears paid twice, compare both Xero payment records with the provider and bank. One real receipt entered twice needs an accounting correction. Two real receipts require the extra money to remain accounted for. Xero’s overpayment guidance directs users to record an overpayment when an invoice is genuinely paid twice.
Unreconciling a payment only breaks its match to a bank statement line. It doesn’t reverse the customer’s charge. Use the Xero reconciliation correction guidance to distinguish a wrong statement match from a payment applied to the wrong invoice. Keep the original references before the bookkeeper corrects either case.
Resolve a missing option or unmatched receipt
When the payment option or receipt is missing, check the existing connection and transaction before asking the customer to try again.
| Symptom | First check | Responsible team |
|---|---|---|
| Pay button absent | Open the online invoice and inspect its payment-service setting and template assignment. | The Xero administrator checks invoice settings. |
| Provider account disconnected or pending | Check onboarding completion and the account selected for the connection. | The merchant account owner resolves provider authorisation. |
| Provider confirms payment but invoice remains due | Match the provider reference and amount to the original invoice and existing payment records. | The bookkeeper checks allocation, then raises a Xero case if the update is missing. |
| Bank deposit doesn’t match one invoice | Compare the payout breakdown, included receipts and deducted fees. | The bookkeeper checks settlement, with the provider for missing payout details. |
For GoCardless, a changed invoice amount can explain a missing paid status after collection was submitted. Its Xero troubleshooting guidance identifies this mismatch. Check the collection against the invoice version before changing either record.
Give support the invoice reference and provider payment reference when escalating. If payment has completed but its allocation is missing, correct that link instead of collecting again. Finish with one confirmed receipt per real payment, the correct remaining balance and a bank reconciliation that explains any fee difference.
Give your store its own shopping agent
Customers ask in their own words. Your agent finds, compares and checks out from your catalogue, right on your site.