Note: Only Store Owner users can create the API on Step 2.
Summary
Add your site(s) to Toggle
Create an API on Toggle
Send the API details to 3S POS
Test if a gift voucher works at your site(s)
Step 1: Add your site(s) on Toggle
If needed here's more info on how to add sites (video included).
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
Add the site name, its address, and any number or reference for it
Click add
Repeat this step for however many sites you need to add
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 > 3S POS
Click create new user
Copy the username and password onto a separate document and press create
Once you click create you can't retrieve the API password again so that's why we recommend saving it in a separate document.
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 as well as the site IDs along with the info below to your 3S POS Account Manager.
Copy the table below into something like a Word document
Add the API username and password to it
Password protect the file for security
Add site references to Toggle, within the 3S-POS tile first and attach the list when sending the below information to 3S-POS
Within the 3S-POS platform, when configuring, select the relevant site reference as part of the setup
API endpoint: | |
Username: | (add the username you create here) |
Password: | (add the password you create here) |
Merchant ref: | 15 |
Once the connection is made from the 3S-POS platform, the account ID and product reference can be selected through their interface.
The API endpoint is always https://api.mytoggle.io/graphql and the merchant ref 15 - don't change this.
Please get in touch with success@usetoggle.com to get your account ID.
Step 4: 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 it, check balance)
Other people on your team may benefit from seeing how gift vouchers work 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.
Our other guide Using Toggle on 3S POS may also be useful.
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 (obtained from Toggle)
API Password (obtained from Toggle)
Account ID (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.
In-Store 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.
Further support
If you need further support regarding till configuration, please get in touch with your 3S POS account manager.