Connect KORONA.entry

Use this to connect ToucanTix to a KORONA.entry server so that sold tickets can be scanned at gates and turnstiles, and to keep the connection healthy after credential changes. ToucanTix does not scan tickets itself; scanning is done by KORONA.entry hardware.

Integration settings and connection status in the back office — Use the integrations area to verify credentials, connection state, and external-system setup.

Before you start

Confirm:

you have the URL, username, and password of the KORONA.entry server
you have back-office access to Admin > Integrations
you know your ToucanTix account's time zone

Steps

In the back office, open Admin > Integrations.
In the KORONA.entry Integration section, enter Username, Password, and URL.
Select Save and synchronize. The message "KORONA.entry integration synchronized successfully" confirms that ToucanTix can reach the entry server with these credentials.
Set up entry webhooks and the event receiver in KORONA.entry so scan results flow back to ToucanTix. Follow Set up scanners and entry hardware.

How data flows between the systems

After a ticket is sold, ToucanTix activates it in KORONA.entry so the gates recognize it. Activation happens per attendance and is retried automatically on temporary errors.
Scan results, ticket creations, and ticket updates in KORONA.entry are sent back to ToucanTix through entry webhooks and recorded as entry events on the matching ticket, including denied scans and the reason.
Ticket state is matched by ticket number or the external ticket ID, so the back office shows the same ticket the gate saw.

Credential changes

When the password or username is changed on the KORONA.entry server, ToucanTix requests start failing with authorization errors, ticket activations queue up, and freshly sold tickets stop reaching the gates.

Update Username, Password, and URL in the KORONA.entry Integration section.
Select Save and synchronize. Besides saving, this re-runs the queued entry jobs so pending ticket activations catch up.
Sell or pick one test ticket and confirm it scans at a gate.

Expected result

New tickets are accepted at the gates shortly after purchase, and every scan appears as an entry event on the ticket in the back office attendee detail.

Troubleshooting

Problem	What to check
Synchronize fails with an authorization error	Username and Password match the current KORONA.entry credentials, and the URL points to the right server.
Fresh tickets are unknown at the gate	Whether the last synchronization succeeded, and re-run Synchronize after fixing credentials to release queued activations.
Scans do not appear in ToucanTix	The event receiver configuration in KORONA.entry, and whether the entry webhooks show a recent received event.
Valid tickets rejected near midnight or date edges	The KORONA.entry server time zone matches your account time zone.