Eventos de Autenticação

ready

Este evento é acionado quando todos os procedimentos de carregamento do script foram concluídos com sucesso, incluindo a validação do token de acesso. Indica que o checkout está pronto para iniciar o processo de autenticação.


success

Este evento é acionado quando o cartão é elegível e o processo de autenticação é finalizado com sucesso. Neste caso, as variáveis Cavv, Xid e Eci são retornadas e devem ser incluídas na requisição de autorização. Quando a transação é autorizada com essas informações, a responsabilidade (liability) da transação é transferida para o emissor do cartão.


failure

Este evento ocorre quando o cartão é elegível, mas o processo de autenticação falha por algum motivo. Somente a variável Eci será retornada. Caso o estabelecimento decida prosseguir com a autorização mesmo assim, o valor de Eci deve ser incluído na requisição. Neste cenário, a responsabilidade da transação permanece com o estabelecimento.

unenrolled

Este evento é acionado quando o cartão não é elegível para autenticação, ou seja, o portador e/ou o emissor não participam do programa de autenticação 3DS. Apenas a variável Eci será retornada. Recomenda-se orientar o comprador a verificar com o emissor se o cartão está habilitado para autenticação em e-commerce. Caso a transação seja autorizada mesmo sem a autenticação, a responsabilidade permanece com o estabelecimento.

disabled

Este evento é acionado quando o estabelecimento opta por não submeter o portador ao processo de autenticação, configurando o parâmetro isEnabled como false. Neste caso, mesmo que a transação seja autorizada, a responsabilidade continua com o estabelecimento.


error

Este evento ocorre quando há um erro sistêmico no processo de autenticação. Caso a transação seja autorizada, a responsabilidade permanece com o estabelecimento.

unsupportedBrand

Este evento é acionado quando a bandeira do cartão utilizado não é compatível com o protocolo 3DS. Nesse caso, a autenticação não é realizada.


Exemplo de utilização

payzu3DS.on("ready", function (e) {
  
});

AtributoDescriçãoTipoObrigatório?
CavvDado que representa assinatura da autenticaçãostringSim
XidIdentificador da transação de autenticaçãostringNão
EciCódigo que representa o resultado da autenticaçãoTabela ECISim
VersionVersão do protocolo 3DS utilizadastringSim
ReferenceIdIdentificador da requisição de autenticaçãostringSim
ReturnCodeCódigo de retorno da autenticaçãoCódigo de retorno/MensagensSim
ReturnMessageMensagem de retorno da autenticaçãoCódigo de retorno/MensagensSim