Note: Only Store Owner users can create the API on Step 2.
Note: This integration supports Order and Pay at Table (OAPT) or for click and collect only.
Summary
Add your site(s) to Toggle
Create an API on Toggle
Send the API details to Vita Mojo
Add Vita Mojo's store IDs to Toggle
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 > Vita Mojo
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 Vita Mojo and ask for your store IDs
You'll need to send the API username and password you created on Step 2 along with the info below to your Vita Mojo 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
Send the file to your Vita Mojo Account Manager asking them to configure your tills
Ask your Vita Mojo Account Manager for your store IDs
API endpoint: | |
Username: | (add the username you create here) |
Password: | (add the password you create here) |
Merchant ref: | 19 |
Account ID: | (find this on Account Details) |
Step 4: Add site IDs to Toggle
Whilst your Vita Mojo Account Manager does the relevant configuration using your API details, add the store IDs they sent your to Toggle.
Log in to Toggle
On the sidebar click Settings > Integrations > Vita Mojo
Paste in each ID to their respective site
Save
The site IDs allow the Vita Mojo 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 Vita Mojo 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 works during this stage.
If an error is flagged on the till, get in touch with Toggle and Vita Mojo so we can help troubleshoot it.
What does the integration do?
Toggle Gift Cards are accepted across Click & Collect, OPAT and Delivery channels. The integration will allow customers to:
Enter their Gift Card number
Pay for the entirety or part of their order with a Gift Card
See the balance that will remain on the Gift Card once the purchase is completed
Tender vs. Discount reporting
Gift card redemption screen
Gift card being used for click and collect
In addition to displaying the Gift Card charge in the Order Summary on the Payment page, it will also be displayed on the Order Confirmation Page and in the Order Confirmation Email.
Other screens
No balance left screen
Screen showing how much is available on a card
Tender vs Discount
If a card has been loaded with Discount (i.e. was not paid for by the customer), then Toggle will tell your POS at the point of redemption, which can be used to ensure the correct VAT is paid for Tender and Discount transactions.
Vita Mojo have implemented this through reporting. Any Toggle payments are still classed as a single payment type (regardless of tender vs discount split), however in a new report - the Order can be broken down to display the correct split (note, this doesn't break the split down at order item level).
This implementation means that in most areas the value split is going to be inaccurate - and if you will need to run the specific report(s) to identify the correct value split.