Skip to content

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 on every plan from Essentials up. They are not on Lite. They work on Aruba Instant On, MikroTik and Ruckus networks too: CaptiFi checks the code, then signs the guest in through your access points or hotspot for the code's time, with nothing to change on the controller. They are not available on FortiGate. To switch them on:

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

WiFi Vouchers appears in the sidebar under WiFi & venues, and a Voucher & POS Setup card appears on the Settings page. The gear at the top right of WiFi Vouchers opens Voucher & POS Setup too, and Voucher & POS Setup has a link at the top back to WiFi Vouchers.

Access Modes ​

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

ModeHow guests connect
Free WiFi (default)Guests connect through your splash page without a code
Voucher requiredGuests 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 Settings → Voucher & POS Setup (or the gear on WiFi Vouchers), pick the venue, choose Free WiFi or Voucher required under Guest access mode, and click Save settings. Switch back to free access the same way at any time.

Code page: instructions and guest details ​

The Code page card on Voucher & POS Setup sets what guests read on the page that asks for their code, and whether it asks who they are.

  1. Go to Settings → Voucher & POS Setup and pick the venue.
  2. Under Instructions for guests, write how a guest gets a code, for example "Buy a drink at the bar or order at your table and you will get a WiFi code." It shows under your venue name, in plain text, up to 300 characters. Leave it empty to show the standard line.
  3. Under Ask guests for, tick First name, Email address or Phone number, and tick Required beside any the guest must fill in before they connect.
  4. Check the Preview, then click Save code page.

The answers are saved on the guest's visit and appear in your guest list like any other guest. When you ask for an email address or phone number, guests also see your marketing question as a box they can tick, never ticked for them, and they get online either way. Whenever the page asks for any detail it shows your terms and privacy notice, as your splash page does. At a UK venue that asks for a phone number, a guest who ticks the box is also told you may text them offers.

Once a venue reaches its plan's monthly new guest allowance, new guests still get online with their code, but their details are not saved.

Generating Vouchers ​

  1. Go to WiFi & 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, from 30 minutes, 1 hour or 90 minutes up to 7 days
    • Devices per code: how many phones or laptops can sign in with each code, from 1 to 1,000. Use 4 for a table of four sharing one receipt
    • Code prefix (optional): up to four letters or numbers to start every code in the batch, such as VIP
  4. Click Generate

The Generate vouchers window with Venue, Quantity, Access duration set to 90 minutes, Devices per code set to 4 and a TBL code prefix

Every device that signs in with a code gets the code's full access time from the moment it signs in, and uses up one of the code's devices.

Each code is eight random letters and numbers, and no two codes are the same. With a code prefix, every code in the batch starts with the prefix in capitals and the eight random characters follow it, so a prefix of vip gives codes such as VIPK7Q2M9AB. Spaces and symbols are not allowed in a prefix.

The new batch is shown with a copy-all option, and every code appears in the voucher table. The Devices column shows how many of a code's devices have signed in, such as 1 of 4. Use the per-code Revoke action to invalidate a code that shouldn't be used any more.

Printing code slips ​

Staff can hand out codes on paper, one slip per table or per tab.

  1. On WiFi Vouchers, tick the codes you want and click Print 3 selected (the button counts what you ticked), or click Print active codes for every active code on the page. After Generate vouchers, Print slips prints the batch you just made.
  2. The print page opens with the slips laid out ready to cut. Choose A4 or US Letter and click Print.

Each slip shows your venue name, the WiFi network name, the code, how long it lasts and for how many devices, and the line "Connect to the WiFi and type this code". You can print up to 500 codes at once.

Shared code that changes on a timetable ​

A shared code is one code for everyone at the venue, which changes every few hours. Staff can give it out at the bar or put it on the tables, and an old code stops working shortly after it changes.

  1. Go to Settings → Voucher & POS Setup and pick the venue.
  2. On the Shared code card, switch on Use a shared code at this venue.
  3. Choose how often it changes, from every 2 hours to once a day, the WiFi time for each guest, and the Devices per code (up to 1,000).
  4. Click Save shared code.

The card shows the Code now, when it changes, and the Next code, with Print to put both on slips. Codes change on your venue's own clock, counting from midnight, and each code keeps working for 15 minutes after the next one starts. Each guest gets their WiFi time from when they sign in. Switching the card off cancels the codes still to come; the code in use keeps working until it changes.

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. The till authenticates with a key that belongs to the venue. The key is shown once, when it is generated, and CaptiFi keeps only a hashed copy, so it cannot be looked up again later.

Connecting a till ​

  1. Go to Settings → Voucher & POS Setup and pick the venue.
  2. In the POS integration section, note the API endpoint. Your till calls this address to create codes; the copy button puts it on your clipboard.
  3. Under Till API key, click Generate key.
  4. A window opens headed Your new till API key. Copy it with the copy button or select the text. The only way out of the window is I have copied it, so a stray tap cannot lose the only copy.
  5. Paste the key into your till, or hand it to your POS administrator or till provider together with the endpoint.
  6. Switch the venue to voucher mode (above) when you are ready to go live.

The Your new till API key window with the key, the Copy button and I have copied it

Afterwards the Till API key card shows a hint: the captifi_pos_ prefix, stars and the last four characters, such as captifi_pos_****************************cdef. Beside it are Created and Last used. Last used moves each time the till calls in, so you can see whether the integration is working without touching the till. A till whose key ends with the same four characters as the hint is holding the live key.

Till API key card with the key hint, Created and Last used, and the Generate new key and Revoke key buttons

