Skip to content

Get 3DS authentication by ID

Request

This endpoint retrieves the details of a specific 3DS standalone authentication using the authenticationId provided in the path. The service is designed for retrieving authentication records that were created as part of a 3DS verification process.

Path
authenticationIdstringrequired

The authentication ID.

curl -i -X GET \
  'https://api-services.pxp.io/api/v1/threedsecure/standalone/authentications/{authenticationId}'

Responses

OK

Bodyapplication/json
authenticationIdstring or null

A unique reference provided by PXP for the authentication request, represented as a GUID.

Example:"550e8400-e29b-41d4-a716-446655440000"
statestring or null

The current state of the authentication request.

Enum:"PendingClientData""AuthenticationSuccessful""AuthenticationFailed""AuthenticationRejected""AuthenticationError""PendingCustomerChallenge"
threeDSecureVersionstring or null

The version of the 3D Secure protocol being used for the authentication.

Example:"2.1.0"
directoryServerTransactionIdstring or null

The Directory Server transaction ID.

cardholderAuthenticationVerificationValuestring or null

A value generated during the authentication process to verify the cardholder's identity.

Example:"CAVV1234567890"
electronicCommerceIndicatorstring or null

The indicator used to signify the level of security used in the authentication, often used in electronic commerce transactions.

Example:"05"
Response
{ "authenticationId": "550e8400-e29b-41d4-a716-446655440000", "state": "PendingClientData", "threeDSecureVersion": "2.1.0", "directoryServerTransactionId": "string", "cardholderAuthenticationVerificationValue": "CAVV1234567890", "electronicCommerceIndicator": "05" }