Skip to main content

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.
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.

Features

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
Only enable Xero payment links for locations with a verified Xero connection. If the connection is unavailable, customers cannot continue to Xero to pay.

Configuration

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

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
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.

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.