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 (and get Account ID)
If needed here's more info on how to create the API (video included).
Log in to Toggle
On the sidebar click Settings > Integrations > 3S POS
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 3S POS.
Example below of creating the API username and password:
Your Account ID is found on the account details section of your dashboard sidebar.
Example below:
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 - 3S POS might need it to complete their configuration later on.
Step 3: Send the API to 3S POS and provide the site IDs
You'll need to send the API username and password you created on Step 2 along with your in-store product ID and Account ID to your 3S POS Account Manager.
Ask your 3S POS Account Manager for your store IDs during this stage too.
Please also remember to:
🔐 Password protect your file containing the API for extra security when sending it to 3S POS. Don't send the API username and password to 3S POS 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 3S POS 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 3S-POS:
Step 4: Add site references to Toggle
Whilst your 3S POS Account Manager configures your tills using your API details, add the site references they sent you to your Toggle account.
If they ask you for these references then you can simply create your own references and let them know what they are, so they can duplicate them on their system.
Log in to Toggle
On the sidebar click Settings > Integrations > 3S POS
Add each site reference to their respective site
Save
The site references allow the 3S POS and Toggle system to know where a gift card was sold or redeemed at. Without these references in Toggle your integration won't work.
Example below of adding the site references to Toggle:
Step 5: Test the integration works
Once your 3S POS 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 3S POS so we can help troubleshoot it.
The 3S-POS set up
Note: This part is usually done by your 3S POS Account Manager.
Within the 3S POS back office, go to:
Company
Settings
Company Info
On this page will be a ‘Toggle’ button, to setup the connection.
When selected, you will be prompted to add;
API username (see step 2 above)
API Password (see step 2 above)
Account ID (See step 2 above. Once the API details are added and checked, you can select the `Get account id details` button - which will get your account ID)
For each venue, you will need to set this up - and configure the EPOS unit reference (Note, these should be added in Toggle first - under Settings > Integrations > 3S-POS)
In-Store gift card - this will populate with a list of products from your Toggle account. Select the product you would like Physical card sales to be associated to.
Digital gift card - this will populate with a list of products from your Toggle account. Select the product you would like Digital card sales to be associated to.
Once configured you will be able to Sell, Redeem and use Toggle gift cards towards payments.
If you have questions or need help please contact our support team - success@usetoggle.com.