Peach Payments enables you to connect your Xero account to your Peach Payments account to allow your customers to pay their invoices using all the payment methods offered by Checkout.

Video showcase

The following video showcases the Xero integration:

Connect your Xero account

🚧

If you used Peach Payments' old Xero and PaySafe integration, remove the old integration before integrating with the new Xero service.

To disconnect the old integration, perform the following steps in Xero:

1. Click the app launcher (waffle) icon in the upper right of your Xero account.
2. Click Manage connections.
3. In the Peach Payments row, click Disconnect.

Then remove the payment service itself from Xero by following the second set of instructions in the Disconnect the Xero app and payment service section below.

Follow these steps to connect your Xero account:

1. Log in to your Dashboard.

2. In the Connect section in the left-hand menu, click Add connection.

3. In the Xero section, click Add connection.

4. Click Connect now.

5. On the Xero login screen, enter your email address and password and click Log in.

6. If you have multiple Xero organisations, select the appropriate one. Click Allow access.

7. In the Peach Payments Dashboard, select a Xero invoice template, a payment account, and a fee account from the relevant lists.

   🚧

   To change these details later, disconnect and reconnect the Xero app.

8. Click Save changes.

Your Peach Payments account is now connected to your Xero account. To confirm, click the app launcher (waffle) icon in the upper right of your Xero account, then click Manage connections. Peach Payments appears in the list of connected apps.

Pay an invoice

Invoices that you create in Xero and send to your customers now have a Pay now button that allows them to pay the invoice using any of the payment methods configured for your Peach Payments Checkout channel.

1. Click the Pay now button or the hyperlink to go to the invoice in Xero.

   

2. Click Pay Now again to go to the Checkout screen where you can complete the payment.

   

📘

• The payment methods available depend on what you've requested for your Peach Payments account. For more information, contact support.
• When the customer pays the invoice, Xero automatically marks it as paid.

Payments made through Xero appear in the Transactions section of the Peach Payments Dashboard.

Disconnect the Xero app and payment service

If you no longer want customers to pay invoices via Peach Payments, disconnect the Xero app as follows:

1. Log in to your Peach Payments Dashboard.
2. In the Connect section in the left-hand menu, click Add connection.
3. In the Xero section, click Disconnect.
4. In the confirmation window that appears, click Disconnect.

This removes the connection between Peach Payments and Xero.

To remove the payment service from Xero itself:

1. Log into your Xero account.

2. Expand your business name and click Settings.

   

3. In the Features section, click Payment services.

4. In the Peach Payments row, click the Edit drop-down list, then click Remove.

   

5. In the confirmation window that appears, click Remove.

This removes the payment service.

FAQ

Why are my transactions failing with the 800.100.156 - transaction declined (format error) error?
Certain acquiring banks do not support special characters in the merchantInvoiceId parameter, so you must ensure that your merchantInvoiceIds only include alphanumeric characters. If you are using Xero's automatic sequencing functionality to add invoice prefixes, go to https://go.xero.com/InvoiceSettings/InvoiceSettings.aspx > Default Settings and ensure that the Invoice Prefix field only includes alphanumeric characters.