Sage Pay

Sana Commerce 9.3
Your connector

Configure Sage Pay in Sana Admin

Once the Sage Pay payment provider is installed and configured in the My Sage Pay portal, it should be also configured in Sana Admin.

Set up the Sage Pay payment provider in Sana Admin

Step 1: In Sana Admin click: Apps > Add-ons. When the Sage Pay add-on is installed, you can configure it from any tab on the "Add-ons" page by clicking on the Configure button .

Step 2: Choose the appropriate payment integration mode.

There are two modes: test and live. Test mode allows to simulate the payment process as if it is a real payment and helps to make sure that everything will behave the same way when you go live. Live mode implies that a customer makes a real purchase using already configured payment provider and methods.

Step 3: Configure the payment provider by entering the payment provider specific settings of the test/ live account.

The table below provides the description of the Sage Pay payment provider settings.

Field Description
Vendor Enter the vendor name which was given by Sage Pay during registration.
Encryption password Enter the encryption password which was given by Sage Pay during registration.

      To find the encryption password, in the My Sage Pay portal click: Settings > Administrator. In the Password details section, see the value of the field Form Integration Encryption Password.

Vendor email Enter the vendor's e-mail address. Use the ":" (colon) character as a separator to add multiple e-mail addresses.
Example: my@email1.com:my@email2.com
Send emails Use this field to send payment confirmation e-mails.

Possible values:

  • No: Do not send a confirmation e-mail to the customers and vendor.
  • CustomerVendor: Send a confirmation e-mail to the customers and vendor.
  • Vendor: Send a confirmation e-mail only to vendor and not to the customers.
Country code map

In different ERP systems, countries can be stored with ISO codes in different formats, for example ISO 3166-1 alpha-2 or alpha-3. Sage Pay only supports ISO 3166-1 alpha-2 codes of the countries.

Check in your ERP system whether the ISO 3166-1 alpha-2 or alpha-3 country codes are used. 

Use this field to map ISO country codes from you ERP system to ISO 3166-1 alpha-2 codes of the countries supported by Sage Pay. The country codes must be entered in the following format: {ERP country code}|{ISO 3166-1 alpha-2 code}. Multiple country codes must be separated with ";".

Example: GBR|GB;USA|US

Replace unsupported characters Use this option to replace special characters that are not allowed in payment transactions when sending from Sana to Sage Pay. If payment transaction data, for example customer name or address, contains some special characters that are not allowed by Sage Pay, the payment transaction can fail.

See Sage Pay Server Integration and Protocol Guidelines for the list of allowed characters used in various payment transaction data.

To avoid payment transaction problems due to unsupported characters, enable the option Replace unsupported characters and enter the Replacement character. The replacement character is a character which is allowed by Sage Pay in payment transactions. It is used to replace unsupported characters, if there are any in payment transactions when sending from Sana to Sage Pay.

If you leave the field Replacement character blank, the space character will be used by default.

You can enter only one allowed character in the field Replacement character. Do not use a character that is not allowed by Sage Pay as a replacement character.

Replacement character

When Sage Pay is installed and configured, you can set up the payment methods in Sana Admin that are supported by Sage Pay.