Stepup Validate
Changed onStepup Validate request is communicate by the VCAS platform to the partner, and the partner responds with a success,failure or retry logic.
Request
- Base URLhttps://api.uat.paymentology.com/ppws/api
- URLhttps://api.uat.paymentology.com/ppws/api/pws/validate/
- Authnone declared
Request body
Cardinal provided identifier for the partner. Length - Up to 24 Characters
Version of the message based on 3DS spec. Examples - 1.0.2, 2.1.0, 2.2.0
Cardinal provided identifier for the partner. Length - Up to 24 Characters
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.
Unique identifier to identify the particular Stepup request. Length will be 36 Characters.
VCAS generated transaction reference id. Length - Up to 36 Characters. 3DS 1.0.2 - 28 character alpha-numeric. EMV 3DS - 36 character GUID.
Directory Server (DS) generated transaction reference id. GUID Format. Note: EMV 3DS Transactions only
Used to identify what type of stepup.
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.
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
Echoed from Request. Length - Up to 24 Characters
Echoed from Request. Length - Up to 24 Characters
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
Echoed from Request. Length - 36 Characters
Echoed from Request. Length - Up to 36 Characters
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
ID value from StepupResponse->Credential. Length - 36 Characters
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.
Provides information on why the Transaction Status field has the specified value.
Changes
- info
endpoint added
- info