OOB Callback Validate Status Request

This call is used only for the OOB Callback Validate Status API and only applicable with OUTOFBANDOTHER and BIOMETRIC stepup types.

OOB Callback Validate Request API Reference: Interactive request/response specification

NameDescriptionTypeLengthRequired
ProcessorIdVCAS provided identifier for the client.String24 charactersRequired
IssuerIdVCAS provided identifier for the client.String24 charactersRequired
TransactionIdVCAS generated transaction reference id; 36-character GUID value.StringUp to 36 charactersRequired
StepupRequestIdUnique identifier to identify the particular Stepup request.StringUp to 36 charactersRequired
Language

Language to display the instructions and prompt to the cardholder. This value will decide which template is loaded, provided the language template is available. If not provided, the language is selected based on the issuer configuration and browser preference.

Examples:

  • en

  • en-US
StringUp to 8 charactersOptional
CredentialIdID value from StepupResponse ➤CredentialStringUp to 36 charactersOptional
Status

Status of the OOB Callback Validation Status request. Possible values:

  • SUCCESS: Ends the transaction with a successful authentication status to the merchant

  • STEPUP: Allows the cardholder to be challenged again and will start the RDX process over again with a new RDX Stepup Request.

  • FAILURE: Ends the transaction with a failed authentication status to the merchant.

  • FAILWITHFEEDBACK: Presents a screen to the cardholder with instructions to get help and will send back a failed authentication status to the merchant.

  • ERROR: Returns an unavailable authentication status to the merchant.

  • BLOCKED: Blocks the card and returns a failed authentication status to the merchant, future authentication attempts are failed until unblocked.

  • REJECTED: Only supported for 2.x.x transactions. This status ends the transaction with a rejected authentication status to the merchant and indicates they should not proceed with authorization.
StringEnumRequired
TransStatusReasonProvides information on why the Transaction Status field has the specified value. Transaction Status Reason ValuesString2 charactersOptional
RiskIndicatorIf returned, this value will be used in the creation of certain Authentication Values (AV) for EMV 3DS. The value passed must conform to the current AV value the issuer is using. This may also depend on the card brand of the transaction. For example, CAVV and IAV accept different values.StringUp to 3 charactersOptional
Reason

An object that can be used for sending a status code and description.

OOBCallbackValidateStatus.Reason

Objectn/aOptional
ErrorAn object that can be used to convey an error message on the response.
OOBCallbackValidateStatus.ErrorMessage
Object2 charactersOptional
RReqOverrides

For the OOB Callback OOB Validate Status flow, the StepupType type must be OUTOFBANDOTHER or BIOMETRIC. For this flow, RReqOverrides is a required object on the Validate Response.

The field is an object that contains four fields, all of which directly affect fields on the RReq message:

  • AuthenticationMethod

  • TransStatusReason

  • AuthenticationAttempts

  • CustomerCancel


OOBCallbackValidateStatus.RReqOverrides

ObjectNAConditional