Page History

Indice

Configuração e funcionamento

Este guia apresenta as opções de proteção contra fraudes disponíveis no MaxPag, explica como configurá-las e mostra o que acontece durante o pagamento por cartão de crédito.

1. Objetivo e benefícios

O antifraude ajuda a reduzir o risco de compras realizadas com cartões roubados ou clonados em pagamentos por link. Ele analisa informações da compra ou solicita ao banco emissor que confirme a identidade de quem está realizando o pagamento.

Ao utilizar esses recursos, sua empresa pode:

• Reduzir o risco de prejuízos com compras fraudulentas e contestações de pagamento (chargebacks).
• Identificar transações suspeitas antes da conclusão do processo de venda, conforme a solução utilizada.
• Adicionar uma etapa de confirmação pelo banco emissor do cartão, quando disponível.
• Combinar mecanismos de proteção para ampliar a segurança das vendas realizadas por link.

Importante: nenhum mecanismo elimina totalmente o risco de fraude. Uma análise também pode bloquear uma compra legítima. Além disso, a proteção descrita neste guia se aplica a pagamentos com cartão de crédito; Pix, boleto, débito, Marvin e Tino não passam por essas validações.

2. Conheça as opções disponíveis

ClearSale, Konduto e GetNet são opções exclusivas entre si no campo “Antifraude” da filial: selecione apenas uma delas. O 3DS da Cielo é ativado separadamente e pode ser utilizado junto com ClearSale ou Konduto. O FraudDetect é configurado diretamente no gateway Software Express.

3. Antes de configurar

• O usuário que realizará a configuração precisa ter a permissão “Antifraudes”.
• As credenciais de acesso devem ser solicitadas diretamente à empresa responsável pela solução escolhida.
• O cadastro das configurações de antifraude é feito por cliente, e não por filial. As filiais do cliente utilizam as mesmas credenciais cadastradas.
• Existe uma configuração de cada tipo de antifraude por cliente. Se precisar alterar uma configuração, edite a existente.
• Uma configuração cadastrada não pode ser excluída. Para deixar de utilizá-la, altere seu status para Inativo.

4. Configurar ClearSale, Konduto ou GetNet

4.1 Cadastrar a solução

1. Acesse Configurações > Antifraudes.
2. Clique em “Adicionar configuração”. Para alterar um cadastro existente, utilize a opção de edição.
3. Mantenha a configuração como Ativa.
4. No campo “Antifraude”, selecione ClearSale, Konduto ou GetNet. Após salvar, não será possível alterar o tipo escolhido.
5. Preencha as credenciais solicitadas para a solução selecionada. Para GetNet, não são informadas credenciais próprias nessa tela; são utilizadas as credenciais do gateway Getnet cadastrado na filial.
6. Confira os campos solicitados ao comprador e a opção “Ocultar campos opcionais”, quando disponível.
7. Clique em “Salvar” ou “Salvar e sair”.

Na ClearSale, informe usuário, senha, AppKey Fingerprint e ambiente (Homologação ou Produção). Se o ambiente não for selecionado, o cadastro será salvo como Homologação. Sem a AppKey Fingerprint, a análise não contará com os dados de identificação do aparelho.

Na Konduto, informe a Api Key fornecida pela empresa. O ambiente de teste ou produção é definido pela própria chave utilizada.

Na GetNet, o serviço antifraude precisa estar habilitado na conta do estabelecimento. Consulte a Getnet para confirmar a habilitação.

4.2 Definir os dados solicitados no checkout

A tabela de campos define quais informações serão apresentadas ao comprador na etapa “Dados pessoais”. Os campos exigidos pela solução antifraude já vêm marcados e não podem ser desmarcados. Quando permitido, sua empresa pode tornar obrigatório um campo que esteja como opcional.

A opção “Ocultar campos opcionais na tela de captura” faz com que o checkout apresente somente os campos obrigatórios. Ao ativá-la, os dados opcionais não são enviados para a análise, mesmo que tenham sido preenchidos anteriormente pelo ERP. A ausência dessas informações pode reduzir a precisão da análise.

Na GetNet, são exigidos nome, e-mail, tipo e número do documento, telefone, endereço de cobrança completo e endereço de entrega completo. Esses dados são necessários mesmo quando a opção de ocultar campos opcionais estiver marcada.

