You are here

Form integration documents

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

Step 1 – Integrate Sage Pay with your ecommerce site

Protocol documents

Please begin by following the instructions outlined in the protocol documents below.
PDF documentForm integration protocol and guidelines

 
Integration kits
These are web application examples that demonstrate the usage of the protocol documents listed above.
Zip file.java
 
Zip file.net
 

Customise your checkout pages (optional)

These templates are useful if you wish to customise the look and feel of your checkout pages​.

Download our official logos and graphics

Download the Sage Pay 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 instead 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 Sage Pay, 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.