PayZu PaymentsSegurança e autenticação

Eventos de autenticação


Nesta páginaRegistre os eventosEventosAtributos retornados

Registre um tratador para cada evento do script de 3DS. O evento recebido define se a cobrança sai com ou sem externalAuthentication.

Registre os eventos

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

Cada evento tem um tratador só: um novo on para o mesmo evento troca o anterior. O nome do evento não diferencia maiúsculas de minúsculas.

Eventos

EventoQuando disparaO que fazer
readyO script terminou de carregar e de preparar a autenticação.Inicie a autenticação.
successO cartão é elegível e a autenticação foi concluída.Envie os atributos em externalAuthentication na cobrança. A responsabilidade por disputas de fraude passa ao emissor ou à bandeira.
failureO cartão é elegível, mas a autenticação falhou.Se for cobrar, a responsabilidade fica com o estabelecimento.
unenrolledO portador ou o emissor não participam do programa 3DS.Oriente o comprador a conferir com o emissor se o cartão está habilitado para compras online. Se for cobrar, a responsabilidade fica com o estabelecimento.
errorHouve um erro de sistema na autenticação.Se a cobrança for autorizada, a responsabilidade fica com o estabelecimento.
unsupportedBrandA bandeira do cartão não é compatível com o 3DS.A autenticação não acontece.

Em failure e unenrolled, crie a cobrança sem externalAuthentication.

Esses eventos não trazem uma autenticação concluída, e a API só aceita o objeto com cavv, eci, version e referenceId de uma autenticação.

Atributos retornados

ready não traz atributo. Os demais eventos trazem estes:

AtributoDescriçãoTipoQuando vem
CavvAssinatura da autenticação.stringEm success e, quando a autenticação chegou a ser feita, em failure, unenrolled e error.
XidIdentificador da transação de autenticação.stringSempre; null no error com MPI900, MPI901 ou MPI902.
EciResultado da autenticação.Tabela ECISempre; null no error com MPI900, MPI901 ou MPI902.
VersionVersão do protocolo 3DS.stringSempre, menos no error com MPI900, MPI901 ou MPI902.
ReferenceIdIdentificador da requisição de autenticação.stringSempre; null no error com MPI900, MPI901 ou MPI902.
ReturnCodeCódigo de retorno.Códigos de retorno 3DSSempre.
ReturnMessageMensagem de retorno.Códigos de retorno 3DSSempre.