Square connection setup
This guide walks you through connecting your Square account to LinkyFlow so you can work with your locations, catalogue, stock, orders, payments and refunds in Excel or in the web app. There is no key to copy.
Requirements
- A Square account, and its login
Step 1 — Connect with Square
- In Excel or the web app, open Connections → Add connection.
- Choose Square from the provider list.
- Click Connect with Square.
- Sign in at Square.
- Approve the permissions Square lists: items, inventory and payments, to read and to write, orders and merchant profile, to read. Connected before LinkyFlow wrote to Square? Reconnect to approve the new ones: until then, those writes are not offered.
Back in LinkyFlow, the connection is ready. It stays on the Square environment, production or Sandbox, where you approved it. LinkyFlow renews its access by itself: there is nothing to do when a token expires.
Step 2 — Load your first query
- Insert a LinkyFlow query and pick the Square provider.
- Choose Locations, select your connection in the Link field, and run it. It gives the location IDs that Orders asks for.
- Choose Payments or Orders: the first 100 rows load by default. Move on to the next page, or pick All results to read the pages in a row.
Square counts nothing, so no total is shown. A cursor lives 5 minutes: a list paged more slowly than that starts again.
Step 3 — Read an amount
An amount is a whole number in the minor units of its currency, beside that currency: 1250 with EUR is 12.50 EUR, and 1250 with JPY is 1250 JPY.
Ending LinkyFlow's access
In the Square Dashboard, go to Settings → App integrations, then Disconnect App on LinkyFlow: this ends its access, and the connection asks you to reconnect at its next call. Deleting the connection in LinkyFlow also asks Square to end the access, and tells you if Square refused. If another LinkyFlow connection uses the same merchant, the application stays authorized for it.
LinkyFlow keeps the tokens server-side: they are never shown, and never sent to an AI assistant.