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 Datasym / DBE.

​Example below of creating the API username and password:
​

You'll need to send Datasym / DBE 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 - Datasym / DBE 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 Datasym / DBE Account Manager.

Ask your Datasym / DBE Account Manager for your POS References during this stage too.

Please also remember to:

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

Whilst your Datasym Account Manager configures your tills using your API details, add the POS References they sent you to your Toggle account.

(Or make up your own POS References for each site on Toggle e.g. 1, 2, 3 etc and let Datasym know what they are, so they can match them on their system).

The POS References allow the Datasym 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 POS References to Toggle:

Once your Datasym 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 Datasym so we can help troubleshoot it.

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

To get started, ask your DBE Account Manager to configure Toggle on your installation of DBE (Datasym) POS. They will enable Toggle Gift Cards on your POS system. Once the configuration is complete, Toggle Gift Cards will be available as a payment method on your POS.

If you are managing the configuration of your POS installation, follow the steps below.

DPOS SQL Setup (Self managed configuration only)

Please note: The below instructions only apply if you are configuring your own POS system. Otherwise, get in touch with your POS support who will handle this setup for you.

Toggle Gift cards are enabled by selecting Toggle from the dropdown list on the Gift Cards page of the DPOS SQL config editor:

This will display all the config fields below that need information entered to complete the setup. Refer to Step 2 and 3 of the DBE: Connecting your tills with Toggle guide to get these details.

The currency will be GBP.

The POS Reference needs to be the same one that you enter when you configure your sites in Toggle. So you can make one up, as long as you use a unique reference for each of your sites, if you have more than one.

DPOS SQL Database (Self managed configuration only)

You will need to ensure the Gift Card MOP (Method of Payment) is enabled in the MOPS table of the DPOSQL database. If you want the values taken on gift cards included in the z-read you will also need to set the IncludeInDrawCount column to ‘True’.

Stockade (Self managed configuration only)

To set up a button to sell a gift card you will need to add a new button to the till via the schema editor (Maintenance > POS Buttons).

The button type is ‘Gift Card’ and in the data field you can enter the value. e.g. 10 = £10. This allows you to sell preset gift card values (e.g. £10 Gift Card). However, if you want to allow open priced gift card, then leave the data field blank.

​