All Collections
Integrations, API & POS Mode
Ordering
How to connect Vita Mojo with Toggle
How to connect Vita Mojo with Toggle
Georgina Doyle avatar
Written by Georgina Doyle
Updated over a week ago

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

  1. Add your site(s) to Toggle

  2. Create an API on Toggle

  3. Send the API details to Vita Mojo

  4. Add Vita Mojo's store 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 > Vita Mojo

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

  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 Vita Mojo Account Manager asking them to configure your tills

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

  1. Log in to Toggle

  2. On the sidebar click Settings > Integrations > Vita Mojo

  3. Paste in each ID to their respective site

  4. 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:

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


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

Did this answer your question?