VCAS

Stepup Validate

Changed on

Stepup Validate request is communicate by the VCAS platform to the partner, and the partner responds with a success,failure or retry logic.

post/pws/validate/

Request

  • Base URL
    https://api.uat.paymentology.com/ppws/api
  • URL
    https://api.uat.paymentology.com/ppws/api/pws/validate/
  • Auth
    none declared

Request body

IssuerIdstring required

Cardinal provided identifier for the partner. Length - Up to 24 Characters

MessageVersionstring required

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

ProcessorIdstring required

Cardinal provided identifier for the partner. Length - Up to 24 Characters

StepupCounterinteger 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.

StepupRequestIdstring required

Unique identifier to identify the particular Stepup request. Length will be 36 Characters.

TransactionIdstring required

VCAS generated transaction reference id. Length - Up to 36 Characters. 3DS 1.0.2 - 28 character alpha-numeric. EMV 3DS - 36 character GUID.

DSTransactionIdstring

Directory Server (DS) generated transaction reference id. GUID Format. Note: EMV 3DS Transactions only

StepupType'CHOICE' | 'OTP' | 'KBA' | 'BIOMETRIC' | 'OUTOFBAND' | 'OTP_AND_KBA' | 'OTP_CHOICE_AND_KBA'

Used to identify what type of stepup.

FirstFactorOutcome'SUCCESS' | 'FAILURE' | 'RETRY' | 'PENDING' | 'FAILWITHFEEDBACK' | 'BLOCKED' | 'REJECTED' | 'ATTEMPTS'

Will provide the outcome of the first authentication. Success, Failure, and Retry should be the only valid values. However, a status of Pending, FailWithFeedback, Blocked, Rejected, and Attempts can be returned if an Issuer returned one of these Status on the first RDX Validate response.

RDXMessageVersionstring

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

Response

Successful Response

IssuerIdstring required

Echoed from Request. Length - Up to 24 Characters

ProcessorIdstring required

Echoed from Request. Length - Up to 24 Characters

Status'SUCCESS' | 'FAILURE' | 'RETRY' | 'PENDING' | 'BLOCKED' | 'STEPUP' | 'ERROR' | 'ATTEMPTS' | 'FAILWITHFEEDBACK' | 'REJECTED' | 'FAIL' | 'CHALLENGE' | 'AUTHENTICATED' required

ERROR is returned on any interal/technical issues. ATTEMPTS is only supported for 1.0.2 transactions. REJECTED is only supported for 2.x.x transactions. AUTHENTICATED will return a Y back to merchant

StepupRequestIdstring required

Echoed from Request. Length - 36 Characters

TransactionIdstring required

Echoed from Request. Length - Up to 36 Characters

Languagestring

Language to display the instructions and prompt to the cardholder. This value will decide which template is loaded, provided the correct template language is available. If not provided, the language is selected based on Issuer configuration and browser preference e.g. en-US. Length - Up to 8 Characters

CredentialIdstring

ID value from StepupResponse->Credential. Length - 36 Characters

RiskIndicatorstring

If 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. On Challenge responses (Stepup, Initiate, Validate) this value is currently ignored for CAVV usages in favor of mapping to the 'Credential Type'. For Enhanced IAV SPA2 usage, if passed, this value will override the mapping to the 'Credential Type'. Note: This field is only available for EMV 3DS transactions and not available on 3DS 1 transactions Note: The value here will be converted to the Hexadecimal equivalent. Please see 'VCAS Enhanced AV' document for more details on current AVs available and the corresponding values.

TransStatusReasonstring

Provides information on why the Transaction Status field has the specified value.

Changes