Get authentication details

Retrieve details about a 3DS standalone authentication using its identifier.

Retrieve 3DS authentication details by ID

GET

/v1/threedsecure/standalone/authentications/{authenticationId}

Request example

Use this request to retrieve details about a 3DS authentication using its identifier.

curl -i -X GET \
  'https://api-services.pxp.io/api/v1/threedsecure/standalone/authentications/550e8400-e29b-41d4-a716-446655440000'

Path parameters

Parameter	Description
`authenticationId` string (GUID) required	The unique identifier for the authentication request.

Response example

If your request is successful, you'll receive a 200 response.

{
  "authenticationId": "550e8400-e29b-41d4-a716-446655440000",
  "state": "PendingClientData",
  "threeDSecureVersion": "2.1.0",
  "directoryServerTransactionId": "8ac7a4a3-7c50-4c48-9b3f-5d8e6f9a1b2c",
  "cardholderAuthenticationVerificationValue": "CAVV1234567890",
  "electronicCommerceIndicator": "05"
}

Response parameters

Parameter	Description
`authenticationId` string (GUID)	The unique reference provided by PXP for the authentication request.
`state` string	The current state of the authentication request. Possible values: `PendingClientData` `AuthenticationSuccessful` `AuthenticationFailed` `AuthenticationRejected` `AuthenticationError` `PendingCustomerChallenge`
`threeDSecureVersion` string	The version of the 3D Secure protocol being used for the authentication (e.g., `2.1.0`).
`directoryServerTransactionId` string or null	The Directory Server transaction ID.
`cardholderAuthenticationVerificationValue` string or null	A value generated during the authentication process to verify the cardholder's identity (CAVV).
`electronicCommerceIndicator` string or null	The indicator used to signify the level of security used in the authentication, often used in electronic commerce transactions.