Sign in

v1

latestOpenAPI 3.1.0UNLICENSED2026-07-2613101.1 MB
Cards

Update a 3DS authentication request

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.

patch/cards/3ds

Query parameters

accountIdstring required

The ID of the account to work with.

Example:F50091
personIdstring uuid

The ID of the person to work with.

Example:775596ae-2624-40af-a9dc-9756110a4a04

Request body

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.

acsTransactionIdstring required

The unique transaction identifier assigned by the ACS to identify a single transaction.

messageVersionstring required

The 3DS protocol version used by the 3DS Requestor.

Example request

{
  "authenticationMethod": "BIOMETRIC_FACE",
  "authenticationResult": "SUCCESS",
  "acsTransactionId": "string",
  "messageVersion": "string"
}

Response

OK

successboolean required

Indicates the outcome of the operation.

Example response

{
  "success": true
}