The sites you'll be redeeming gift cards at need adding to Toggle. This step might already be done, but it's worth checking.

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:

If needed here's more info on how to create the API (video included).

⚠️ *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 Samtouch.

Example below of creating the API username and password:

You'll need to send Samtouch your Toggle product ID and Account ID along with the API. You can add these to the same spreadsheet.

Your in-store product ID is found on Shop > In-Store Gift

Example below:

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 - Samtouch will use that info to complete their configuration later on.

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 Samtouch Account Manager.

Ask your Samtouch Account Manager for your EPOS references during this stage too.

Please also remember to:

🔐 Password protect your file containing the API for extra security when sending it to Samtouch. Don't send the API username and password to Samtouch 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 Samtouch 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 Samtouch:

Whilst your Samtouch Account Manager configures your tills using your API details, add the EPOS references they sent you to your Toggle account.

The EPOS references allow the Samtouch and Toggle system to know where a gift card was sold or redeemed at. Without these IDs in Toggle your integration won't work.

Example below of adding the EPOS references to Toggle:

Once your Samtouch Account Manager has confirmed they've configured your tills it's good to check vouchers do work.

We recommend you:

🧠 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 Samtouch so we can help troubleshoot it.

Our other guide Using Toggle on Samtouch POS may also be useful.

This setup will need to be complete on each terminal that you wish to use Toggle. Within your settings on your POS, go to;

From here, select 'Toggle' down the left hand menu. This will bring some options for configuration

Once you are integrated with Toggle, you need to setup the payment buttons on the POS.

You can either set the buttons up as fixed amounts, or for a 'custom' amount where the value can be defined by the customer.

Once you have setup a product, you can link this to a Product within your Toggle shop by going to the Product Editor > Associated links > Selecting Product Search

This will return a list of Products you have setup in your toggle account, for which card sales will be associated. If you are unsure which Product to use, please contact a member of Customer Success and they will be able to advise.

The toggle buttons will need to be manually added to the screen via the screen designer. The Credit/Debit functions are "Paid In/Paid Out" and the payment is a Media key and Balance Enquiry / Cancel Card are new function keys.

For any more detail on setting up products, please get in touch with your POS provider and they will be able to assist.

​