StepupRequest
If the Risk assessment results in a status of Stepup, the issuer then determines how they want to challenge the cardholder. The result of this step consists mainly of a list of ways that the cardholder can be challenged, also known as “Credentials”.
StepupRequest API Reference: Interactive request/response specification
StepupRequest Code Recipe: Pseudocode resource with code snippets
| Name | Description | Type | Length | Required |
|---|---|---|---|---|
| ProcessorId | VCAS generated transaction reference id: 24-character GUID value. | String | 24 characters | Required |
| IssuerId | VCAS generated transaction reference id: 24-character GUID value. | String | 24 characters | Required |
| TransactionId | VCAS generated transaction reference id: 36-character GUID value. | String | Up to 36 characters | Required |
| DSTransactionId | Directory Server (DS) generated transaction reference id. GUID format. | String | 36 characters | Conditional |
| 3RIIndicator | Indicates the type of 3RI request for EMV transactions. Note: Please allow for future values in this field. EMV has reserved up to 99 values for future use. | String | String; enum | Optional |
| ThreeDSRequestorAuthenticationInd | Indicates the type of 3RI request for EMV transactions. Note: Please allow for future values in this field. EMV has reserved up to 99 values for future use. | String | 2 characters | Optional |
| StepupRequestId | Unique identifier to identify the particular Stepup request. Length is 36 characters. | String | Up to 36 characters | Optional |
| StepupCounter | Counter for tracking the number of Stepup calls. If the user requests a "resend" via the browser or native app templates it will initiate another Stepup request. Note: Initial value will be 0 (zero). | Integer | Required | |
| DeviceLocale | Device Locale from the browser header or from the native application’s language settings. This value can be a single locale value or multiple values concatenated via commas. In EMV 3DS this is not available due to new flows so this will be a single language value following BCP 47 format. Examples:
| String | Up to 2048 characters | Optional |
| DeviceUserAgent | Device user agent from the browser header or the app’s device identifier | String | Up to 2048 characters | Optional |
| MessageVersion | Version of the 3DS protocol based on 3DS spec. This version will increment with each new specification released by EMVCo for 2.x. This will typically follow a X.Y.Z version format.
| String | Up to 8 characters. | Required |
| RDXMessageVersion | Message Version of the RDX protocol being used. This will be used to enable new features without breaking current integrations. Example: 2.2.3 or 2.2.4 | String | Up to 8 characters | Optional |
| MessageCategory | Identifies the category of the message for a specific use case.
| String | 2 characters | Optional |
| StepupReason | The reason the Stepup request was initiated. Example: CARDHOLDER_RESEND - When the cardholder is challenged and clicks the Resend button on the OTP validate page, the next Stepup request will contain this value. Note: Only available for Cardholder Resend, future values and scenarios may be added. | String | Enum | Optional |
| MerchantInfo | Object containing the Merchant information. | Object | NA | Optional |
| PaymentInfo | Object containing the PaymentInfo. | Object | NA | Optional |
| TransactionInfo | Object containing the Transaction information. | Object | NA | Optional |
| CardBrandName | Name of the card network for a specific transaction. Values include:
| String | Enum | Required |
| CardholderSelectionInfo | Object defining the consumers selection during the Cardholder Selection OTP flow. This feature is only populated and enabled for issuers supporting this flow. | Object | NA | Optional |
| ExtensionData | Object defining data extension information related to the transaction. Stepup.Request.ExtensionData (Object) | |||
| EmbeddedOOBResponseUrl | The issuer must redirect to this URL when validation is complete, during an Embedded OOB challenge. | String | NA | Conditional |
Updated about 1 month ago