Square

Square checkout links for your bookings

If you already take payments with Square, the Square plugin lets your website use the same account. Travellers pay with a card, Apple Pay, Google Pay or Cash App Pay on Square's hosted checkout, and the money goes to your Square account.

Each checkout is a Square payment link with a single line for the booking, the traveller's email filled in and the booking reference in the payment note, so payments are easy to match in Square.

Access token, location and currency

Square needs two things: an access token from your Square application, and the ID of the location payments are taken for. When you connect, Tourtify checks both with Square and shows the location's name and currency.

Square charges in the location's own currency, and the plugin supports USD, CAD, GBP, EUR, AUD and JPY. Price your tours in the currency of the location you connect; the status panel warns you if your website sells in a currency Square doesn't take.

Confirming payments

When the traveller returns, Tourtify reads the Square order behind the payment link and checks its payments. A completed payment confirms the booking; a cancelled order closes it. Payments that are still approved or pending wait.

With the webhook set up, payment.updated confirms the booking as soon as Square completes the payment. Tourtify checks each notification's signature against your signature key and the exact webhook URL registered in Square. Without the webhook, pending payments are checked every five minutes.

Refunds, disputes and payouts

Refunds from a booking are sent to Square with an idempotency key. Completed refunds you make in Square come back through refund.updated and show up on the booking.

Square disputes appear in Tourtify with their state, reason and due date. You can send Square the booking's evidence pack PDF and a short summary from Tourtify, or accept the dispute. Square payouts and their entries (charges, refunds, fees and adjustments) are also read from Square for payout reconciliation.

Setting up Square

1. 1Open your Square application. In the Square Developer Dashboard, open your application › Credentials and copy the Sandbox access token to test, or the Production token to go live.
2. 2Find your location ID. Under Locations, copy the ID of the location whose currency matches your prices.
3. 3Connect on the Payments page. Paste the token and location ID and choose Test or Live. Tourtify shows the location's name and currency once Square accepts them.
4. 4Add a webhook subscription. In your application › Webhooks, add a subscription with the URL shown in the plugin and tick the listed events.
5. 5Paste the signature key. Copy the subscription's signature key into the plugin's Webhooks section, then make a sandbox booking to check it confirms.