WiFi Vouchers & POS Integration

Require a voucher code before guests can use your WiFi. Generate batches of codes from the dashboard, or connect your point-of-sale system so codes print automatically on receipts.

Enabling Vouchers

Vouchers are an opt-in feature:

1. Log in to my.captifi.io
2. Go to Integrations
3. Under Dashboard features, switch on WiFi Vouchers & POS

Two new items appear in the sidebar under My Venues: WiFi Vouchers and Voucher & POS Setup.

Access Modes

Each venue is in one access mode at a time, set on the Voucher & POS Setup page:

Mode	How guests connect
Free (default)	Guests connect through your splash page without a code
Voucher	Guests must enter a valid voucher code on the splash page to get online

Before switching to voucher mode

Once voucher mode is on, only guests with valid codes can connect. Make sure you have codes generated and a way to hand them out (receipts, staff, table cards) first.

To switch: open My Venues → Voucher & POS Setup, choose the access mode, and click Save settings. Switch back to free access the same way at any time.

Generating Vouchers

1. Go to My Venues → WiFi Vouchers
2. Click Generate vouchers
3. Fill in:
   • Venue — which venue the codes are for
   • Quantity — 1 to 100 codes per batch
   • Access duration — how long each code keeps a guest online
4. Click Generate

Codes are unique 8-character combinations of letters and numbers.

The new batch is shown with a copy-all option, and every code appears in the voucher table. Use the per-code Revoke action to invalidate a code that shouldn't be used any more.

POS Integration

Connect your point-of-sale system (till) so it can generate voucher codes automatically — for example, printing a WiFi code on every receipt.

1. Go to My Venues → Voucher & POS Setup
2. In the POS integration section, generate your API key
3. Note the API endpoint shown on screen — your POS calls this to create codes
4. Give the key and endpoint to your POS administrator or till provider
5. Switch the venue to voucher mode (above) when you're ready to go live

The setup page shows everything your POS provider needs, including a ready-to-use generate endpoint. You can regenerate the key at any time (the old key stops working immediately) or disconnect the integration.

Keep your API key secret

The key allows anyone holding it to create WiFi codes for your venue. If you think it's been exposed, regenerate it from the setup page.

Testing the POS Connection

Ask your POS provider to send a test request, or use the endpoint shown on the setup page with a tool like curl or Postman. A successful call returns a voucher code — check it appears on the WiFi Vouchers page, then try it on your guest WiFi.

How Guests Use Vouchers

1. Guest connects to your WiFi and your splash page appears
2. The splash page asks for a voucher code
3. Guest enters the code from their receipt or card
4. They're online for the code's duration; when it expires they need a new code

Related Features

• Paid WiFi — charge for access by card instead of codes
• Splash Page Builder — the page where guests enter codes
• Multi-Venue Management — vouchers are managed per venue

Troubleshooting

Issue	Possible Cause	Solution
Guests can't connect at all	Voucher mode on with no codes distributed	Generate and distribute codes, or switch back to free access
Voucher code not working	Code already used, expired, or revoked	Check its status on the WiFi Vouchers page; generate a new one
POS calls rejected (401)	Wrong or missing API key	Compare the key against the Voucher & POS Setup page; regenerate if unsure
POS calls rejected (422)	Venue not in voucher mode	Switch the venue's access mode to Voucher on the Voucher & POS Setup page
Splash page not asking for a code	Venue still in free mode	Switch the access mode to Voucher and save
Vouchers sidebar items missing	Feature not enabled	Toggle WiFi Vouchers & POS on the Integrations page