3D Secure Version and Directory Server Transaction ID API Fields
000003405
866
12/18/2025 18:47 PM
1.0
Body
With 3DS 2.x Identity Check transactions, MasterCard requires that you include additional fields: 3D Secure version and Directory server transaction ID in authorization requests.
| Field Name | Description | Example |
|---|---|---|
| 3D Secure version | Version of 3D Secure that was used to process the Mastercard Identity Check transaction. | 1.0.2 or 2.0.0 |
| Directory server transaction ID | Transaction ID generated by the Mastercard directory server during authentication. | f38e6948-5388-41a6-bca4-b49723c19437 |
SCMP API
| Field Name | Request Field for the Authorization Service | Payer Authentication Reply Field (get value from here) |
|---|---|---|
| 3D Secure version | pa_specification_version | pa_enroll_specification_version or pa_validate_specification_version |
| Directory server transaction ID | directory_server_transaction_id | pa_enroll_directory_server_transaction_id or pa_validate_directory_server_transaction_id |
Simple Order API
| Field Name | Request Field for the Authorization Service | Payer Authentication Reply Field (get value from here) |
|---|---|---|
| 3D Secure version | ccAuthService_paSpecificationVersion | payerAuthEnrollReply_specificationVersion or payerAuthValidateReply_specificationVersion |
| Directory server transaction ID | ccAuthService_directoryServerTransactionID | payerAuthEnrollReply_directoryServerTransactionID or payerAuthValidateReply_directoryServerTransactionID |
REST
| Field Name | Payments URL | Request Field for the Authorization Service | Payer Authentication Reply Field (get value from here) | PA enrollment URL | PA Validate URL |
|---|---|---|---|---|---|
| 3D Secure version | /pts/v2/payments | consumerAuthenticationInformation.paSpecificationVersion | consumerAuthenticationInformation.paSpecificationVersion | /risk/v1/authentications | /risk/v1/authentication-results |
| Directory server transaction ID | /pts/v2/payments | consumerAuthenticationInformation.directoryServerTransactionId | consumerAuthenticationInformation.directoryServerTransactionId | /risk/v1/authentications | /risk/v1/authentication-results |
Was this article helpful?
Articles Recommended for You
