Card verification request Step 2
{{url}}/ecom/execute_request/payments/v1/execute/verification
Input parameters:
operationId
Operation ID received in step 1
string
Yes
1697008393082nW0c1jr6KVv
encryptedCardData
Card expiration date and CVV2 encrypted in JWE. First 4 characters are ExpDate, next 3 characters are CVV
string
Yes
2503111 (decrypted format, in YYMMCVV format)
date
Date and time of the payment
string
Yes
{{currentdateT}}.00+00:00
browserInfo
Object containing browser data
object
Yes, if the operation requires 3DS
browserAcceptHeader
HTTP request header
string
Yes, if the operation requires 3DS
text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9
browserUserAgent
Browser user agent string indicating the system being used
string
Yes, if the operation requires 3DS
Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like,Gecko)Chrome/87.0.4280.66 Safari/537.36
browserLanguage
Browser language
string
Yes, if the operation requires 3DS
en-US,en
browserColorDepth
Color depth value of the browser screen
string
Yes, if the operation requires 3DS
24
browserScreenHeight
Height of the browser window's viewport
string
Yes, if the operation requires 3DS
800
browserScreenWidth
Width of the browser window's viewport
string
Yes, if the operation requires 3DS
1280
browserTZ
Browser timezone
string
Yes, if the operation requires 3DS
-180
Output parameters:
type
Transaction type
string
Purchase
rrn
RRN number of the transaction in MPS
string
2554256963
purpose
Payment purpose
string
For goods
comment
Comment
string
Test
coinAmount
Payment amount
int
2000
merchantId
Merchant ID
string
137d9304-0368-11ed-b939-0242ac120002
operationId
Transaction ID
string
1712844596346b9F-WwrWZpq
ecomOperationId
Transaction ID in the Ecom system
string
8c3303e9-7396-43b8-af4e-31d9facdde9b
merchantName
Merchant name
string
KB test terminal
approvalCode
Authorization code
string
39203
status
Transaction status
string
SUCCESS FAIL PENDING REQUIRED_3DS DESIRED_THREEDS_MODE_ERROR
transactionType
Transaction type in numeric value
string
35
merchantRequestId
Merchant request ID
string
72837906-f526-4aef-8d11-58d80b44cb75
transactionCurrency
Payment currency
string
980
merchantCommission
Commission amount
string
2
creationDateTime
Payment creation date
string
2024.09.19 15:29:25.675
modificationDateTime
Payment modification date
string
2024.09.19 15:29:25.675
actionCode
Response code
string
0
responseCode
Response details
string
0
description
Response description
string
Approved
bankCode
Issuer bank name
string
BANK_ALLIANCE
paymentSystem
Issuer MPS name
string
MasterCard
productType
Terminal product type
string
PURCHASE
notificationUrl
URL to which the callback was sent
string
paymentServiceType
Payment type
string
CARD/APPLE_PAY/GOOGLE_PAY
notificationEncryption
Indicates whether callback data is encrypted
string
true/false If the parameter is not passed or false, the callback data will not be encrypted
cardNumberMask
Masked card number
string
5573********0304
desiredThreeDSMode
Indicates whether the merchant desires to use 3DS in the purchase
string
MUST/SHOULD/MUST_NOT
threeDSMode
Indicates whether 3DS was used in the purchase
string
MUST - payment with 3DS MUST_NOT - payment without 3DS
statusThreeDs
3DS transaction status
string
Y - successful 3DS N - unsuccessful 3DS
threeDSServerTransId
Transaction ID in the 3DS system
string
b6c35fdb-28c1-454d-a2f3-51098c26bda4
acsTransId
Transaction ID in the ACS system
string
3e17fabb-71e6-498e-8794-ef8c95c5ba6f
dsTransId
Transaction ID generated by the Directory Server
string
12ebc556-82d3-4e35-9fb8-77ac18b050ea
eci
Electronic Commerce Indicator code indicating the security level of the transaction
string
02
processingMerchantId
Merchant ID in the processing center
string
AE100000
processingTerminalId
Terminal ID in the processing center
string
AE100000
redirect3dsUrl
URL to redirect the client to the issuer's page for 3DS authentication
string
txnType
Transaction subtype
enum
Possible values: NONCVV/noncvv - CVV input and verification are not performed
senderCustomerId
Sender's customer ID
string
1258728c1
senderFirstName
Sender's first name
string
Ivanenko
senderLastName
Sender's last name
string
Ivan
senderMiddleName
Sender's middle name
string
Ivanovich
senderEmail
Sender's email
string
mail@gmail.com
senderCountry
Sender's country
string
Ukraine
senderRegion
Sender's region
string
Kyiv
senderCity
Sender's city
string
Kyiv
senderStreet
Sender's street
string
Sichovykh Striltsiv
senderAdditionalAddress
Additional sender address details (floor, house number, apartment)
string
23
senderItn
Sender's tax identification number
string
123456789
senderPassport
Sender's passport
string
AN123456
senderIp
Sender's IP address
string
123.12.12.12
senderPhone
Sender's phone number
string
380630000000
senderBirthday
Sender's date of birth
string
31.12.2000
senderGender
Sender's gender
string
M
senderZipCode
Sender's postal code
string
12000
senderBankCode
Sender's issuer bank name
string
BANK_ALLIANCE
senderPaymentSystem
Sender's issuer MPS name
string
MasterCard
senderCardNumberMask
Sender's masked card number
string
5573********0304
externalCardToken
Token ID
string
tmkEYenZSa8FV03aawVXxbep
An example of a request body
Example of response body without 3DS
Example response body from 3DS
Last updated