Request for checking card enrollment in 3-D Secure (verifyEnrollment.do)

The request used for verifying card enrollment in 3-D Secure is verifyEnrollment.do.

In this document, the following data type conventions are used when describing request and response parameters:

  • A<n> – a sequence of Latin letters of length <n>;
  • A..<n> – a sequence of Latin letters with a length not exceeding <n>;
  • N<n> – a sequence of digits of length <n>;
  • N..<n> – a sequence of digits with a length not exceeding <n>;
  • AN<n> – a sequence of Latin letters and numbers of fixed length <n>;
  • AN.. <n> – a sequence of Latin letters and numbers with a length not exceeding <n>;
  • ANS<n> – a sequence of Latin letters, numbers and characters of fixed length <n>
  • ANS.. <n> – a sequence of Latin letters, numbers and characters with a length not exceeding <n>;
  • UTC – date and time, in this case: the date must be passed without specifying the time zone, Moscow time, for the SOAP protocol, the standard encoding xs: dateTime is used.

Request parameters

The request parameters are given in table below.

Name Type Mandatory Description

userName

AN..30

Yes

Login of the service account of the merchant.

password

AN..30

Yes

Merchant's service account password.

pan

N12…19

Yes

Masked number of the card that has been used for the payment. This parameter is to be specified only after the order has been paid.

In the case of payment via Apple Pay, DPAN is used as the card number: a number associated with the buyer's mobile device and acting as a payment card number in the Apple Pay system.

Response parameters

The response parameters are given in table below.

Name Type Mandatory Description

errorCode

N3 No

Error code. Can be missing if the result has not caused an error.

errorMessage

AN..512

No

Error description in the language passed in the language parameter in the request.

isEnrolled

A1

No

Sign of the card's enrollment in 3-D Secure. The possible values are:

  • Y – Yes;
  • N – No;
  • U – unknown.

emitterName

AN..160

No

Name of the issuing bank.

emitterCountryCode

AN..4

No

Country codes of the issuing bank.

Error codes

Error code Error text
0

The request has been processed without system errors.

1

The card number is not specified.

1

The card number must be a number containing 13 to 19 digits.

5

The user must change the password.

5

Access denied.

6

Information is not found for the card number specified.

7

System error.

Examples

POST request example

pan=4111111111111111

Response example

{"errorCode":"0","errorMessage":"Success","emitterName":"TEST CARD","emitterCountryCode":"RU","enrolled":"Y"}