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://prod.turnstay.com/api/v1/public/payment_link/{your-link-id}?customerName=&merchantReference=[INVOICENUMBER]&billingAmount=[AMOUNTDUE]&customerPhoneInput=&customerEmailInput=
    Get your base URL from your TurnStay Dashboard, then append the parameters above.
    Save

    Account Name: TurnStay

    Custom URL: Start with your Universal Payment Link from the TurnStay Dashboard (it ends with ?), 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://prod.turnstay.com/api/v1/public/payment_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