> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equalsmoney.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Simulate a 3DS auth request

> ------ | ----------- |

<Note>
  **POST** `/v2/cards/simulations/3DSAuthRequest`
</Note>

### Request

Use this request to simulate a 3D Secure (3DS) authentication request in the sandbox, and trigger the `3DSAuthRequest` webhook.

<CodeGroup>
  ```bash Sample request theme={null}
  curl -i -X POST \
    'https://api.equalsmoney.com/v2/cards/simulations/3DSAuthRequest?accountId=F50091' \
    -H 'Authorization: YOUR_API_KEY_HERE' \
    -H 'Content-Type: application/json' \
    -d '{
      "cardId": "e9293471-5eb3-4dbc-916c-dbaf9e2deefd",
      "amount": "10",
      "currencyCode": 826,
      "subType": "PURCHASE",
      "transactionType": "PAYMENT",
      "cardAcceptor": {
        "name": "John Smith"
      }
    }'
  ```

  ```bash Request structure theme={null}
  curl -i -X POST \
    'https://api.equalsmoney.com/v2/cards/simulations/3DSAuthRequest?accountId=F50091' \
    -H 'Authorization: YOUR_API_KEY_HERE' \
    -H 'Content-Type: application/json' \
    -d '{
      "cardId": "string",
      "amount": number,
      "currencyCode": "string",
      "subType": "string",
      "transactionType": "string",
      "cardAcceptor": {
        "name": "string"
      }
    }'
  ```
</CodeGroup>

#### Query parameters

<ParamField body="accountId" type="string" required>
  The ID of the account that the card is associated with.

  Allowable values: An existing `accountId`
</ParamField>

#### Request body schema

<ParamField body="cardId" type="string" required>
  TThe ID of the card to work with.

  Allowable values: A valid `cardId`
</ParamField>

<ParamField body="amount" type="number" required>
  Amount of the payment being made.
</ParamField>

<ParamField body="currencyCode" type="string" required>
  ISO 4217 three-digit currency code of the payment.

  Allowable values: ≤ 999
</ParamField>

### Response

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

<CodeGroup>
  ```json Sample response theme={null}
  {
    "success": true
  }
  ```

  ```json Response structure theme={null}
  {
    "success": boolean
  }
  ```
</CodeGroup>

For more detailed information about this request and its response, [see the API reference](/api-reference/simulations/simulate-a-3ds-auth-request).
