Connect a POS to ticket sales
Use this when a counter till should start selling ToucanTix events, admissions, products, or vouchers.
A point of sale The staff-facing sales surface used for counter sales and live operations. in ToucanTix represents one till or kiosk and acts as a sales channel A setting that controls where an offer can be sold, such as the online shop, POS, back office, or an external point of sale.. The physical till runs the KORONA POS; ToucanTix provides the ticket-sales screens that open on it.
Before you start
Confirm:
- the KORONA.studio integration is set up under Admin > Integrations (account ID, URL, and credentials), because points of sale are imported from KORONA
- you know which events or admissions the POS should sell
- you have permission for Points of sale and Integrations
Sync and review the point of sale
- In the back office, open Admin > Integrations.
- In the KORONA.studio integration section, select Synchronize (or Save and synchronize after changing credentials). This imports points of sale and their organizational units from KORONA.
- Open Settings > Points of sale. The list shows Name, Number, Type, Coupling, Order channel, and Shops for each point of sale.
- Open the point of sale to review it. Synced entries are managed externally: core details stay read-only in ToucanTix, and you edit only the local settings, such as an optional Primary order channel and, for kiosks, Kiosk hours.
Couple the point of sale
- In Settings > Points of sale, check the Coupling column. Each point of sale shows Coupled or Uncoupled.
- Select Couple on the point of sale you want to connect. Use Decouple to disconnect it again.
Coupling registers the point of sale with your KORONA account so ToucanTix and the till can exchange receipt data for sales made through it.
Make offers sellable on the POS
Events and admissions appear on the POS only when a sales channel rule points at that point of sale:
- Open the offer under Services and select the Sales channels tab.
- Add or edit a rule and include the point of sale under Sales channels.
- Check that at least one price is visible for the channel: on the price rules, review Visible on the following sales channels.
See Control where an offer is sold for quantity limits and sales periods per channel.
Open the ticket screens on the till
Cashiers open the ToucanTix POS screens from the KORONA till. Under Admin > Integrations, the External system calls section provides the Display URLs for the three POS screens — Offers (book events and admissions), Agenda (today's events and their attendees), and Orders (find and manage existing orders) — together with a Login and Password. These values are entered in the KORONA-side configuration so the till can call the screens; when the till opens a screen, it passes its point-of-sale number and the credentials, and ToucanTix signs the session in automatically.
Expected result
The point of sale shows Coupled, the intended events appear on the POS Offers and Agenda screens, and counter sales create orders attributed to that point of sale.
Troubleshooting
| Problem | What to check |
|---|---|
| Point of sale is missing from the list | KORONA.studio integration credentials, then run Synchronize again. |
| Coupling fails or shows Uncoupled | Whether the entry was synced from KORONA and your KORONA account accepts the coupling; retry Couple. |
| Event is missing on the POS | The offer's Sales channels rule includes this point of sale, prices are visible for it, and sales are still open. |
| POS screens ask for credentials | The External system calls login and password configured on the KORONA side match the values shown in the back office. |