Configure Opayo Payment Methods

When the Opayo payment provider is configured in Sana Admin, you need to set up the payment methods supported by Opayo.

Step 1: In Sana Admin click: Setup > Ordering > Payment.

Step 2: On the Payment tab, create and configure the payment methods.

For more information about how to create and configure payment methods in Sana Admin, see Online Payment Methods.

Field

Description

Payment provider

Select SagePay. Opayo was formerly called SagePay.

Vendor

Enter the vendor name which was given by Opayo during registration.

You can use one vendor account for all payment transactions or different accounts for different payment methods.

If you use one vendor account, leave this field empty. In this case the vendor account must be specified in the Opayo add-on settings, but not in the payment method settings.

Encryption password

Enter the encryption password which was given by Opayo during registration.

If you enter the encryption password for the payment method, it will override the one in the Opayo add-on settings.

NOTE

To find the encryption password, in the MySagePay 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

You can use one vendor account for all payment transactions or different accounts for different payment methods.

If you use one vendor account, leave this field empty. In this case the vendor account must be specified in the Opayo add-on settings, but not in the payment method settings.

Apply 3D Secure

Use this field to set up 3D Secure checks and rules defined at a transaction level in the MySagePay portal.

The final payment status will be set based on these validations. For example, if customers pay for the order with the 3D security enabled card, they will be forwarded to the extra validation page to enter the password. The payment will fail, if the customer does not enter the password or enter the wrong password.

Possible values:

  • PerformCheck&ApplyRules: If 3D Secure checking is enabled and rules are set in the MySagePay portal, the checks will be performed and authorization rules will be applied.

  • ForcePerformCheck&ApplyRules: Force 3D Secure checks for a transaction, if possible, and apply rules for authorization.

  • ForcePerformCheck&GetAuth: Force 3D Secure checks for a transaction, if possible, but ALWAYS obtain an authorization code, irrespective of the configured rules.

This setting is not applicable to the PayPal transactions.

Apply AVS/CV2

Use this field to set up AVS / CV2 checks and rules defined at a transaction level in the MySagePay portal. The final payment status will be set based on these rules. For more information, see Sage Pay Fraud Prevention Guide. 

Possible values:

  • PerformCheck&ApplyRules: If AVS / CV2 checking is enabled and rules are set in the MySagePay portal, the checks will be performed and rules will be applied.

  • ForcePerformCheck&ApplyRules: Force AVS / CV2 checking, even if it is not enabled for the Opayo account. Apply AVS / CV2 rules.

  • NoPerformCheck: Do not perform AVS / CV2 checking, even if it is enabled for the Opayo account.

  • ForcePerformCheck: Force AVS / CV2 checking, even if it is disabled for the Opayo account, but DON'T apply any rules.

This setting is not applicable to the PayPal transactions.

Transaction type

Set up a transaction type that you want to process through your Opayo account.

In most cases this will be PAYMENT. This is the default transaction type.

Possible values:

  • PAYMENT: Payment transaction is processed real time and the payment status is updated accordingly.

  • DEFERRED: Once payment is successful, the Sana payment status will be set to Paid and the payment amount will be hold on the user's card. A merchant has to release the money within 6 days.

  • AUTHENTICATE: Once payment is successful, the Sana payment status will be set to Paid. A merchant has to authenticate the transaction within 90 days.

Amount round option

Use this option to determine decimal place for the payment amount which is sent to Opayo.

Possible values:

  • No: The payment amount is sent as it is. This is the default value.

  • Up: If this option is set, the payment amount will be round up to 2 decimal places.

  • Down: If this option is set, the payment amount will be round down to 2 decimal places.

NOTE

Opayo supports payment amounts which are accurate to 2 decimal places, for example 35.50. Therefore, if payment amounts have more than 2 decimal places, it is required to round of amounts to 2 decimal places, otherwise they will be rejected by Opayo.

Trim values if lengthy

If you enable this option, the following field values will be trimmed to the maximum allowed character length.

  • BillingAddress1 (max. characters 100)

  • BillingAddress2 (max. characters 100)

  • BillingCity (max. characters 40)

  • DeliveryAddress1 (max. characters 100)

  • DeliveryAddress2 (max. characters 100)

  • DeliveryCity (max. characters 4)

  • Description (max. characters 100)

  • BillingFirstnames (max. characters 20)

  • BillingSurname (max. characters 20)

  • DeliveryFirstnames (max. characters 20)

  • DeliverySurname (max. characters 20)

  • CustomerName (max. characters 100)

Countries to skip postcode validation

Enter the ISO codes of those countries for which validation of the billing and shipping postcodes should be disabled. Multiple country ISO codes should be separated with a ";".
Postcode validation is disabled for Ireland (IE) by default.

Example: GB;PL;LK

 

NOTE

To perform a successful transaction via Opayo, the following data is required:

  • Amount, Currency, Billing surname, Billing first name, Billing address, Billing city, Billing postcode, Billing country, Delivery surname, Delivery first name, Delivery address, Delivery city, Delivery postcode and Delivery country.

  • Billing state is required when Billing country is set to US.

  • Delivery state is required when Delivery country is set to US.

  • Delivery postcode and Billing postcode are not required for countries that do not have postcodes, for example Ireland.

 

NOTE

Refunds, voids and repeats should be handled in the MySagePay portal.

Test the payment flow, to see if everything works fine using the created payment methods.

NOTE

Use the valid and existing address to test a payment transaction via Opayo, otherwise Opayo will not accept the test transaction.

For more information about how Opayo integrates with other services, see the official Sage Pay Form Integration and Protocol Guidelines document. There you will find the fields which are passed back and forth between a web store and Opayo, their format, size, accepted values and characters.