How to connect FreedomPay with Toggle

In order for ApplePay to work, your shop needs to be on its own sub domain (rather than using the default mytoggle.io). You can follow these steps to get your webshop added to your own domain.

From FreedomPay you will need to ask them to configure the Toggle integration and obtain;

These can be generated from within your FreedomPay enterprise platform, by going to Administration > Enhanced Security Keys > Create New

Add a description, then select the Freeway Payments tab

Select all the share groups and stores you want to link the key to, then confirm.

You web shop domain (i.e. https://joinerskitchen.mytoggle.io) will need adding to FreedomPays CORs policy, this allows payments from your web shop to be accepted by FreedomPay. This will need to be the sub domain created in point 1 and should not be the default {Shopname}.mytoggle.io, if you are unsure of this - reach out to Toggle support.

You will need to request the CORs whitelist through your FreedomPay support channel. We'd suggest you request this at the same time as point 2.

You will be prompted to add your Store ID, Terminal ID and ESKey obtained from point 1

Once added, the details are validated against FreedomPay. If any of the details don't match, you'll be shown the following error - in which case restart the setup steps.

Once all complete, your Toggle Payment Setting's page will show up in green saying 'Connected with FreedomPay'.

If you are wanting to use ApplePay, there is an additional step required by Toggle and FreedomPay.

Once you have configured the gateway within Toggle, FreedomPay will need to run a massenablement with ApplePay. This can only be run AFTER the gateway is configured within Toggle.

The URL provided to FreedomPay should be the shop domain (as provided in point 2) appended with the /.well-known/apple-developer-merchantid-domain-association

I.e. https://joinerskitchen.mytoggle.io/.well-known/apple-developer-merchantid-domain-association

reCAPTCHA is required to be configured for the FreedomPay integration. You can follow our guide here. This can be set as 'invisible', or an increased level of validation if desired.

Once configured, you will see a reCAPTCHA logo in the bottom corner as you go through the payment journey

We recommend you goto your Toggle shop, and make a purchase purchase through at this point to validate the end to end process. You should check the payment details have successfully gone into your FreedomPay portal also

When the payment is complete, go into Toggle and find the order. You can take the 'Merchant transaction reference' from the order and search for it in the FreedomPay > Transactions table