Provider guide

Barclaycard

Integration notes, required parameters, test details and example requests for integrating Barclaycard with the Revo PCI platform.

At a glance
1
Supported transaction type

Supported modes
SALE
!
Important
Barclaycard 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:
4330264936344675
Expiry Date:
0531
CVV:
123
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.
pspId
This is provided by Barclaycard.
userId
This is provided by Barclaycard.
password
This is provided by Barclaycard.
hashMethod
Barclaycard supports SHA1, SHA256, SHA512. Make sure this matches your account setting otherwise payments will fail.
hashSecret
This is provided by Barclaycard.
amount
Always has to be a whole number, for example £2 is 200.
currency
Must be provided as 3 letters for example: 'GBP'.
firstname
First name of the customer.
surname
Last name of the customer.
cardHolderName
Name as it appears on the card.
orderId
Unique identifier for this payment. We always recommend using a GUID / UUID for payment references, you can see an example here.

Optional parameters

comment
Information about the payment, anything can be put here.
ownerAddress
First line of address for the card owner.
ownerCity
City for the card owner.
ownerZip
Postcode for the card owner.

Barclaycard 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": "barclaycard",
            "mode": "test",
            "method": "payment",
            "parameters":
            {
            "transactionType": "SALE",
            "pspId": "",
            "userId": "",
            "password": "",
            "hashMethod": "SHA512",
            "hashSecret": "00000000-0000-0000-0000-000000000000",
            "amount": "200",
            "firstname": "test",
            "surname": "test",
            "cardHolderName": "test test",
            "orderId": "00000000-0000-0000-0000-000000000000",
            "currency": "GBP",

            "comment": "Paying for test",
            "ownerAddress": "123 Fake Street",
            "ownerCity": "Fakcity",
            "ownerZip": "SANTA1"
            }
            }'