# 3D Secure authentication service API

This is an API reference for the 3D Secure authentication service.

Version: 1.0.0

## Servers

Production environment
```
https://api-services.pxp.io/api/v1
```

Sandbox environment
```
https://api-services.test.pxp.io/api/v1
```

## Download OpenAPI description

[3D Secure authentication service API](https://developer.pxp.io/_bundle/apis/three-d-secure-authentication.yaml)

## Standalone authentication

### Pre-initiate a standalone authentication request

 - [POST /threedsecure/standalone/authentications](https://developer.pxp.io/apis/three-d-secure-authentication/standalone-authentication/pre-initiate-standalone-auth-request.md): Pre-initiates a stand-alone 3D Secure authentication request for a transaction. This endpoint is for merchants who use PXP's service solely for authentication purposes. The pre-initiation step gathers necessary information and ensures that all required data is available and valid before proceeding with the actual authentication request. This process helps to streamline the authentication process and enhance security.

### Initiate a standalone authentication request

 - [PUT /threedsecure/standalone/authentications/{authenticationId}/browser-authentication](https://developer.pxp.io/apis/three-d-secure-authentication/standalone-authentication/initiate-standalone-auth-request.md): Initiates a standalone 3D Secure authentication request for a transaction. This endpoint is for merchants who use PXP's service solely for authentication purposes. The process involves verifying the cardholder's identity through a browser-based interaction. The request payload must include comprehensive details about the transaction, card information, merchant information, and additional contextual data necessary for the 3D Secure authentication flow. This ensures a secure and efficient authentication process.

### Get 3DS authentication by ID

 - [GET /threedsecure/standalone/authentications/{authenticationId}](https://developer.pxp.io/apis/three-d-secure-authentication/standalone-authentication/retrieve-auth-by-id.md): 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.

## Integrated authentication

### Pre-initiate an integrated authentication request

 - [POST /threedsecure/integrated/authentications](https://developer.pxp.io/apis/three-d-secure-authentication/integrated-authentication/pre-initiate-integrated-auth-request.md): Pre-initiates an integrated 3D Secure authentication request for a transaction. In integrated mode, PXP processes the transaction in a separate initiate transaction request using the 3D Secure supplied data. This step ensures that all required data is gathered and validated before the full authentication process, facilitating a smoother and more secure transaction flow.

### Initiate an integrated authentication request

 - [PUT /threedsecure/integrated/authentications/{authenticationId}/browser-authentication](https://developer.pxp.io/apis/three-d-secure-authentication/integrated-authentication/initiate-integrated-auth-request.md): Authenticates an integrated 3D Secure transaction request. In integrated mode, PXP processes the transaction in conjunction with the 3D Secure authentication data. This ensures that the transaction is authenticated securely, leveraging the full authentication data collected during the pre-initiation phase. The request payload must include comprehensive details about the transaction, card information, merchant information, and additional contextual data necessary for the 3D Secure authentication flow.

### Get 3DS pre-initiate authentication details

 - [GET /threedsecure/integrated/authentications/{authenticationId}/assessment](https://developer.pxp.io/apis/three-d-secure-authentication/integrated-authentication/get-preinitiate-authentication-details.md): Retrieves the details of a specific 3DS pre-initiate authentication using the authenticationId provided in the path. Note: This endpoint is intended for use with the Components SDKs.

### Get 3DS authentication details

 - [GET /threedsecure/integrated/authentications/{authenticationId}/outcome](https://developer.pxp.io/apis/three-d-secure-authentication/integrated-authentication/get-authentication-details.md): Retrieves the complete details of a specific 3DS authentication using the authenticationId provided in the path.  Note: This endpoint is intended for use with the Components SDKs.