Initiate Action
Changed onInitiate Action request is used to signal to the partner to take action on an item.
Request
- Base URLhttps://api.uat.paymentology.com/ppws/api
- URLhttps://api.uat.paymentology.com/ppws/api/pws/initiateaction/
- 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.
This is a unique value generated with each new OTP value or 'VerificationToken'. In the instance where the consumer can receive multiple OTPs for the same transaction, this can be leveraged to show the consumer which OTP the system is expecting to be entered. This value should be sent in the SMS or Email along with the VerificationToken and then displayed on the consumer screen.
Token to be sent to cardholder.
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
Indicates the type of 3RI request for EMV transactions.
Indicates the type of Authentication request. This data element provides additional information to the ACS to determine the best approach for handling an authentication request.
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
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. 2 characters.
Changes
- info
endpoint added
- info