StepupRequest

Se a avaliação de risco resultar em um status de Desafio (StepUp), o emissor determinará como deseja desafiar o titular do cartão. O resultado desta etapa consiste principalmente em uma lista de formas de desafio do titular do cartão, também conhecida como “Credenciais”.

Referência para a API StepupRequest: Especificação interativa para chamada/resposta.

Exemplo de Codificação para a StepupRequest: Exemplo de codificação com trechos de pseudocódigos.

NomeDescriçãoTipoTamanhoCondição
ProcessorIdID de referência de transação gerada pelo VCAS: valor GUID de 24 caracteres.String24 caracteresRequerido
IssuerIdID de referência de transação gerada pelo VCAS: valor GUID de 24 caracteres.String24 caracteresRequerido
TransactionIdID de referência de transação gerada pelo VCAS: valor GUID de 36 caracteres.StringAté 36 caracteresRequerido
DSTransactionIdID de referência de transação gerada pelo Directory Server (DS). Formato GUID.String36 caracteresCondicional
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.

3RI Indicator Values

StringenumOpcional
ThreeDSRequestorAuthenticationInd

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.

3DS Requestor Authentication Indicator Values

String2 caracteresOpcional
StepupRequestIdIdentificador exclusivo para identificar a solicitação Stepup específica. O tamanho é de até 36 caracteres.StringAté 36 caracteresOpcional
StepupCounter

Contador para o número de chamadas Stepup.
Cada ciclo Stepup pode seguir o fluxo Stepup ➤ InitiateAction ➤ Validate.

Se o usuário solicitar um "reenvio" por meio do navegador ou de modelos de aplicativos nativos, ele iniciará outra solicitação de Stepup. Nota: O valor inicial será 0 (zero).

IntegerRequerido
DeviceLocale

Localidade do dispositivo no cabeçalho do navegador ou nas configurações de idioma do aplicativo nativo. Esse valor pode ser um único valor de localidade ou vários valores concatenados por vírgulas. No EMV 3DS isso não está disponível devido a novos fluxos, portanto este será um valor de idioma único seguindo o formato BCP 47.

Examplos:

  • en-US

  • en,es-PE;q=0.9,es;q=0.8
StringAté 2.048 caracteresOpcional
DeviceUserAgentAgente de usuário do dispositivo no cabeçalho do navegador ou no identificador de dispositivo do aplicativo.StringAté 2.048 caracteresOpcional
MessageVersion

Versão do protocolo 3DS baseado nas especificações 3DS.

Esta versão será incrementada a cada nova especificação lançada pela EMVCo para 2.x. Isso normalmente seguirá um formato de versão X.Y.Z. Exemplos: 2.1.0, 2.2.0

StringAté 8 caracteres.Requerido
RDXMessageVersionMensagem Versão do protocolo RDX em uso. Isso será usado para habilitar novos recursos sem interromper as integrações atuais. Exemplos: 2.2.2 ou 2.2.3StringAté 8 caracteresOpcional
MessageCategoryIdentifica a categoria da mensagem para um caso de uso específico; 01=PA, 02=NPAString2 caracteresOpcional
StepupReasonO motivo pelo qual a solicitação Stepup foi iniciada. Exemplo: CARDHOLDER_RESEND - Quando o titular do cartão é desafiado e clica no botão Reenviar na página de validação de OTP, a próxima solicitação Stepup conterá este valor.
Nota: Disponível apenas para Reenvio do Titular do Cartão, podendo ser acrescidos valores e cenários futuros.
StringEnumOpcional
MerchantInfo

Objeto contendo as informações do comerciante.

StepupRequest.MerchantInfo

ObjectNAOpcional
PaymentInfo

Objeto que contém o PaymentInfo.

StepupRequest.PaymentInfo

ObjectNAOpcional
TransactionInfo

Objeto contendo as informações da transação.

StepupRequest.TransactionInfo

ObjectNAOpcional
CardholderSelectionInfo

Objeto que define a seleção de consumidores durante o fluxo OTP de Seleção de Portadores. Este recurso só é preenchido e habilitado para emissores que suportam este fluxo.

StepupRequest.CardholderSelectionInfo

ObjectNAOpcional
EmbeddedOOBResponseUrlO emissor deve redirecionar para esse URL quando a validação for concluída, durante um desafio OOB (Out-of-Band) habilitado.StringNACondicional