RDX Specification

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.StringAté 24 caracteresRequerido
IssuerIdID de referência de transação gerada pelo VCAS: valor GUID de 24 caracteres.StringAté 24 caracteresRequerido
TransactionId ID de referência de transação gerada pelo VCAS: valor GUID de 36 caracteres.StringAté 36 caracteresRequerido
DSTransactionId ID de referência de transação gerada pelo Directory Server (DS). Formato GUID. String36 caracteresCondicional
3RIIndicatorIndicates 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
String enumOpcional
ThreeDSRequestorAuthenticationIndIndicates 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
StepupRequestId Identificador 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
    DeviceUserAgent Agente 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
    RDXMessageVersion Mensagem 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
    StepupReason O 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
    EmbeddedOOBResponseUrl O emissor deve redirecionar para esse URL quando a validação for concluída, durante um desafio OOB (Out-of-Band) habilitado.StringNACondicional