Technology Providers
Integrate your platform with Localoy once, and act for every partner who connects it — with exactly the access each partner grants.
A Technology Provider is a platform that Localoy partners already use to run their business: a ticketing system, a point-of-sale, a booking engine, a website builder. This book is for the engineers who build one.
You integrate with Localoy once. Each partner who uses your platform then connects it to their Localoy account from the Partner Portal, chooses what it may do, and hands you a one-time code. From then on your server calls the Open Network API for that partner, with your own key.
Who this book is for#
| You are building | Read |
|---|---|
| A platform that serves many Localoy partners — ticketing, POS, booking, ERP, hotel or website software | This book. You hold one set of provider keys and act for every partner who connects you. |
| Your own business's link to your own Localoy account | The Open Network API book. You need a partner API key, not a provider key. |
The model in one picture#
- Localoy → Your server: Provider keys (ltp_…)
- Your server → Partner: Deep link: connect to Localoy
- Partner → Localoy: Grant scopes, generate code
- Localoy → Partner: LCC-… valid 15 minutes
- Partner → Your server: Paste the code
- Your server → Localoy: POST /connections/claim
- Localoy → Your server: 201 connection with partnerId
- Your server → Localoy: API call + X-Localoy-Partner-Id
- Localoy → Your server: Webhooks, each with its partnerId
Your key says who is calling. The connection says for whom, and what that partner allowed. A call made for a partner needs both.
What a partner can let you do#
| The partner grants | You can |
|---|---|
REGISTRATION | Create catalogue items for the partner and link them to its tickets, activities or tables. |
UPDATE | Change and remove the items you created for the partner. |
INVENTORY | Read your items and the bookables you can link them to. |
PAYMENT | Read the partner's payment sessions, report results and record refunds. |
BOOKINGS | Receive the partner's bookings as webhooks. |
Localoy decides which of these you may ask for, and which modules — events, dining, activities — you serve. The partner decides which to grant, and can pause, narrow or end the connection at any time. See How it works.
What stays with the partner#
- Consent. Only the partner, signed in to its own account, can connect you or give you more access.
- Its settings. The checkout URL and the inventory endpoint Localoy calls are saved by the partner in its Partner Portal. See Settings each partner saves.
- Visibility. Every call you make for a partner appears on its Open Network → Activity page, under your name.