Provider guide

Opayo (Formally SagePay)

Integration notes, required parameters, test details and example requests for integrating Opayo (Formally SagePay) with the Revo PCI platform.

Test integration Provider support

At a glance

Supported transaction type

Supported modes

SALE

Important

Opayo require that all payments sent to them always have a unique id, if you try to make a payment with the same orderId it will get rejected.

Testing

Test card details

Card Number:

4929000000006

Expiry Date:

0531

CVV:

123

Opayo have more test cards which can be found here.

Overview

Integration requirements

Required parameters

transactionType

Currently only 'SALE' is supported which will take a payment from the requested card, more options can be added on request.

vendorName

This is provided by Opayo.

integrationKey

This is provided by Opayo.

integrationPassword

This is provided by Opayo.

amount

Always has to be a whole number, for example £2 is 200.

currency

Must be provided as 3 letters for example: 'GBP'.

cardHolderName

Name as it appears on the card.

firstname

First name of the customer.

lastName

Last name of the customer.

billingAddress1

First line of address for the card owner.

billingCity

City for the card owner.

billingPostalCode

Postcode for the card owner.

billingCountryCode

The country code of the customer, for example: 'GB'.

orderId

Unique identifier for this payment. We always recommend using a GUID / UUID for payment references, you can see an example here.

description

Description for this payment.

Optional parameters

Opayo may support other parameters not currently integrated into the PCI platform, more information can be found here, if you would like any integrated please contact us.

Reference

Example request

cURL exampleAPI request

curl --location 'https://api.revopci.co.uk/' \
            --header 'X-Session;' \
            --header 'X-Auth;' \
            --header 'Content-Type: application/json' \
            --data '{
            "provider": "opayo",
            "mode": "test",
            "method": "payment",
            "parameters":
            {
            "transactionType": "SALE",
            "vendorName": "",
            "integrationKey": "",
            "integrationPassword": "",
            "amount": "200",
            "currency": "GBP",
            "cardHolderName": "Test Test",
            "firstName": "Test",
            "lastName": "Test",
            "billingAddress1": "123 Test Street",
            "billingCity": "Test",
            "billingPostalCode": "SANTA1",
            "billingCountryCode": "GB",
            "orderId": "00000000-0000-0000-0000-000000000000",
            "description": "This is a test payment",
            }
            }'