/ Guides / Cards / 3D Secure / Update a 3D Secure request

Update a 3D Secure request

Inform Marqeta about the result of a customer authentication.

Update 3D Secure authentication request

Patch/v2/cards/3ds

Request

Use this request to update a 3D Secure (3DS) authentication request and send the result to the access control server (ACS).

Sample requestRequest structure
Copy
Copied
curl -i -X PATCH \
  'https://api.equalsmoney.com/v2/cards/3ds?accountId=F12345&personId=775596ae-2624-40af-a9dc-9756110a4a04' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "authenticationMethod": "BIOMETRIC_FACE",
    "authenticationResult": "SUCCESS",
    "acsTransactionId": "c92aafca-5e9e-43fa-b7cc-cd20ece475f5",
    "messageVersion": "2.1.0"
  }'
Copy
Copied
curl -i -X PATCH \
  'https://api.equalsmoney.com/v2/cards/3ds?accountId={accountId}&personId={personId}' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "authenticationMethod": "string",
    "authenticationResult": "string",
    "acsTransactionId": "string",
    "messageVersion": "string"
  }

Query parameters

Parameter Description
accountId
string
required		 The ID of the account that the card is associated with.

Allowable values:
An existing accountId
personId The person that the card belongs to.

Allowable values:
An existing personId (<= 36 characters)

Request body schema

Parameter Description
authenticationMethod
string
required		 The method used to authenticate the cardholder.

Allowable values:
BIOMETRIC_FACE, BIOMETRIC_FINGERPRINT, VOICE_RECOGNITION, IN_APP_LOGIN, AUDIO_CALL, VIDEO_CALL, OTP_SMS, OTP_EMAIL, KNOWLEDGE_BASED, OTHER
authenticationResult
string
required		 The result of the authentication that was performed.

Allowable values:
SUCCESS, FAILED, CANCELLED, NOT_AUTHENTICATED
acsTransactionId
string
required		 The unique transaction identifier assigned by the ACS to identify the transaction.

Allowable values:
<= 36 characters
messageVersion
string
required		 The 3DS protocol version used by the 3DS Requestor.

Allowable values:
<= 8 characters

Response

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

Sample responseResponse structure
Copy
Copied
{
  "success": true
}
Copy
Copied
{
  "success": boolean
}

For more detailed information about this request and its response, see the API reference.