Skip to main content

Transaction with card request

We are improving our documentation

We're currently working on improving this page to provide you with the best possible experience. Please bear with us while we make some changes.

Thank you for your patience!

Basic scheme

The examples show the basic data most connector requires. Depending on the connector type more data could be necessary. Please refer to the Connector Types documentation for concrete requirements.

To see all available fields please refer to our regular Transaction API.

For some languages we already provide a ready-to-use client implementation on GitHub.

{
"cardData": {
"cardHolder": "Alex Smith",
"pan": "4111111111111111",
"cvv": "123",
"expirationMonth": "11",
"expirationYear": "2028"
},
"merchantTransactionId": "your-unique-identifier",
"customer": {
"identification": "616c6578-2e73-6d69-7468-406578616d70",
"billingCountry": "US",
"email": "[email protected]",
"ipAddress": "198.51.100.123"
},
"amount": "9.99",
"currency": "EUR",
"description": "Purchase description shown on credit card statement.",
"successUrl": "https://shop.example.org/checkout/success",
"cancelUrl": "https://shop.example.org/checkout/cancelled",
"errorUrl": "https://shop.example.org/checkout/error",
"callbackUrl": "https://api.example.org/callback",
"withRegister": false
}

cardData

The main difference between the regular Transaction API and the Direct PCI API is additional cardData element which has the following fields:

NameTypeRequiredDescription
cardHolderstringtrueFirst- and last name
panstringtrueCredit card number
cvvstringfalseCredit card CVV/CVC
expirationMonthstringtrueCredit card expiry month
expirationYearstringtrueCredit card expiry year