Skip to content
TurnStay TurnStay TurnStay FAQs

Xero Integration

Xero’s custom payment URL feature lets you embed invoice data directly into your TurnStay payment link. When a guest clicks Pay Now on an invoice, the invoice number and the exact amount due are pre-populated - no manual entry required.

  1. Add a new payment service in Xero

    Section titled “Add a new payment service in Xero”

    Go to Payment Services in your Xero account and click Add Payment Service.

    go.xero.com / payment-services / add-services
    Payment services
    Connect a payment service so your customers can pay invoices online.

    ＋ Add payment service

  2. Select Custom Payment URL

    Section titled “Select Custom Payment URL”

    From the list of payment service options, choose Custom Payment URL.

    go.xero.com / payment-services / add-services
    Choose a payment service
    Stripe
    PayPal
    Custom Payment URL
    ✓
  3. Section titled “Configure your TurnStay payment link”

    Fill in the payment service details as follows:

    go.xero.com / payment-services / add-services
    Custom Payment URL
    Account Name
    TurnStay
    Custom URL
    https://payment.prod.turnstay.com/payments/link/{your_link_id}?customerName=&merchantReference=[INVOICENUMBER]&billingAmount=[AMOUNTDUE]&customerPhoneInput=&customerEmailInput=
    Copy your payment link from the TurnStay Dashboard, add a ? immediately after the link id, then append the parameters above.
    Save

    Account Name: TurnStay

    Custom URL: Start with your Universal Payment Link from the TurnStay Dashboard. Add a ? immediately after the link id, then append:

    customerName=&merchantReference=[INVOICENUMBER]&billingAmount=[AMOUNTDUE]&customerPhoneInput=&customerEmailInput=

    Once filled in, click Save.

The complete URL

Section titled “The complete URL”

Here’s what your full Custom URL should look like once assembled:

https://payment.prod.turnstay.com/payments/link/{your_link_id}?customerName=&merchantReference=[INVOICENUMBER]&billingAmount=[AMOUNTDUE]&customerPhoneInput=&customerEmailInput=

When a guest clicks Pay Now on a Xero invoice, Xero replaces [INVOICENUMBER] and [AMOUNTDUE] with the actual invoice data - so the TurnStay payment page opens pre-filled with the correct reference and amount.

How it works

Section titled “How it works”
📄
Guest receives Xero invoice
→
🔗
Clicks Pay Now - Xero injects invoice number & amount into the URL
→
💳
TurnStay payment page opens pre-filled and ready to pay

Reconciling the invoice in Xero

Section titled “Reconciling the invoice in Xero”

Paying on that page creates a TurnStay payment. It does not mark the Xero invoice as paid. TurnStay does not send the payment back to Xero, so someone on your team still has to reconcile the invoice in Xero by hand.