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.String24 caracteresRequerido
IssuerId Identificação fornecida pelo VCAS.String24 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