Integration Test Hub — overview

A sandbox for testing how Booked it bookings flow into third-party systems. Live at test-hub.bookeditapi.co.uk.

How data flows

Inbound: Booked it pushes orders into the hub, which appear in real time on the home dashboard. Venue 16748 (BattleKart) and 12512 (Till Floats / Inrange) currently feed in.

Pulled: EPIC ticket data for venue 14113 is fetched from Booked it reports on a 5-minute schedule.

Outbound: Each integration pushes a booking on to its partner API and records the attempt so you can see per-booking sync status.

Access: the hub is PIN protected. Standalone device pages (cash draw, EPIC scanner, till embeds, this guide) are public so they can run on kiosks.

Integrations

BattleKart

Outbound push
/integrations/battlekart
  • Pushes a booking to a BattleKart track via api.battlekart.dev /v1/Game/Push using an API token and TrackId per venue.
  • Games currently start automatically on the track once pushed — staff approval would need a queue step in this app.
  • To add a venue you need: API token (dev/live), TrackId, environment and the Booked it venue ID.

Toast

Outbound push
/integrations/toast
  • Sends bookings to Toast in sandbox or production mode for POS testing.

Till Floats

In-app tool
/till-floats
  • Open floats, record cash sales against activity categories, and cash up tills.
  • X and Z reports are available under Reports; embeddable open/close screens live at /till-embed/open and /till-embed/close.

Cash Draw

Hardware
/cash-draw
  • Opens a physical cash draw from a browser-based POS flow. Public standalone page at https://test-hub.bookeditapi.co.uk/cash-draw — no login required, with copy/open buttons for the URL.
  • Each booking row has Print, Print + Cash, and Cash-only actions. Truly silent printing needs ESC/POS over WebUSB or Chrome's kiosk-printing flag.

EPIC Scanning

Door scanner
/epic-scanner/14113
  • Door-staff ticket scanner supporting HID scanners, camera scanning and name search, with an offline queue that syncs when the connection returns.
  • Staff sign in with a PIN. A demo account (Nick Andrews, PIN 1234) appears when a venue has no staff configured.
  • Ticket data is pulled from Booked it venue 14113 via the venue.ticket.details report, upserted into the EPIC tables, and refreshed every 5 minutes by a scheduled job (plus a manual Sync now button on the dashboard).

Inrange

Outbound push
/integrations/inrange
  • Creates golf-bay access PINs through the Inrange PIN API against a saved facility (Bristol Golf Centre on test).
  • Shows the booking feed from venue 12512 with a sync badge per booking, plus Sync now / Re-sync and Use for PIN actions.

Designs

Mockups
/designs
  • UI explorations: condensed Thank You page, Kokoloko checkout, the full POS journey, and an iframe viewport sizer.
  • Each design page includes a copyable HTML/CSS snippet for pasting into a WordPress Custom HTML block.
Setting up a venue

Every card on the dashboard has a settings icon where you set the Booked it venue ID that integration should use. Partner-specific credentials (BattleKart token, Inrange facility, Booked it report login) are stored as secrets or on the integration's own page.