PayZu PaymentsSegurança e autenticação
Eventos de autenticação
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
| Evento | Quando dispara | O que fazer |
|---|---|---|
ready | O script terminou de carregar e de preparar a autenticação. | Inicie a autenticação. |
success | O 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. |
failure | O cartão é elegível, mas a autenticação falhou. | Se for cobrar, a responsabilidade fica com o estabelecimento. |
unenrolled | O 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. |
error | Houve um erro de sistema na autenticação. | Se a cobrança for autorizada, a responsabilidade fica com o estabelecimento. |
unsupportedBrand | A 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:
| Atributo | Descrição | Tipo | Quando vem |
|---|---|---|---|
Cavv | Assinatura da autenticação. | string | Em success e, quando a autenticação chegou a ser feita, em failure, unenrolled e error. |
Xid | Identificador da transação de autenticação. | string | Sempre; null no error com MPI900, MPI901 ou MPI902. |
Eci | Resultado da autenticação. | Tabela ECI | Sempre; null no error com MPI900, MPI901 ou MPI902. |
Version | Versão do protocolo 3DS. | string | Sempre, menos no error com MPI900, MPI901 ou MPI902. |
ReferenceId | Identificador da requisição de autenticação. | string | Sempre; null no error com MPI900, MPI901 ou MPI902. |
ReturnCode | Código de retorno. | Códigos de retorno 3DS | Sempre. |
ReturnMessage | Mensagem de retorno. | Códigos de retorno 3DS | Sempre. |