Verify 3Ds authentication status
POST/customers/:customerId/prepaid/cards/:cardId/3ds-authentications/:auth3dsId
The endpoint will update the status of the 3D Secure authentication, and based on the provided status, the authorization request will be either VERIFIED
or REJECTED
.
Request
Path Parameters
Unique identifier of the customer.
UUID based Card id.
Authentication 3DS id.
- application/json
Body
Information about the status of the 3DS authentication and the method used for it.
- VERIFIED - The 3DS authentication process has been successfully completed, and the given
authorization
attempt is permited. - REJECTED - The 3DS authentication process has been rejected by the user, preventing from the
authorzation
request to complete. - FAILED - The 3DS authentication process has failed, preventing the
authorzation
to complete. Please refer tostatusReason
for further information.
A distinct identifier for the 3DS operation.
verification
object
required
Contains information about the mechanism used during the verification.
Possible values: [BIOMETRIC
]
Authentication method.
Possible values: [VERIFIED
, REJECTED
, FAILED
]
Possible values: <= 100 characters
Reason for the unsuccessful 3DS authentication.
Responses
- 201
- 400
- 401
- 500
- 503
Created
- application/json
- Schema
- Example (from schema)
- VERIFIED_3DS_AUTHENTICATION
- EXPIRED_3DS_AUTHENTICATION_REQUEST
Schema
- VERIFIED - The 3DS authentication process has been successfully completed, and the given
authorization
attempt is permited. - REJECTED - The 3DS authentication process has been rejected by the user, preventing from the
authorzation
request to complete. - FAILED - The 3DS authentication process has failed, preventing the
authorzation
to complete. Please refer tostatusReason
for further information.
A distinct identifier for the 3DS operation.
verification
object
required
Contains information about the mechanism used during the verification.
Possible values: [BIOMETRIC
]
Authentication method.
Possible values: [VERIFIED
, REJECTED
, FAILED
]
Possible values: <= 100 characters
Reason for the unsuccessful 3DS authentication.
Unique identifier of the customer.
UUID based Card id.
Authentication 3DS id.
Represents creation RFC 3339, section 5.6 date-time.
{
"walletOperationId": "bbbd87eb-08a9-437b-a9a7-df47b601593b",
"verification": {
"method": "BIOMETRIC"
},
"status": "VERIFIED",
"statusReason": "string",
"customerId": "5435323362",
"cardId": "string",
"auth3dsId": "string",
"creationTime": "2021-07-15T17:54:12Z"
}
{
"walletOperationId": "bbbd87eb-08a9-437b-a9a7-df47b601593b",
"verification": {
"method": "BIOMETRIC"
},
"status": "VERIFIED",
"customerId": "5435323362",
"cardId": "ff3713e7-61f5-4c54-9131-81ba820c2efa",
"auth3dsId": "41260ee6-4b29-43c8-8e00-4c911f0179f9",
"creationTime": "2021-07-15T17:54:12Z"
}
{
"walletOperationId": "bbbd87eb-08a9-437b-a9a7-df47b601593b",
"verification": {
"method": "BIOMETRIC"
},
"status": "FAILED",
"statusReason": "3DS authentication request has expired.",
"customerId": "5435323362",
"cardId": "ff3713e7-61f5-4c54-9131-81ba820c2efa",
"auth3dsId": "41260ee6-4b29-43c8-8e00-4c911f0179f9",
"creationTime": "2021-07-15T17:54:12Z"
}
Bad Request
- application/json
- Schema
- Example (from schema)
- MISSING_VERIFICATION_METHOD
Schema
Array [
]
error
object
Represents details of an error.
The error code.
The description of the error.
Details for the errors of any parameter value.
fieldErrors
object[]
List of field errors associated with the main error.
Identifies the JSON request field.
The problem associated with the field.
{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
],
"fieldErrors": [
{
"field": "string",
"error": "string"
}
]
}
}
{
"error": {
"code": "5068",
"message": "Field error(s)",
"details": [
"Either you submitted a request that is missing a mandatory field or the value of a field does not match the format expected."
],
"fieldErrors": [
{
"field": "verification.method",
"error": "must not be null"
}
]
}
}
Unauthorized
- application/json
- Schema
- Example (from schema)
- INVALID_CREDENTIALS
Schema
Array [
]
error
object
Represents details of an error.
The error code.
The description of the error.
Details for the errors of any parameter value.
fieldErrors
object[]
List of field errors associated with the main error.
Identifies the JSON request field.
The problem associated with the field.
{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
],
"fieldErrors": [
{
"field": "string",
"error": "string"
}
]
}
}
{
"error": {
"code": "5279",
"message": "Invalid credentials",
"details": [
"The authentication credentials are invalid."
]
}
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
- INTERNAL_SERVER_ERROR
Schema
Array [
]
error
object
Represents details of an error.
The error code.
The description of the error.
Details for the errors of any parameter value.
fieldErrors
object[]
List of field errors associated with the main error.
Identifies the JSON request field.
The problem associated with the field.
{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
],
"fieldErrors": [
{
"field": "string",
"error": "string"
}
]
}
}
{
"error": {
"code": "DW-INTERNAL-SERVER-ERROR",
"message": "Internal Server Error",
"details": [
"There was an error while processing the operation"
]
}
}
Service Unavailable
- application/json
- Schema
- Example (from schema)
- SERVICE_UNAVAILABLE
Schema
Array [
]
error
object
Represents details of an error.
The error code.
The description of the error.
Details for the errors of any parameter value.
fieldErrors
object[]
List of field errors associated with the main error.
Identifies the JSON request field.
The problem associated with the field.
{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
],
"fieldErrors": [
{
"field": "string",
"error": "string"
}
]
}
}
{
"error": {
"code": "DW-SERVICE-UNAVAILABLE",
"message": "Service Unavailable",
"details": [
"Service Unavailable"
]
}
}