Validate Request

The Validate request is communicated by the VCAS platform to the partner. The partner responds with a success, failure or retry logic.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Stepup Validation Request Object

string
required
length between 24 and 24
^[0-9a-fA-F]{24}$

VCAS provided identifier for the partner. Max. 24 characters.

string
required
length between 24 and 24
^[0-9a-fA-F]{24}$

VCAS provided identifier for the partner. Max. 24 characters.

string
required
length between 36 and 36
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

VCAS generated transaction reference id. Max. 36 characters. GUID format.

string
enum

Used to identify the method of Stepup.

string
length between 36 and 36
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Directory Server (DS) generated transaction reference id. GUID format.

string
enum

Will provide the outcome of the first authentication. Success, Failure, and Retry are the only valid values. The statuses of Pending, FailWithFeedback, Blocked, or Rejected do not apply unless the client is performing the validation on the first factor and returns them on the second factor RDX Validate response.

Allowed:
string
required
length between 36 and 36
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Unique identifier to identify the particular Stepup request. Length - 36 characters.

integer
required

Counter for tracking the number of Stepups. Each stepup can go from Stepup -> InitiateAction -> Validate. If the user requests a "resend" via the browser templates it will initiate another Stepup request.

string
required
length between 5 and 8
^[0-9]{1,2}\.[0-9]{1,2}\.[0-9]{1,2}$

Version of the message based on 3DS spec. Examples - 2.1.0, 2.2.0

string
length between 5 and 8
^[0-9]{1,2}\.[0-9]{1,2}\.[0-9]{1,2}$

Version of the RDX protocol being used. This will be used to enable new features without breaking current integrations. Example: 2.2.3 and 2.2.4

BehavioralBiometricsResult
object
CredentialResponse
array of objects
required
CredentialResponse*
Responses

405

Invalid input

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json