Provider guide

Global Payments (XML)

Integration notes, required parameters, test details and example requests for integrating Global Payments (XML) with the Revo PCI platform.

Test integrationProvider support
At a glance
2
Supported transaction types
Supported modes
SALE, TOKEN
Key setup requirement
All payments must have a unique ID
!
Important
Global Payments 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:
5425230000004415
Expiry Date:
0531
CVV:
123

Global Payments have more test cards which can be found here.

Overview

Integration requirements

Required parameters

transactionType

'SALE' is supported which will take a payment from the requested card.

'TOKEN' is supported which is for tokenising the card details for use later.

merchantId
This is provided by Global Payments.
account
This is provided by Global Payments.
secret
This is provided by Global Payments.
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

Global Payments 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.

Transactions

Supported transaction types

Required

channel
How is the payment being processed, most of the time for PCI this will be set to 'MOTO'. However Global Payments also accept Ecommerce
amount
Always has to be a whole number, for example £2 is 200.
currency
Must be provided as 3 letters for example: 'GBP'.
autoSettle
Do you want the money to be taken straight away? If so put '1' otherwise, it will be authed and not taken if you put '0'

Required

cardRef
Unique identifier for this payment method.
payerRef
Unique identifier for this customer.
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": "globalpayments",
            "mode": "test",
            "method": "payment",
            "parameters":
            {
            "transactionType": "SALE" or "TOKEN",
            "merchantId": "",
            "account": "",
            "secret": "",
            "cardHolderName": "Test Test",
            "orderId", "00000000-0000-0000-0000-000000000000"

            //SALE
            "channel": "Test",
            "amount": "200",
            "currency": "GBP",
            "autoSettle": "1",
        
            //TOKEN
            "cardRef": "00000000-0000-0000-0000-000000000000",
            "payerRef": "00000000-0000-0000-0000-000000000000",
            "description": "This is a test payment",
            }
            }'