---
title: "Update a 3DS authentication request"
method: PATCH
path: "/cards/3ds"
tags: ["Cards"]
---

# Update a 3DS authentication request

`PATCH /cards/3ds`

Updates a 3D Secure (3DS) authentication request and sends the result to the access control server (ACS).

 3DS is a security protocol designed to authenticate a cardholder during an online card transaction. If the cardholder fails to authenticate, then the transaction is voided.

## Query parameters

- `accountId` string, required — The ID of the account to work with.
- `personId` string, uuid — The ID of the person to work with.

## Request body

- object
  - `authenticationMethod` 'BIOMETRIC_FACE' | 'BIOMETRIC_FINGERPRINT' | 'VOICE_RECOGNITION' | 'IN_APP_LOGIN' | 'AUDIO_CALL' | 'VIDEO_CALL' | 'OTP_SMS' | 'OTP_EMAIL' | 'KNOWLEDGE_BASED' | 'OTHER', required — The method used to authenticate the cardholder.
  - `authenticationResult` 'SUCCESS' | 'FAILED' | 'CANCELLED' | 'NOT_AUTHENTICATED', required — The result of the authentication performed.
  - `acsTransactionId` string, required — The unique transaction identifier assigned by the ACS to identify a single transaction.
  - `messageVersion` string, required — The 3DS protocol version used by the 3DS Requestor.

## Response `200`

OK

- object
  - `success` boolean, required — Indicates the outcome of the operation.

---

[API](https://skmtc.net/equalsmoney/apis/cis-api.md) · [All operations](https://skmtc.net/equalsmoney/apis/cis-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/equalsmoney/cis-api/revisions/a162c72b8bf6/schema)