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 > ICR Touch
Click create new user
Securely save the username and password (You'll need to provide this to ICR touch later)
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 ICR Touch.
Step 3: Add site references to the ICR Touch integration page
All the sites you have created in Step 1 should now be visible on the integrations tile page.
Add some site references against each venue (avoid just doing 1 / 2 / 3 / 4 as this may cause a conflict if you have multiple integrators). These values will need to be mapped within ICR Touch, so that when a redemption happens - we know what location it was against.
Once you have created all the site references, create a list of Site names and References so that ICR can easily configure them at POS level.
Step 4: Send the API details and Site references to ICR Touch
You'll need to send the API username and password you created on Step 2 and your site names and references from Step 3 to your ICR Touch Account Manager / Setup team.
Please also remember to:
🔐 Password protect your file containing the API for extra security when sending. Don't send the API username and password 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 the recipient 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.
Step 5: Test the integration works
Once your ICR Touch Account Manager / Support 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 ICR Touch so we can help troubleshoot it.
Our other guide Using ICR Touch may also be useful.
The ICR Touch set up
Note: This is typically done by your ICR Touch contact.
Configurations do vary from installation to installation, so this is an approximate guide only. If you need further support, please speak to your ICR Touch Account Manager / Support team.
The Products / Buttons will need to be created and mapped onto the POS.
Within your appSettings.json (Config file) for Toggle, you will need to specify;
Endpoint: https://api.mytoggle.io/graphql (Note, this will never change)
Username: As provided by Client (Step 2 above)
Password: As provided by Client (Step 2 above)
Siteid: As provided by the Client (Step 4 above)
If you need help or have questions please contact our support team at success@usetoggle.com.