All Collections
Integrations
EPOS
How to connect Samtouch with Toggle
How to connect Samtouch with Toggle
Stephen Evans avatar
Written by Stephen Evans
Updated over a week ago

Note: Only Store Owner users can create the API on Step 2.

Samtouch is part of Langley Compass Group (LCG) and includes Tillwise as part of this integration, if you use them.

Summary

  1. Add your site(s) to Toggle

  2. Create an API on Toggle

  3. Send the API details to Samtouch

  4. Add Samtouch's site IDs to Toggle

  5. 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.

  1. Log in to Toggle

  2. On the sidebar click Settings > Site Settings

  3. Add the site name, its address, and any number or reference for it

  4. Click add

  5. 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).

  1. Log in to Toggle

  2. On the sidebar click Settings > Integrations > Samtouch

  3. Click create new user

  4. 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 Samtouch and ask for your site IDs

You'll need to send the API username and password you created on Step 2 along with the info below to your Samtouch Account Manager.

  1. Copy the table below into something like a Word document

  2. Add the API username and password to it

  3. Password protect the file for security

  4. Send the file to your Samtouch Account Manager asking them to configure your tills

  5. Ask your Samtouch Account Manager for your site IDs

API endpoint

https://api.mytoggle.io/graphql

Username

(add the username you create here)

Password

(add the password you create here)

Merchant ref

LCG = 48, Samtouch = 50, Tillwise = 51

Standard in-store product ID

(find this on Shop > In-Store gift)

Account ID

(ask Toggle for this)

The API endpoint is always https://api.mytoggle.io/graphql and the merchant ref is either 48, 50, or 51 depending on the till system you're using.

Please get in touch with success@usetoggle.com to get your account ID.

Step 4: Add site IDs to Toggle

Whilst your Samtouch Account Manager does the relevant configuration using your API details, add the site IDs they sent you to Toggle.

  1. Log in to Toggle

  2. On the sidebar click Settings > Integrations > Samtouch

  3. Paste in each ID to their respective site

  4. Save

The site IDs 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.

Step 5: Test the integration works

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

We recommend you:

  1. Send yourself a free of charge digital voucher

  2. 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 works durng 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.

The Samtouch set up

Note: This is usually done by your Samtouch Account Manager. However, if you are self-managing your installation, this guide will help you configure your Samtouch POS to work with Toggle.

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

  • Advanced settings

  • Options

  • Advanced

  • Integrations

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

  • URL - https://api.mytoggle.io/graphql

  • Username - See step 2/3 above

  • Password - See step 2/3 above

  • Timeout / Currency - GBP

  • Account to use - Once you have added a username and password, you can hit 'Find' which will test the connection and provide you an account to select

  • Merchant ID - 50

  • Sales channel ID - 3

  • EPOS Reference - The EPOS reference for the site. Note, these should already be configured in Toggle (see step 4 above), but please contact your Customer Success contact if you are unsure

Product Setup

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.

If you need help or have questions please contact our support team at success@usetoggle.com.


​

Did this answer your question?