4.3 Ativar o antifraude na filial

1. Acesse Configurações > Filiais e edite a filial desejada.
2. Abra a aba “Gateways”.
3. No campo “Antifraude”, selecione a solução que foi cadastrada e está ativa.
4. Clique em “Salvar”.

A opção selecionada será aplicada aos pagamentos com cartão de crédito processados pela filial. No caso da GetNet, a proteção será aplicada somente quando o pagamento for processado pelo gateway Getnet.

Se a configuração não estiver cadastrada ou estiver inativa, a filial não poderá ser salva com essa opção selecionada. Nesse caso, ative ou cadastre a configuração, ou selecione “Nenhum”.

5. Como funciona o pagamento com ClearSale e Konduto

Nessas duas soluções, a análise acontece depois que a adquirente autoriza o cartão. O fluxo é:

1. O comprador acessa o link de pagamento e informa os dados do cartão.
2. O MaxPag envia os dados do cartão para a adquirente.
3. Quando o cartão é autorizado, o checkout apresenta a etapa “Dados pessoais” para o comprador.
4. O comprador confirma os dados solicitados, que são enviados à ClearSale ou à Konduto.
5. A solução antifraude analisa a transação e retorna um resultado.

Atenção: quando a captura do cartão é automática, o valor pode ser cobrado antes da análise antifraude. Se a compra for recusada, o MaxPag solicitará o estorno. O prazo para o valor aparecer novamente na fatura depende do banco do comprador. Com a captura manual (pré-autorização), o valor fica reservado no limite e a captura pode ser realizada após a aprovação.

6. Como funciona o pagamento com GetNet

A GetNet analisa os dados do cartão e do comprador no mesmo momento em que recebe a solicitação de autorização. Não existe uma etapa separada de análise manual no MaxPag.

1. O comprador informa os dados do cartão e confirma.
2. O checkout apresenta a etapa “Dados pessoais”.
3. Após a confirmação dos dados, as informações são enviadas junto com a solicitação de autorização à Getnet.
4. Se a Getnet aprovar, o pagamento ficará como “Autorizado” ou “Pré-autorizado”. Se recusar, poderá aparecer como “Não autorizado” ou “Com falha”.

Para que a proteção seja aplicada, o gateway Getnet precisa estar ativo e ser o primeiro gateway de cartão de crédito da filial, ou seja, ter a menor prioridade entre os gateways ativos desse tipo e ambiente. Se o pagamento for processado por outro gateway, ele seguirá sem a análise antifraude da Getnet.

7. FraudDetect da Software Express

O FraudDetect é a solução antifraude da Software Express. Sua configuração não é realizada no menu “Antifraudes”.

1. Acesse a configuração do gateway Software Express da filial.
2. No campo “Antifraude”, selecione “FraudDetect”.
3. Confirme que o gateway utiliza o checkout próprio da Software Express.

A análise acontece dentro do checkout da Software Express, antes da autorização do pagamento. O resultado é tratado pela própria Software Express.

8. Autenticação 3DS da Cielo

8.1 O que é o 3DS

O 3DS é um mecanismo de autenticação que permite ao banco emissor confirmar se a pessoa que está realizando o pagamento é a titular do cartão. Dependendo da avaliação do banco, a confirmação pode acontecer automaticamente ou exigir uma ação do comprador, como informar um código ou aprovar a compra no aplicativo bancário.

Quando a autenticação é concluída, o MaxPag envia o pagamento à Cielo com a informação de que o titular foi autenticado. Se o banco não autenticar o cartão, o pagamento não segue para cobrança.

O 3DS não garante que a compra será aprovada: mesmo após a autenticação, o banco pode negar a transação por outros motivos, como limite insuficiente. A proteção também não cobre contestações comerciais, como produto não entregue ou diferente do anunciado.

8.2 Requisitos

• A funcionalidade está disponível para pagamentos com cartão de crédito processados pelo gateway Cielo.
• A Cielo precisa ser o primeiro gateway de cartão de crédito da filial, considerando a menor prioridade entre os gateways ativos no mesmo ambiente.
• As bandeiras aceitas são Visa, Mastercard e Elo. Cartões American Express não são aceitos com o 3DS ativado.
• As credenciais de 3DS são fornecidas pela Cielo e são diferentes das credenciais habituais do gateway.

