1. Create a Toggle user in Trust Payments
Trust Payments requires outside systems to connect to it with a username/password. So the first thing you need to do is create a username/password.
1 - Log in to your Trust Payments account (MyST) and head to the Users page.
2 - Now click Add user at the bottom of the screen to add a new user.
3 - Add some details for the user. These can be anything you want and you can use your own email address or another nominated one at your business.
4 - Take a note of the username/password - you’ll need these to enter into Toggle.
5 - For the Role, set this to Webservices
6 - For the Valid IP / networks(s), enter this IP address range:
0.0.0.0/0
(this allows any of Toggle's IPs - make sure you enter this exactly as above)
7 - Finally, assign the Trust Payments site reference that you want to use for Toggle in the Allocated sites section.
If you only have one site reference in Trust Payments, you will only see one option to choose from. Take a note of the site reference, as you’ll also need this in Toggle.
8 - You can leave all other settings as default. Click Save to create the user.
9 - Once you've created the user, email Trust Payments support and request that your new username be linked to Toggle and let them know your web shop domain.
To do this, provide them the username you created plus our username, which is: wsjwt@airship.co.uk and a request that your site be allocated to our JWT user.
Also ask them to ensure your site reference is switched over to use SCAv2 and let them know your Toggle shop domain, which they will need for their 'Merchant URL' setting.
Here's a template email to use:
Dear Trust Payments support,
Please could you complete the following set-up actions to allow payments to be taken on our Toggle web shop:
- Please allocate webservices user [your-username-here] to the JWT user wsjwt@airship.co.uk
- Please switch our site reference to use SCAv2 if it isn't already
- Please set the Merchant URL to our domain which is [your-shop-domain-here]
10 - Once they have confirmed this is done, you can proceed to the next step.
2. Configure Toggle to use Trust Payments
The next step is to enter the username/password and site reference from Trust Payments in Toggle.
Log in to Toggle
From the sidebar, click on Settings > Payment Settings
Click the blue button saying "Connect with Trust Payments"
In the popup window, enter the username/password and site reference from Trust Payments.
Click Submit.
The button will turn green to show the details have been saved.
Important: note that Toggle does not "test" the credentials at this point to ensure they have been entered correctly and are working, so if you find you are having problems taking payments, do double check this step.
Do a live test
To check all is working OK, we recommend doing a live test.
Head to your Toggle shop and checkout with a purchase. Did it all go through OK? If so, you’re all set.
Troubleshooting
If you get errors when testing your checkout and purchase journey, firstly double check that you have followed all of the steps above.
Did you add the relevant IP address in Trust Payments?
Is the username/password definitely saved correctly in Toggle?
Note that if you're testing your payment page in Toggle and a very brief "Card declined" message is shown before the card payment fields refresh and show blank again like this...
... then it is often an indication that Toggle can't connect to Trust Payments. You will need to ensure each step has been followed in the set-up process, and that information has been transposed correctly. Trust Payments support team may question the sequence of API calls that Toggle makes, mentioning the ACCOUNTCHECK and THREEDQUERY calls that are made. However, this is usually not related, and the problem most commonly is a misconfiguration during set-up.
Also note that we observe that most Trust Payment usernames are email addresses, so if your username is something other than an email address, check the correct username has been copied into Toggle.
If you’ve done all these things and are still having problems, drop us a message at success@usetoggle.com and we will help out.
Dealing with payment/settle statuses in Trust Payments
Note that Toggle will issue an order on a successful authorisation in Trust Payments.
In cases where a payment authorisation has been flagged as 'suspended' or 'declined', no order will be created.
Here is what a suspended payment looks like in Trust Payments:
Here is what a declined payment looks like in Trust Payments:
And here is what a successful payment looks like in Trust Payments:
Also, a successful authorisation may take a few days to settle. Payments pending settlement will show as "OK" like above, but have this showing until they are settled:
Here is what this looks like once a payment has settled:
Further reading
Any help or questions please get in touch on success@usetoggle.com