Generate new key issues a replacement and shows it once, the same way. The current key stops working the moment you confirm, so update the till straight after. Revoke key disconnects the till, which is refused until you generate a new key. Both actions ask you to confirm first.

Generating or revoking the key, changing the access mode and saving Till codes need the Manage integrations team permission. Other team members see the page without the buttons.

Keep your API key secret

The key allows anyone holding it to create WiFi codes for your venue. If you think it has been exposed, generate a new key. The old one stops working at once.

Till codes: WiFi time by spend ​

The Till codes card on Voucher & POS Setup sets what a code made by your till gives, so the till only has to send the order total.

  1. Go to Settings → Voucher & POS Setup and pick the venue.
  2. Under Devices per code, enter how many devices each till-made code can sign in, for example 4 so a table can share one receipt. Leave it empty for one device.
  3. Under WiFi time by order total, click Add spend tiers. The first tier starts at 0 and covers every order; choose its WiFi time, such as 1 hour.
  4. Click Add a tier for each bigger spend, enter the order total it starts at and choose its WiFi time, such as 2 hours from $11. You can have up to five tiers.
  5. Click Save till codes.

The Till codes card with Devices per code set to 4, orders from $0 getting 1 hour and orders from $11 getting 2 hours

When your till sends the order total as spend, the code lasts as long as the highest tier the total reaches: with the tiers above, a $9.50 order gets an hour and a $14 order gets two. Amounts are in the venue's own currency. A till that sends no total gets the first tier's time, and a venue with no tiers keeps the length the till asks for, or 24 hours. To remove the tiers, click the cross beside each higher tier, then the one beside the first, and save.

Toast receipts: WiFi from the check number ​

If the venue uses Toast, guests can get online with the receipt itself, so staff hand out nothing. The guest types the check number and the total printed on their receipt, and CaptiFi finds that check in your Toast orders. It works for orders rung up at the till, taken by a server, kept on an open tab or placed from the table.

You need the venue in voucher mode and Toast connected for it on the Integrations page (see Toast POS). Then:

  1. Go to Settings → Voucher & POS Setup and pick the venue.
  2. On the Toast receipts card, switch on Let guests use their Toast receipt.
  3. Under WiFi time per receipt, enter the minutes a receipt gives and click Save receipt settings. Leave it empty to use your spend tiers from the Till codes card, or 90 minutes if you have none.
  4. Click Copy beside Receipt footer text and paste it into Toast Web under Guest receipt setup, as the footer or the promo message, so every printed and emailed receipt tells guests how to get online.

Each receipt works like one code: it signs in as many devices as Devices per code on the Till codes card allows, the time runs from the first sign-in, and a phone that drops off gets the time it has left. The total has to match to the cent, with or without the tip. A receipt counts for 12 hours from when the check was opened, and a check voided in Toast never works. Guests who mistype get five tries every ten minutes.

WiFi code by email after a Toast order ​

Guests who order and pay at the table or online can get their WiFi code by email, with nothing to type from a receipt. With Toast receipts switched on, switch on Email guests a WiFi code after they order online or at the table on the WiFi code by email card just below it.

CaptiFi emails the code once per check, from your venue, to the guest's own email address on the Toast order. The code is the same one their receipt gives, with the same WiFi time and devices. It goes to checks paid in the last two hours on orders the guest placed themselves: Toast Tables (order and pay at the table), online ordering, the Toast Pickup App, Toast Local and kiosks. Orders rung up at the till, phone and catering orders, deliveries and DoorDash or Uber Eats orders get no email. CaptiFi reads your Toast orders every 15 minutes, so the email can take up to 15 minutes to arrive; typing the receipt works straight away.

Testing the POS Connection ​

Ask your POS provider to send a test request, or call the endpoint shown on the setup page with a tool like curl or Postman, using the key you copied. A successful call returns a voucher code. Check that it appears on the WiFi Vouchers page and that Last used on the setup page has moved, then try the code on your guest WiFi. The request and response shapes are on Rewards till API and terminal keys.

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. At a venue with Toast receipts switched on, they can tap Have a receipt? Use your check number and type the check number and total instead
  4. They're online for the code's duration, counted from when they sign in. When it runs out, the splash page comes back and they need a new code

If a device drops off the WiFi, the guest can type the same code again to get back on for the time they have left, without using up another of the code's devices. Once that device's time is up, the code gives it nothing more that day.

Troubleshooting ​

IssuePossible CauseSolution
Guests can't connect at allVoucher mode on with no codes distributedGenerate and distribute codes, or switch back to free access
Voucher code not workingCode already used, expired, or revokedLook it up on the WiFi Vouchers page (a revoked code is no longer listed); generate a new one
"The WiFi time on this code has run out on this device"The device has already used its time on that code todayGive the guest a new code
Till codes all last the same timeThe till is not sending the order totalAsk your till provider to send the order total as spend with each request
POS calls rejected (401)Wrong, missing or revoked keyCheck that the till's key ends with the same four characters as the hint on the Voucher & POS Setup page. If it does not, or the key was revoked, generate a new key and paste it into the till
POS calls rejected (422)Venue not in voucher modeSwitch the venue's access mode to Voucher required on the Voucher & POS Setup page
Splash page not asking for a codeVenue still in free modeSwitch the access mode to Voucher required and save
No WiFi Vouchers in the sidebar or Voucher & POS Setup on SettingsFeature not enabledToggle WiFi Vouchers & POS on the Integrations page

CaptiFi: Guest WiFi Marketing Platform