MySagePay
Login >

Upgrading from 2.23 to 3.00 - a brief overview

This document provides a brief overview of the basics involved in migrating from version 2.23 to 3.00. If you require more technical information then please refer to our Upgrade Guide 2.23

When upgrading your website to Sage Pay version 3.00 you will need to make changes to the payments information that is sent from your website to Sage Pay.

This information is sent via ‘fields’, and, as part of the upgrade process, it is these fields that need to be amended, removed or added.

Changes to the Fields

Below is a breakdown of all fields, mandatory and optional, that are sent for both versions 2.23 and 3.00.

For version 2.23 a number of optional fields can be added as part of the upgrade process. Please note that these fields are optional as this information does not need to be sent to Sage Pay.

In addition to the above changes, the four main fields that are sent with the transaction will remain the same.

  • VPSProtocol
  • TxType
  • Vendor
  • Crypt

In the Field ‘VPSProtocol’ – you must change the value from 2.23 to 3.00.

You also need to update the fields that are used to build the crypt.  The crypt includes all of the payment data that is sent with each transaction.

Those highlighted in red will need to be removed from your website, and those in green added and included in the crypt that is sent to Sage Pay with your transactions.

You can find out the specific requirements for each field by dowloading a copy of our Version 3.00 protocol and integration guide.

You can also download our guide for upgrading from 2.23 -3.00 - 

PDF document Download guide

Important – if your business is classed as Financial Institution (Merchant code – 6012) there are 4 additional fields that can be included with the transaction post from your system.

  • FIRecipientAcctNumber
  • FIRecipientSurname
  • FIRecipientPostcode
  • FIRecipientDoB

What else do I need to do?

Once the changes to the fields have been made, check that you are using AES encryption to build your crypt string.

You must also ensure that you decode the crypt string using the same method.

Any other encryption method will not allow you to send the payment data to us and will generate errors.

What happens next?

Once all the changes have been implemented, you will be able to take payments as normal without any disruption.

If you need more technical information

More detailed information on the changes required can be found in our technical guides. 

We’ve also developed integration kits for Java, PHP and .NET which your developer can use to complete the migration to version 3.00.