Update a 3DS authentication request beta

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.

SecurityCommonAuth
Request
query Parameters
accountId
required
string

The ID of the account to work with.

Example: accountId=F50091
personId
string <uuid> <= 36 characters

The ID of the person to work with.

Example: personId=775596ae-2624-40af-a9dc-9756110a4a04
Request Body schema: application/json

Body

authenticationMethod
required
string

The method used to authenticate the cardholder.

Enum: "BIOMETRIC_FACE" "BIOMETRIC_FINGERPRINT" "VOICE_RECOGNITION" "IN_APP_LOGIN" "AUDIO_CALL" "VIDEO_CALL" "OTP_SMS" "OTP_EMAIL" "KNOWLEDGE_BASED" "OTHER"
authenticationResult
required
string

The result of the authentication performed.

Enum: "SUCCESS" "FAILED" "CANCELLED" "NOT_AUTHENTICATED"
acsTransactionId
required
string <= 36 characters

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

messageVersion
required
string <= 8 characters

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

Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

405

Method Not Allowed

415

Unsupported Media Type

429

Too Many Requests

500

Internal Server Error

patch/cards/3ds
Request samples
application/json
{
  • "authenticationMethod": "BIOMETRIC_FACE",
  • "authenticationResult": "SUCCESS",
  • "acsTransactionId": "string",
  • "messageVersion": "string"
}
Response samples
application/json
{
  • "success": true
}