Xero

Add a Shuttle multi-use payment link to your Xero invoices, so your customers can pay online. Xero adds each invoice’s number and amount due to the link, so your customer doesn’t have to type them.

Prerequisites

• A Shuttle account with a multi-use payment link in the currency of your invoices
• A Xero account with access to Settings and Online payments

Setup instructions

1. Get your payment link

1. Log in to the Merchant Portal, select Configure in the menu, then Configure under Payment Links.
2. Under Multi-Use Payment Links, create a link with Create Multi-Use Link (or Create Another Link), or use an existing one. Make sure it’s in the currency of your invoices. See Multi-use links.
3. Leave Fixed Amount and Fixed Reference empty on this link. A fixed amount or reference replaces the amount and invoice number from Xero.
4. Select Copy to Clipboard next to the link to copy it.

You can also copy your multi-use links from Payment Links in the menu.

2. Add the invoice number and amount to the link

Add this to the end of the link you copied:

?amount=[AMOUNTDUE]&alt_key=[INVOICENUMBER]

Xero replaces [AMOUNTDUE] with the invoice’s amount due and [INVOICENUMBER] with the invoice number. On the payment page, amount fills in the amount and alt_key fills in the reference. See Fill in the amount and reference.

Your link should look similar to:

https://yourcompany.shuttleglobal.link/pl_1234_5678_mu?amount=[AMOUNTDUE]&alt_key=[INVOICENUMBER]

Keep the start of the link exactly as you copied it, up to and including the part ending _mu.

Your customer always pays in the currency of the link, whatever the currency of the invoice. If you invoice in more than one currency, create a multi-use link for each currency, add each one to Xero as its own payment service, and connect each to the branding theme you use for invoices in that currency.

3. Add a payment service in Xero

1. In Xero, navigate to Settings → Online Payments
2. Click Add New Service
3. Select Add another online payment option
4. Choose Custom payment URL
5. Enter your link from step 2 as the custom URL
6. Configure how you want this payment option displayed to customers
7. Click Save

4. Set as the default payment option (optional)

To make Shuttle your default payment method:

1. In Connected Services, locate your new payment option
2. Click Manage Themes
3. Select the invoice theme you want to update
4. Switch to use the payment method you’ve just added
5. Click Save

Using payment links with Xero invoices

Creating invoices with payment links

When creating a new invoice:

1. If using a theme with Shuttle as the default payment option, it will automatically appear in the online payments section
2. For individual invoices, you can manually add the payment option by clicking Manage in the online payments section
3. Click Approve to finalize the invoice

Customer payment experience

When customers receive the invoice:

1. They click Pay online now to view the invoice online
2. Clicking Pay online redirects them to your Shuttle payment link
3. The payment page shows the amount due and the invoice number as the reference, in the currency of your link. Your customer can select edit to change them.
4. Your customer enters their email address and payment details, and pays.

Payment reconciliation

To track payments made through Shuttle:

1. Turn on payment emails: in the Merchant Portal, select Configure in the menu, then Configure under Account, and turn on Send me an email notification of each payment. You’ll get an email for every payment
   • Each receipt includes the payment amount and invoice reference number

2. Reconciliation options:
   • Update Xero invoices manually based on email receipts
   • Use bank reconciliation to match payments when they appear in your bank feed
   • See the complete payment history under Activity in the Merchant Portal

The invoice number passed as the reference makes it easy to match payments to the correct Xero invoice.