8.3 Configurar o 3DS

Antes de começar, solicite à Cielo as credenciais específicas do 3DS: Client ID, Client Secret, EC (código do estabelecimento, com 10 dígitos) e MCC (código de categoria do estabelecimento, com 4 dígitos).

Etapa 1 – Cadastrar as credenciais

1. Acesse Configurações > Antifraudes e clique em “Adicionar configuração”.
2. Mantenha a configuração como Ativa e selecione “3DS - Cielo” no campo “Antifraude”.
3. Preencha Client ID, Client Secret, EC e MCC.
4. Clique em “Salvar”.

Etapa 2 – Ativar no gateway Cielo

1. Acesse Configurações > Filiais e edite a filial.
2. Abra a aba “Gateways” e localize o gateway cuja adquirente é Cielo.
3. Marque a opção “Usar 3DS”.
4. Clique em “Salvar”.

Etapa 3 – Testar

1. Gere um link de pagamento para a filial configurada e abra o link.
2. Selecione cartão de crédito.
3. Verifique se o bloco “Dados de cobrança” aparece abaixo dos dados do cartão.

Se o bloco não aparecer, confira se a configuração 3DS está ativa, se o gateway Cielo está ativo no ambiente correto, se possui a menor prioridade entre os gateways de cartão e se a opção “Usar 3DS” está marcada. Depois de alterar a configuração, atualize a página do link.

8.4 O que o comprador verá

Na etapa de pagamento, será apresentado o bloco “Dados de cobrança”, com informações utilizadas pelo banco emissor para confirmar a titularidade do cartão.

Os campos obrigatórios são e-mail, celular com DDD, CEP, UF, cidade, rua e número. Bairro e complemento são opcionais. Quando o banco solicitar uma confirmação adicional, será exibida uma janela do próprio banco com as instruções para concluir a autenticação.

Se a autenticação não for concluída, o comprador verá uma mensagem informando o motivo e poderá tentar novamente ou utilizar outro cartão, conforme a situação apresentada.

9. Acompanhar os pagamentos

Para acompanhar o andamento de um pagamento, acesse Transações e consulte o status apresentado. Os nomes podem variar caso sua empresa tenha personalizado os status em Configurações > Status de pagamento.

Para consultar os detalhes, abra o pagamento e verifique o “Histórico de movimentações”. Ele apresenta as etapas pelas quais a transação passou, com data e hora. O campo “Gateway utilizado” informa qual gateway processou o pagamento.

Pagamentos em análise manual podem levar algum tempo até receber uma decisão. Ao abrir os detalhes do pagamento, o MaxPag realiza uma nova consulta à solução antifraude. A atualização também pode ocorrer quando a solução envia a notificação de resultado ou quando há uma consulta pela integração.

10. Boas práticas

• Mantenha atualizadas as credenciais fornecidas pela empresa antifraude.
• Confira se o ambiente selecionado corresponde ao uso desejado: Homologação para testes e Produção para operações reais.
• Sempre que possível, envie os dados do comprador pela integração do ERP. Isso reduz o preenchimento manual e pode contribuir para uma análise mais completa.
• Avalie com cuidado a opção “Ocultar campos opcionais”, pois ela reduz a quantidade de informações encaminhadas para análise.
• Acompanhe os pagamentos que permanecerem nos status relacionados ao antifraude, especialmente “Aguardando dados Antifraude”, “Aguardando análise manual do antifraude” e “Cancelamento pelo antifraude com erro”.
• Antes de alterar ou inativar uma configuração, verifique se existem pagamentos em andamento.
• Para ClearSale e Konduto, avalie com a empresa antifraude o cadastro do endereço de notificação do MaxPag, para que as decisões de análise manual sejam comunicadas à plataforma.
• Para GetNet, mantenha o gateway Getnet ativo e com a menor prioridade entre os gateways de cartão de crédito.
• Para 3DS, teste a configuração em Homologação antes de ativá-la em Produção.

11. Dúvidas frequentes

12. Glossário

Em caso de dúvidas sobre credenciais, habilitação do serviço ou resultado de uma análise, consulte a empresa responsável pela solução antifraude ou entre em contato com o suporte da Máxima.