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": "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:

Name	Type	Description
cardHolder	requiredstring	First- and last name
pan	requiredstring	Credit card number
cvv	optionalstring?	Credit card CVV/CVC
expirationMonth	requiredstring	Credit card expiry month
expirationYear	requiredstring	Credit card expiry year