> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Xero payment links

> Enable Xero payment links so customers can pay issued invoices through Xero.

## Overview

Xero payment links let customers settle invoices on Xero's hosted payment page using the payment methods configured for your Xero organisation.

Payment links work with an **issued invoice**, rather than directly with a shopping basket. The checkout flow therefore has two steps:

1. During checkout, the customer chooses **Pay via invoice**. Nexudus issues the invoice and opens its payment page.
2. On the invoice payment page, the customer chooses **Pay by Xero** and is redirected to Xero to complete the payment.

Customers with permission to pay invoices can also open an eligible unpaid invoice from **My Invoices** and use **Pay by Xero**.

<Info>Xero payment links complement the Xero accounting integration. The integration keeps invoices and payments aligned with Xero, while payment links let customers pay issued invoices through Xero.</Info>

## Features

| Feature            | Supported                                     |
| ------------------ | --------------------------------------------- |
| Card payments      | As configured in Xero                         |
| Bank transfers     | As configured in Xero                         |
| Recurring payments | No                                            |
| 3D Secure          | Handled by Xero                               |
| Refunds            | Processed in Xero                             |
| Sandbox mode       | No. Test with a Xero-connected test location. |

## Prerequisites

Before enabling Xero payment links, make sure:

* Your location is connected to Xero and invoice synchronisation is working
* **Reconcile payments made in Xero with Nexudus invoices** is turned on
* **Automatically reconcile payments made in Xero with Nexudus invoices (every 6 hours)** is turned on for ongoing reconciliation
* You have tested the flow with a low-value invoice

<Warning>Only enable Xero payment links for locations with a verified Xero connection. If the connection is unavailable, customers cannot continue to Xero to pay.</Warning>

## Configuration

| Setting                                                        | Key                 | Type    | Description                                                                      |
| -------------------------------------------------------------- | ------------------- | ------- | -------------------------------------------------------------------------------- |
| **Show links to pay invoices via Xero in your Members Portal** | `Xero.PaymentLinks` | Boolean | Shows the **Pay via invoice** and **Pay by Xero** options in the Members Portal. |

To enable Xero payment links:

1. Connect your location to Xero and confirm that invoice synchronisation is working.
2. Turn on both Xero payment reconciliation settings listed in the prerequisites.
3. Turn on **Show links to pay invoices via Xero in your Members Portal**.
4. Use a test customer to place a low-value order and complete the payment flow.
5. Confirm that the payment is recorded against the correct invoice in Nexudus and Xero.

Turning the payment-links setting off removes the Xero-related options from checkout and invoice payment pages. Existing invoices remain payable through other available methods.

## New purchases

When a customer buys a product, plan, booking, or another item:

1. The customer selects **Pay via invoice** during checkout.
2. Nexudus confirms the order and issues an invoice.
3. The invoice payment page opens with the invoice details and available payment methods.
4. The customer selects **Pay by Xero**, then **Complete payment**.
5. The customer is redirected to Xero's hosted payment page for that invoice.

## Existing invoices

Customers can pay an eligible unpaid invoice without creating another invoice:

1. The customer opens **My Invoices** in the Members Portal.
2. If the invoice can be paid online, they select **Pay**.
3. On the invoice payment page, they select **Pay by Xero**.
4. They select **Complete payment** and finish the payment in Xero.

## What customers see

| Page                               | Option              | What happens                                                       |
| ---------------------------------- | ------------------- | ------------------------------------------------------------------ |
| Checkout, before an invoice exists | **Pay via invoice** | Confirms the order, issues the invoice, and opens its payment page |
| Invoice payment page               | **Pay by Xero**     | Redirects the customer to Xero for that invoice                    |
| My Invoices                        | **Pay**             | Opens the invoice payment page when online payment is available    |

While the redirect is in progress, the button displays **Redirecting to Xero...** and is disabled to prevent repeat actions.

## Payment reconciliation

After the customer follows the payment link, Nexudus checks Xero several times for the completed payment. If ongoing automatic reconciliation is enabled, Nexudus also checks Xero every six hours. Once the payment is found:

* The invoice status in Nexudus changes to **Paid**
* The payment is recorded against the invoice in Nexudus
* The updated status appears in **My Invoices**

<Note>If the customer leaves Xero without completing payment, the invoice remains unpaid. They can try again later from **My Invoices** when the **Pay** option is available.</Note>

## Troubleshooting

* **Xero options do not appear**: Confirm that **Show links to pay invoices via Xero in your Members Portal** is turned on and that the location is connected to Xero.
* **The customer cannot continue to Xero**: Check whether the Xero connection has expired or been disconnected. Restore the connection and ask the customer to retry from **My Invoices**.
* **The invoice remains unpaid after payment**: Confirm that both payment reconciliation settings are turned on. Reconciliation can take a short time or, after the initial checks, until the next six-hour reconciliation run.
* **You need to disable Xero payments**: Turn off **Show links to pay invoices via Xero in your Members Portal**. The Xero options are then removed from the Members Portal.