This is a hands on setup, that requires someone with access to your Toggle account and EMC to setup and configure elements on the POS.
Toggle Setup
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
If needed here's more info on how to create the API (video included).
Log in to Toggle
On the sidebar click Settings > Integrations > Oracle
Click create new user
Copy the username and password and store them somewhere secure (you'll need these later)
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.
Example below of creating the API username and password:
You will need these fields for the configuration file:
Toggle_User
Toggle_Pass
Step 3: Add site IDs to Toggle
Within Oracle, there are multiple IDs which can be used as part of the site mapping (which tells Toggle which location that the redemption / sale occurred at). By default, we will use the Property ID - but you can configure the following options if there is another ID that is more relevant.
Obtain a list of your site IDs from your Oracle POS.
Log in to Toggle
On the sidebar click Settings > Integrations > Oracle
Paste in each ID to their respective site
Save
Without these IDs in Toggle your integration won't work.
Example below of adding the site IDs to Toggle:
Step 4: Add Products (or use existing) to obtain a product ID
Follow these steps to add a new product (we'd recommend making a private product so it's not visible on your webshop).
The Oracle integration supports Physical and Digitally issued gift cards, and you have the option of having a different Product assigned to a digital vs physical gift card (if you want to separate the reporting, otherwise you can use the same product for both). If you would like 2 products, then you will need to create 2 products and obtain the product ID - which is located at the bottom of the page when viewing a product.
You will need these IDs for the configuration file:
Physical_Gift_Card_Product_Id
Digital_Gift_Card_Product_Id
Step 5: Get your Toggle account ID
Within Toggle;
Select your profile icon
Select Account Details
Account ID is at the bottom of the page
You will need this ID for the configuration file:
Account_Id
The Oracle EMC set up
If you need further support, please speak to your Toggle Customer success contact.
Step 1: Add service charges
Log in to Oracle EMC and select the Enterprise level.
Go to Configuration → Service Charges.
Add a record (e.g. “Toggle Gift Card Sale”). Configure it as an open / preset price service charge so the extension can set the amount at run time.
Repeat for the digital and reload service charges (or reuse one record for all three).
Note each Object Number and assign it to the matching field in the Toggle Variables JSON.
You will need the IDs for the configuration file:
Physical_Gift_Card_Service_Charge_Id
Digital_Gift_Card_Service_Charge_Id
Reload_Gift_Card_Service_Charge_Id
Each time a gift card is Sold (Physical / Digital), or topped up - the relevant service charge ID will be associated as the payment type in Oracle.
Step 2: Add Tender media & discount
In EMC, at Enterprise level, open Configuration → Tender/Media.
Add the redemption tender record (e.g. “Toggle Gift Card”). Note its Object Number → Redeem_Tender_Id.
Add the redemption discount record (e.g. “Toggle Gift Card Discount”). Note its Object Number → Redeem_Discount_Id.
A single tender/discount pair can be reused across flows, or multiple can be created depending on business rules.
You will need the IDs for the configuration file:
Redeem_Tender_Id
Redeem_Discount_Id
Step 3: Load the extension application
Go to the Setup tab and open Extension Application
Add (or edit) the extension application and upload ToggleExt.js as the extension content
Save and publish so the workstations pick up the new content
Step 4: Add the Configuration variables
After completing all the above steps, you should now have all the values needed to configure the configuration file. Populate the relevant fields with the values from the relevant steps.
{
"Toggle_User": "user name",
"Toggle_Pass": "user password",
"Account_Id": 1,
"Merchant_Id": 69,
"Toggle_Currency": "GBP",
"Physical_Gift_Card_Product_Id": 1,
"Digital_Gift_Card_Product_Id": 1,
"Physical_Gift_Card_Service_Charge_Id": 1,
"Digital_Gift_Card_Service_Charge_Id": 1,
"Reload_Gift_Card_Service_Charge_Id": 2,
"Redeem_Tender_Id": 1,
"Redeem_Discount_Id": 1,
"Epos_Reference_Field": "LocRef"
} Field | detail |
Toggle_User | Obtained in Toggle setup: Step 1 |
Toggle_Pass | Obtained in Toggle setup: Step 1 |
Account_Id | Obtained in Toggle setup: Step 5 |
Merchant_Id | Always 69 |
Toggle_Currency | Currency of Toggle account, i.e. GBP / USD / EUR / etc.. |
Physical_Gift_Card_Product_Id | Obtained in Toggle setup: Step 4 |
Digital_Gift_Card_Product_Id | Obtained in Toggle setup: Step 4 |
Physical_Gift_Card_Service_Charge_Id | Obtained in EMC setup: Step 1 |
Digital_Gift_Card_Service_Charge_Id | Obtained in EMC setup: Step 1 |
Reload_Gift_Card_Service_Charge_Id | Obtained in EMC setup: Step 1 |
Reload_Service_Charge_Price_Arg | Optional. Override preset for the reload price prompt. Supports {major} {minor} |
Redeem_Tender_Id | Obtained in EMC setup: Step 2 |
Redeem_Discount_Id | Obtained in EMC setup: Step 2 |
Epos_Reference_Field | IDs defined in Obtained in Toggle setup: Step 3 |
Add the Toggle Variables content
Ensure the names for the script match the below exactly;
Item | Value (exact) |
Content / application name | Toggle Variables |
Zoneable key | ToggleVariables |
Add a content record named Toggle Variables with key ToggleVariables.
Paste the completed JSON from Step 4 as the content text.
Step 5: Add the Operator buttons (Page design)
Go to Configuration → Page Design.
Locate and select the relevant page (e.g. the Transaction page). This opens the UI Designer.
Add a button for each action
Select the section where the button should sit and add a new button.
Set the button Name and Legend (label the cashier sees).
Set the button to run the extension function – one button per entry point:
Suggested legend | Function to call |
Gift Card Balance | giftCardBalance |
Redeem Gift Card | redeemGiftCard |
Reload Gift Card | reloadGiftCard |
Issue Physical Gift Card | issuePhysicalGiftCard |
Issue Digital Gift Card | issueDigitalGiftCard |
Set permissions/visibility as required, then Save.
Not all buttons are required, if you don't want to issue Digital cards (requires an email address to be captured) or allot Reloading (Topups) of cards - then don't add the buttons
Test the integration works
We recommend you:
Send yourself a free of charge digital voucher
Use the voucher code on the till to see if it works
Balance – press Gift Card Balance, scan/enter a known card, confirm the balance shows correctly.
Issue physical – issue a physical card for a small amount; confirm the sale posts as the physical service charge and the card is created in Toggle.
Issue digital – issue a digital card (with recipient email); confirm the sale posts and the digital card is created.
Reload – top up an existing card; confirm the reload service charge posts and the Toggle balance increases. If a second price dialog appears, set Reload_Service_Charge_Price_Arg.
Redeem – redeem against a card; confirm the payment and discount legs post and the Toggle balance decreases.
Reversal – void an issued service charge and cancel an order; confirm the Toggle transaction is reversed automatically.
🧠 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 so we can help troubleshoot it.