# 3DS

Protect your business and meet regulatory requirements by verifying your customer's identity.

__Authentication header__
  ```
    Authorization: {your_credentials}
  ```
Replace `{your_credentials}` with your base64-encoded Basic Auth username and password given to your by your Implementation Manager.
<br /> <br />

You **must** use the `Authorization` header for any request you send to our 3DS API.

__Accept/Content-Type header__
  ```
  Content-Type: application/vnd.worldpay.verifications.customers-v3.hal+json
  Accept: application/vnd.worldpay.verifications.customers-v3.hal+json
  ```
We use the Accept header to identify which version of our API you are using. You must use the Accept header for any request you send to our 3DS API.

We require the Content-Type header if the request you're sending includes a request body, and if the HTTP method is a `POST` or a `PUT`.
<br /><br />


__DNS whitelisting__  
Whitelist the following URLs:
* `https://try.access.worldpay-bsh.securedataplatform.com/`
* `https://access.worldpay-bsh.securedataplatform.com/`

Please ensure you use DNS whitelisting, not explicit IP whitelisting.

Version: 3
Metadata:
  - category: ["3DS","SCA Exemptions"]
  - business: ["Enterprise"]
  - catalog-list: true
  - generated: false

## Servers

Test (Try)
```
https://try.access.worldpay-bsh.securedataplatform.com
```

Live
```
https://access.worldpay-bsh.securedataplatform.com
```

## Security

### BasicAuth

Type: http
Scheme: basic

## Download OpenAPI description

[3DS](https://developer.worldpay-bsh.securedataplatform.com/_bundle/products/3ds/@v3/openapi.yaml)

## Other

### Generate required data for 3DS Device Data Collection

 - [POST /verifications/customers/3ds/deviceDataInitialization](https://developer.worldpay-bsh.securedataplatform.com/products/3ds/openapi/other/devicedatainitialize.md): Allow card issuers to perform Device Data Collection to fingerprint your customer's device.

### Initiate the 3DS authentication

 - [POST /verifications/customers/3ds/authentication](https://developer.worldpay-bsh.securedataplatform.com/products/3ds/openapi/other/authenticate.md): Authenticate your customer by submitting order and risk data.

### Verify the 3DS challenge response

 - [POST /verifications/customers/3ds/verification](https://developer.worldpay-bsh.securedataplatform.com/products/3ds/openapi/other/verify.md): Verify the results of a challenged authentication.