Link a Square account and check its locations
This page links one Square account to your Simpro booking forms. The Square sign-in itself happens under Integration Credentials, and this page picks which credential the forms use.
Before you start
- Payments need a Simpro booking form subscription.
- The Square account needs at least one location. Every Square payment is taken against a location.
Step by step
- Open Integration Credentials, create a Square credential and click Login with Square. Formpiece takes you to Square to sign in and brings you back.
- Click Settings in the Simpro Bookings menu, then Square under Form Setup.
- Pick the credential in Square Credential.
- Click Check locations. A green message lists the locations Formpiece found.
- Click Update Square credential. The page shows "Square credentials updated".
The Square Credential dropdown only appears once the account has a Square credential. Until then the page shows two greyed out buttons and no link to create one, so make the credential under Integration Credentials first. After that, Create new Square credential on this page opens the same form.
To unlink Square, clear the dropdown with its cross and click Update Square credential.
What Check locations tells you
| Message | What it means |
|---|---|
| "Connected to Square. 2 locations found: ..." | Formpiece reached Square with the selected credential and lists the location names. |
| "Connected to Square, but no locations were found. Payments cannot be taken until the Square account has a location." | The sign-in works and the Square account has no location. Add one in Square. |
| "Could not connect to Square. Please log in to Square again." | The credential no longer works. Open it under Integration Credentials and click Login to Square. |
The check runs against the credential selected in the dropdown, saved or not.
Choosing Square on a form
Linking the credential does not switch a form to Square. On each form's Payments page, Payment processor offers Stripe and Square when both are linked, and Square location lists the locations from this credential. A form with Allow payments on needs a location, and Save stops with "Please select a Square location." without one.
When it goes wrong
Payments says "Stripe integration required!"
Today the Payments page only opens its settings when a Stripe credential is linked, even if Square is linked as well. With Square alone you see that message and no Allow payments switch. Link a Stripe credential under Stripe to get past it.
The Square location list is empty on Payments
No Square locations were found. appears under the dropdown. Check the Square account, then run Check locations here again.
Square card fields do not appear on the booking form
The published form needs both the Square location and Formpiece's Square application ID. The form shows "Note: The Payment Gateway has not been set up." when either is missing. Choose a location on Payments and save so the form is updated.