Conventions
  • Data, except where it stated differently, represented in form of hex string where each character stands for half-byte (nibble). For example to code 8 bytes of data 16 hex characters used
  • Keys coded similar way and can be of Single (64 bits, 8 bytes or 16 hex characters), Double (128 bits) or Triple (192 bits) length

des/encrypt
DescriptionEncrypts data block with DES (3DES) depending on key length (ECB mode)
URLhttp://paymentcardtools.com:8081/service/des/encrypt
MethodPOST
Parametersdata - 8, 16 or 32 bytes of data
key - Single, Double or Triple length key
Return valueReturns encrypted data block in result node
ExampleRequest
{ "data": "0123456789ABCDEF", "key": "FDFDFDFDFDFDFDFD" }
Response
{ "result": "FEBEED623F5A68C5" }
des/decrypt
DescriptionDecrypts data block with DES (3DES) depending on key length (ECB mode)
URLhttp://paymentcardtools.com:8081/service/des/decrypt
MethodPOST
Parametersdata - 8, 16 or 32 bytes of data
key - Single, Double or Triple length key
Return valueReturns decrypted data block in result node
ExampleRequest
{ "data": "FEBEED623F5A68C5", "key": "FDFDFDFDFDFDFDFD" }
Response
{ "result": "0123456789ABCDEF" }
bitwise/and
DescriptionBitwise AND operation on data blocks
URLhttp://paymentcardtools.com:8081/service/bitwise/and
MethodPOST
Parametersa - 8, 16, or 32 bytes of data block A
b - data block B the same length as data block A
Return valueReturns resulted data block in result node
ExampleRequest
{ "a": "0123456789ABCDEF", "b": "F0F0F0F0F0F0F0F0" }
Response
{ "result": "0020406080A0C0E0" }
bitwise/or
DescriptionBitwise OR operation on data blocks
URLhttp://paymentcardtools.com:8081/service/bitwise/or
MethodPOST
Parametersa - 8, 16, or 32 bytes of data block A
b - data block B the same length as data block A
Return valueReturns resulted data block in result node
ExampleRequest
{ "data": "0123456789ABCDEF", "key": "FEDCBA9876543210" }
Response
{ "result": "FFFFFFFFFFFFFFFF" }
bitwise/xor
DescriptionBitwise XOR operation on data blocks
URLhttp://paymentcardtools.com:8081/service/bitwise/xor
MethodPOST
Parametersa - 8, 16, or 32 bytes of data block A
b - data block B the same length as data block A
Return valueReturns resulted data block in result node
ExampleRequest
{ "data": "0123456789ABCDEF", "key": "FDFDFDFDFDFDFDFD" }
Response
{ "result": "FCDEB89A74563012" }
pinblock/format0
DescriptionCalculates PIN Block of ISO-9564 Format 0
URLhttp://paymentcardtools.com:8081/service/pinblock/format0
MethodPOST
Parameterspan - 16 digit card number (Primary Account Number)
pin - 4 digit PIN value
Return valueReturns PIN Block in result node
ExampleRequest
{ "pan": "4123456789012349", "pin": "1234" }
Response
{ "result": "041200A9876FEDCB" }
pinblock/format1
DescriptionCalculates PIN Block of ISO-9564 Format 1
URLhttp://paymentcardtools.com:8081/service/pinblock/format1
MethodPOST
Parameterspin - 4 digit PIN value
Return valueReturns PIN Block in result node
ExampleRequest
{ "pin": "1234" }
Response
{ "result": "141234FFFFFFFFFF" }
luhn/check
DescriptionLUHN check digit validation
URLhttp://paymentcardtools.com:8081/service/luhn/check
MethodPOST
Parameterspan - 16 digit card number
Return valueReturns boolean value in valid node
ExampleRequest
{ "pan": "4123456789012349" }
Response
{ "valid": true }
luhn/calculate
DescriptionLUHN check digit calculation
URLhttp://paymentcardtools.com:8081/service/luhn/calculation
MethodPOST
Parameterspan - PAN value without check digit
Return valueReturns claculated check digit in result node
ExampleRequest
{ "pan": "412345678901234" }
Response
{ "result": "9" }
pvv
DescriptionVISA PVV (PIN Verification Value) calculator
URLhttp://paymentcardtools.com:8081/service/pvv
MethodPOST
Parameterspan - 16 digit card number
pin - 4 digit PIN value
pvki - PIN Verification Key Index - value from 0 to 6
pvk - PIN Verification Key - Single, Double of Triple length key value
Return valueReturns PIN Block in result node
ExampleRequest
{
"pan": "4123456789012349",
"pin": "1234",
"pvki": "1",
"pvk": "FDFDFDFDFDFDFDFDABABABABABABABAB"
}
Response
{ "result": "7189" }
cvv
DescriptionCVV (CVC) calculator
URLhttp://paymentcardtools.com:8081/service/cvv
MethodPOST
Parameterspan - 16 digit card number
expdate - 4 digit card expiration date
servicecode - 3 digit card service code
cvka - Card Verification Key - Single length key A component
cvkb - Card Verification Key - Single length key B component
Return valueReturns PIN Block in result node
ExampleRequest
{
"pan": "4123456789012349",
"expdate": "1212",
"servicecode": "101",
"cvka": "FDFDFDFDFDFDFDFD",
"cvkb": "ABABABABABABABAB"
}
Response
{ "result": "741" }