Stepup Request, Embedded-OOB

post

https://4f1f4a08-8aba-4366-bbcc-001af05920ab.mock.pstmn.io/stepup-embedded-oob

Embedded OOB is designed to be integrated with centralized authentication systems including Online Bank Login, Native App Login, 3DS, and Open Banking.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Stepup Request Object

ProcessorId

string

required

Defaults to 5723ae630063ac1a9c3ab079

VCAS provided identifier for the partner. 24 characters.

IssuerId

string

required

Defaults to 5723ae630063ac1a9c3ab083

VCAS provided identifier for the partner. 24 characters.

TransactionId

string

required

Defaults to 00ec043e-40b5-4ce4-95c2-9e83b644f412

VCAS generated transaction reference id. Max. 36 characters. GUID format.

DSTransactionId

string

Defaults to 00ec043e-40b5-4ce4-95c2-9e83b644f987

Directory Server (DS) generated transaction reference id. GUID format.

3RIIndicator

string

enum

Defaults to RecurringTransaction

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.

ThreeDSRequestorAuthenticationInd

string

enum

Defaults to 01

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.

Allowed:

StepupRequestId

string

required

Defaults to 878f4751-4140-4881-9e4a-003e83524f22

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

StepupCounter

integer

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.

DeviceLocale

string

Defaults to en-US

Device Locale from the browser header or from the app’s language settings. This value can be a single locale value or multiple concatenated together via commas. In 3DS2 this is not available due to new flows so this will be a single language value following BCP 47 format e.g. en-US or en,es-PE;q=0.9,es;q=0.8

DeviceUserAgent

string

Defaults to Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36

Device user agent from the browser header or the app's device identifier. Max. 2048 characters.

MessageVersion

string

required

Defaults to 2.2.0

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

RDXMessageVersion

string

Defaults to 2.2.4

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

MessageCategory

string

enum

Defaults to 01

Identifies the category of the message for a specific use case; 01=PA, 02=NPA

Allowed:

StepupReason

string

enum

Used to identify the reason the Stepup request was initiated. Only available for Cardholder Resend, future values and scenarios may be added.

Allowed:

MerchantInfo

object

PaymentInfo

object

TransactionInfo

object

CardholderSelectionInfo

object

Object defining the consumers selection during the Cardholder Selection OTP flow. This feature is only populated and enabled for issuers supporting this flow.

EmbeddedOOBResponseUrlInfo

string

The issuer must redirect to this URL when validation is complete, during an Embedded OOB challenge.

Responses

405

Invalid input

200Successful Stepup Response