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": "5",
"expirationYear": "2029"
},
"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:

NameTypeDescription
cardHolderrequiredstringFirst- and last name
panrequiredstringCredit card number
cvvoptionalstring?Credit card CVV/CVC
expirationMonthrequiredstringCredit card expiry month
expirationYearrequiredstringCredit card expiry year