Note: Only Store Owner users can create the API on Step 2.
Step 1: Add your site(s) on Toggle
The sites you'll be redeeming gift cards at need adding to Toggle. This step might already be done, but it's worth checking.
Log in to Toggle
On the sidebar click Settings > Site Settings and click Add site
Add the site name, its address, and any number or reference for it
Click the green Add button to save the site
Repeat this step for however many sites you need to add.
If needed here's more info on how to add sites (video included).
Example below:
Step 2: Create an API on Toggle
If needed here's more info on how to create the API (video included).
Log in to Toggle
On the sidebar click Settings > Integrations > Access
Click create new user
Copy the API username and then copy the password to this spreadsheet
Once copied across press Create to save the API*
⚠️ *Once you click create you can't retrieve the API password again. If you accidentally created the API without noting it down the password just re-start the above steps to make a new one.
🧠 You only need one API for your Toggle account that can be used at all your sites that use Access.
Example below of creating the API username and password:
After you have completed these steps your spreadsheet will look a bit like this -
The parts highlighted in blue shouldn't be edited or deleted - Access will use that info to complete their configuration later on.
Step 3: Send the API to Access and ask for your Unit IDs
You'll need to send the API username and password you created on Step 2 to your Access Account Manager.
Ask your Access Account Manager for your Unit IDs during this stage too.
Please also remember to:
🔐 Password protect your file containing the API for extra security when sending it to Access. Don't send the API username and password to Access within the email itself - hackers can potentially get hold of that info in the future.
One option here is you could password protect your file and text the password to your Access Account Manager to access the spreadsheet.
🧠 Keep your API filed saved somewhere secure on your device in case you ever need to refer back to it in the future.
Example email to send to Access:
Step 4: Add the Unit IDs to Toggle
Whilst your Access Account Manager does the relevant configuration using your API details, add the unit IDs they sent you to Toggle.
Log in to Toggle
On the sidebar click Settings > Integrations > Access
Paste in each ID to their respective site
Press Save
Now go to Settings > Site Settings and add the same Unit IDs to their respective sites (you may need to remove any existing IDs here and replace them with the Unit IDs) and press Save
The Unit IDs allow the Access and Toggle system to know where a gift card was sold or redeemed at - this information will pull through to your Toggle reports. Without these, the integration won't work.
Example below of adding the Unit IDs to Toggle:
Step 5: Test the integration works
Once your Access Account Manager has confirmed they've configured your tills it's good to check vouchers do work.
We recommend you:
Send yourself a free of charge digital voucher
Use the voucher code on the till to see if it works (e.g. redeem/reverse, and check balance)
🧠 Other people on your team may benefit from seeing how gift vouchers works during this stage.
❗If an error is flagged on the till, get in touch with Toggle and Access so we can help troubleshoot it.
Our other guide Using Toggle on Access POS may also be useful.
The Access set up
Note: This part is usually done by your Access Account Manager.
However, if you are self-managing your installation, this guide will help you configure your Access POS to work with Toggle.
Note that configurations do vary from installation to installation, so this is an approximate guide only. This guide also assumes some prior knowledge of configuring and managing Stocklink/POSlink. If you need further support, please speak to your Access Account Manager.
Setting up the interface
1 - On Stocklink navigate to POS Control > Interfaces and select a location.
2 - Select to load Record Type 2: Toggle.
3 - Populate the fields with the username, password and merchant reference provided by Toggle.
4 - Enter a unique identifier for each location in the Unit ID field. You then need enter this same identifier in the EPOS site reference field in Toggle on the sites page.
5 - Bulk update to other locations as appropriate and amend Unit IDs at each location to match Toggle locations.
Setting up the media
1 - On Stocklink navigate to POS Control > Media and select a location.
2 - You can create a new media or change your existing gift card Media Type to Toggle Gift Card.
3 - Add the media key to the payment keyboard.
4 - Bulk update the media and payment keyboard to other locations as appropriate.
Setting up a mag-card configuration (only required for physical swipe cards)
1 - On Stocklink navigate to POS Control > Mag Card Configuration and select a location.
2- You can create a new mag card rule or change your existing gift card rule type to Toggle Gift Card.
3 - If migrating from another system, complete the Toggle import process before switching over.
4 - Bulk update to other locations as appropriate.
Setting up Gift Card PLUs (only required for selling physical swipe cards on location)
1 - On Stocklink navigate to POS Control > PLU and select a location.
2 - You can create new PLUs or change your existing PLU’s Credit PLU Type to Toggle Gift Card.
3 - Add the PLUs to main keyboards and bulk update to other locations as appropriate.
Setting up Global Flags
1 - On Stocklink navigate to POS Control > Global Flags and select a location.
2 - Ensure Flags 1 > View Options > Swipe Only On Gift Cards is disabled.
3 - Bulk update global flags as appropriate.