Login >

Direct integrations, protocols and documents

Direct integrations, protocols and documents

Here's everything you will need to integrate our payment solution using the Direct integration option.  If you have any question, don't hesitate to get in touch.  We're here to help 24/7.

Step 1 – Integrate Opayo with your ecommerce site

Protocol documents

Please begin by following the instructions outlined in the protocol documents below.
PDF documentDirect integration protocol

Single-click purchases (optional)

Give shoppers the option to store their card details (as a token) on our payment system so that they don't have to re-enter them during their next purchase. Ideal for businesses that have a lot of repeat customers. See pricing
PDF documentToken System Integration and Protocol Guidelines

Download our official logos and graphics

Download the Opayo logo and payment type graphics for your checkout pages.  Including logos at the bottom of checkout pages will give your website more credibility.
Find a logo

Customised reporting & admin API (optional)

This API allows your back-office systems to interact with our payment gateway iinstead of using our own reporting & admin portal called MySagePay.​
PDF documentCustomised reporting & admin API

Step 2 – Test your integration

Upon completion of the integration, you will need to test it by attempting to process a transaction and refund through our test server.  An online guide is available to walk you through each step of the process.
Testing your integration

Error codes?

If you're struggling with an error code or message, try searching for it on our website.
Search for an error code

Step 3 – You're all set

Once you've processed a successful test transaction and refund, a trigger will be generated automatically to notify us that the account should now be switched from test to LIVE.  Shortly after, the vendor will receive an email confirming that the account has been switched. 

If the merchant account(s) on the account were already verified by Opayo, the vendor will be able to process LIVE transactions immediately.

Otherwise, feel free to get in touch with our 24/7 customer support team to check the status of an account.