Provider guide

First Data

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

Test integration Provider support

At a glance

Supported transaction type

Supported modes

SALE

Important

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

Testing

Test card details

Card Number:

4035874000424977

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.

storeId

This is provided by First Data.

authPassword

This is provided by First Data.

certificateBase64

This is provided by First Data.

certificatePassword

This is provided by First Data.

amount

Always has to be a decimal number, for example £2 is 2.00

Optional parameters

firstname

First name of the customer.

lastname

Last name of the customer.

address1

First line of address for the card owner.

address2

Second line of address for the card owner.

city

City for the card owner.

zip

Postcode for the card owner.

invoiceNumber

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

First Data may support other parameters not currently integrated into the PCI platform, if you would like more information 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": "firstdata",
            "mode": "test",
            "method": "payment",
            "parameters":
            {
            "transactionType": "SALE",
            "storeId": "",
            "authPassword": "",
            "certificateBase64": "",
            "certificatePassword": "",
            "amount": "200",

            "firstName": "Test",
            "lastname": "Test",
            "address1": "123 Test Street",
            "address2": "",
            "city": "Test",
            "zip": "SANTA1",
            "invoiceNumber": "00000000-0000-0000-0000-000000000000",
            }
            }'