RDX Specification

ValidateRequest

A chamada de Validate é informada pelo VCAS ao cliente. O cliente responde com sucesso, falha ou retentativa.

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

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

NomeDescriçãoTipoTamanhoCondição
ProcessorId Identificação fornecida pelo VCAS.StringAté 24 caracteresRequerido
IssuerId Identificação fornecida pelo VCAS.StringAté 24 caracteresRequerido
TransactionId ID de referência de transação gerada por VCAS: valor GUID de 36 caracteres.StringAté 36 caracteresRequerido
StepupType O valor StepupType que foi retornado na resposta Stepup RDX, o RDX enviará esse campo na chamada ValidateRequest.

Valores Stepup
StringEnumOpcional; usado apenas durante o Stepup desafio
DSTransactionId ID de referência de transação gerada pelo Directory Server (DS). Formato GUID.String36 caracteresCondicional
StepupRequestId ID exclusivo para identificar a solicitação Stepup específica. O comprimento é de 36 caracteres.StringAté 36 caracteresOpcional
FirstFactorOutcomeSerá fornecido o resultado da primeira autenticação. Valores da resposta de Validate:

  • SUCCESS: Continua a transação com um status de autenticação bem-sucedido do primeiro fator.
  • FAILURE: Continua a transação com status de falha na autenticação do primeiro fator.
  • RETRY: Permite que o titular do cartão tente novamente a autenticação e a lógica de validação pode ser criada para limitar o número de tentativas de autenticação. Nota: Este status só é aplicável quando o VCAS não está validando o valor OTP ou Token do emissor.O status a seguir não deve ser aplicado ao Resultado do Primeiro Fator, a menos que o cliente esteja realizando a validação no primeiro fator e os retorne na resposta RDX Validate do primeiro fator.
  • PENDING: Iniciará outra solicitação de validação do VCAS para o emissor após 2 segundos e só será usado quando StepUpResponse ➤ Type for OUTOFBANDOTHER ou BIOMÉTRICO
  • FAILWITHFEEDBACK: Apresenta uma tela ao titular do cartão com instruções para obter ajuda e retornará um status de falha na autenticação ao comerciante.
  • BLOCKED: Bloqueia o cartão e retorna um status de falha de autenticação ao estabelecimento comercial; futuras tentativas de autenticação falharão até serem desbloqueadas.
  • REJECTED: Suportado apenas para transações 2.x.x. Este status encerra a transação com um status de autenticação rejeitada para o comerciante e indica que ele não deve prosseguir com a autorização.Nota: Error e Stepup não são valores de status disponíveis porque o RDX não continuará com a parte do segundo fator. O erro retornará um status de autenticação indisponível e o Stepup enviará uma nova solicitação de Stepup RDX.
  • StringEnumOpcional
    StepupCounter Contador para rastrear o número de chamadas Stepup. Cada Stepup pode ir de Stepup ➤ InitiateAction ➤ Validate.

    Se o usuário solicitar um "reenvio" por meio do navegador ou de templates para browser ou app, ele iniciará outra solicitação de Stepup.

    Note: O valor inicial será 0 (zero).
    IntegerRequerido
    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.2. Isso normalmente seguirá um formato de versão X.Y.Z. Exemplo: 2.2.0
    StringAté 8 caracteres.Requerido
    RDXMessageVersion Mensagem Versão do protocolo RDX em uso. Ele será usado para habilitar novos recursos sem interromper as integrações atuais. Exemplo: 2.2.2StringAté 8 caracteresOpcional
    BehavioralBiometricsResultObjeto para validar resultado em autenticação biométrica comportamental.

    ValidateRequest.BehavioralBiometricsResult
    List.ObjectNARequired
    CredentialResponseUma lista de objetos de resposta de credenciais. Deve conter pelo menos um objeto de credencial. Este objeto é utilizado para validar o desafio e pode conter valores inseridos pelo consumidor; por exemplo o OTP a ser validado.

    ValidateRequest.CredentialResponse
    List.ObjectNARequerido