InitiateActionResponse

InitiateAction API Reference: Interactive request/response specification

InitiateAction Code Recipe: Pseudocode resource with code snippets

Name	Description	Type	Length	Required
ProcessorId	Echoed from Request.	String	Up to 24 characters	Required
IssuerId	Echoed from Request.	String	Up to 24 characters	Required
TransactionId	Echoed from Request.	String	Up to 36 characters	Required
StepupRequestId	Echoed from Request.	String	Up to 36 characters	Required
StepupType	Used to identify the type of Stepup. Stepup Type Values	String	Enum	Optional
Language	Language to display the instructions and prompt to the cardholder. This value will decide which template is loaded, provided the language template is available. If not provided, the language is selected based on the issuer configuration and browser preference. Examples: en en-US	String	Up to 8 characters	Optional
Status	Status of the Initiate Action Request. Possible values: SUCCESS: This will trigger the Validate screen with instructions to the cardholder on next steps. It is important that this response is returned immediately so the cardholder is aware of what to expect prior to receiving an OTP or Push Notification AUTHENTICATED: Ends the transaction with a successful authentication status to the merchant FAILURE: Ends the transaction with a failed authentication status to the merchant FAILWITHFEEDBACK: Presents a screen to the cardholder with instructions to get help and will send back a failed authentication status to the merchant ERROR: Returns an unavailable authentication status to the merchant BLOCKED: Blocks the card and returns a failed authentication status to the merchant, future authentication attempts are failed until unblocked REJECTED: Only supported for 2.x.x transactions. This status ends the transaction with a rejected authentication status to the merchant and indicates to them they should not proceed with authorization Note: When an AUTHENTICATED status is returned for EMV 3DS, the authenticationType will be ‘10’ - Other	String	Enum	Required
TransStatusReason	Provides information on why the Transaction Status field has the specified value. Transaction Status Reason Values	String	2 characters	Optional
RiskIndicator	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, InitiateAction, 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 value will be converted to the hexadecimal equivalent. Please see the “VCAS Enhanced AV Support Guide” for more details on current AVs available and the corresponding values.	String	Up to 3 characters	Optional
Credentials	A list of Credential objects that will be used to challenge the user. This must contain at least one consumer contact information. If multiple are returned VCAS can configure your setup to show the user a “choice screen”. InitiateActionResponse.Credentials.Credential	List Object	Minimum one character	Required
Reason	An object that can be used for sending a status code and description. InitiateActionResponse.Reason	Object	NA	Optional
Error	An object that can be used to convey an error message on the response. InitiateActionResponse.Error	Object	NA	Optional