Este manual descreve a integração da loja com a Clear Sale . Berviço brasileiro de análise antifraude. Quando a integração está ativa, cada pedido com cartão de crédito é enviado automaticamente à Clear Sale, que analisa o risco e devolve um veredito (aprovado, reprovado ou em análise manual) que pode ser usado para autorizar ou cancelar a cobrança. Saiba mais sobre a Clear Sales visite o site oficial.

1. Para que serve

A Clear Sale ajuda a reduzir prejuízos com chargeback e fraude analisando cada pedido. O fluxo simplificado é:

A loja pode bloquear o checkout ou cancelar a cobrança automaticamente conforme o veredito.

2. Os dois planos disponíveis

A integração da Flexy com a Clear Sale oferece dois planos:

Você pode habilitar um ou os dois simultaneamente, conforme o contrato com a Clear Sale.

3. Pré-requisitos

Antes de configurar no painel, você precisa:

1. Contratar a Clear Sale diretamente com a empresa (suporte: support@clearsale.zendesk.com).
2. Decidir se vai usar Realtime Decision, Total Garantido ou ambos.
3. Para Total Garantido, ter um gateway de pagamento integrado: REDE ou Safe2Pay.
4. Receber as credenciais da Clear Sale em homologaçã:
   • Id do App (App ID).
   • Usuário.
   • Senha.

4. Como ativar

Passo 1: Acessar a tela de configuração

• Acesse o menu lateral e vá em: Configurações → Antifraude

A tela exibe dois painéis expansíveis, um para cada plano (ClearSale Realtime Decision e Total Garantido ClearSale).

Passo 2: Expandir o painel do plano desejado

Clique no painel para abrir os campos de configuração.

Passo 3: Marcar "Habilitado"

Marque a caixa "Habilitado" para ativar o plano.

Passo 4: Preencher as credenciais

Insira os dados que você recebeu da Clear Sale:

• Id do App.
• Usuário.
• Senha.

Passo 5: Escolher o ambiente

Selecione no campo Ambiente:

• Homologação: para testar a integração antes de ir ao ar (não envia dados de pedidos reais).
• Produção: para uso real, com pedidos reais.

❗Boa prática: comece sempre em Homologação. Faça pedidos de teste, valide o fluxo, e só depois mude para Produção.

❗Segurança das credenciais

• Nunca compartilhe o Id do App, Usuário e Senha da Clear Sale por canais públicos (chat aberto, e-mail sem proteção).
• Quem precisa do acesso ao painel deve ter sua própria conta no sistema com perfil adequado, não a senha da Clear Sale.

Passo 6: Configurações específicas de cada plano

Realtime Decision

• Permitir cobranças por suspeita de fraude (checkbox), controla o que acontece quando a Clear Sale reprova o pedido:
  • Marcado: o pedido segue mesmo reprovado (você decide depois manualmente).
  • Desmarcado: o checkout é bloqueado se a Clear Sale reprovar, o pedido vai para "Pagamento Recusado".

Total Garantido

• Dias para cancelamento automático, número de dias entre a reprovação e o cancelamento automático da cobrança. Opções: 0 a 7 dias.
  • 0 = cancelamento imediato após reprovação.
  • 1 a 7 = aguarda esse número de dias antes de cancelar (dá margem para revisão manual).
• URL de callback, preenchido automaticamente pelo sistema. É o endereço onde a Clear Sale envia atualizações de status. Não altere.

Passo 7: Salvar

Clique em Salvar. Mensagem de confirmação: "Configurações de Antifraude salvas com sucesso"

5. Como funciona em cada pedido novo

Com Realtime Decision ativo

1. Cliente finaliza checkout com cartão de crédito (ou boleto/boleto a faturar).
2. Pedido é criado com status Aberto.
3. Sistema envia automaticamente os dados do pedido para a Clear Sale.
4. Em segundos, a Clear Sale devolve um veredito com score e status.
5. Conforme o veredito e a configuração de "Permitir cobranças por suspeita de fraude":
   • Pedido aprovado → cobrança prossegue.
   • Pedido reprovado:
     • Se "permitir cobranças" estiver marcado: o pedido fica registrado, com a marcação de reprovação, mas sem bloqueio automático.
     • Se estiver desmarcado: status do pedido vira Pagamento Recusado e o cliente recebe a recusa.

Com Total Garantido ativo

1. Cliente finaliza checkout
2. Pedido é criado normalmente, com a cobrança autorizada.
3. Sistema envia os dados à Clear Sale.
4. A Clear Sale analisa (pode levar de minutos a algumas horas, com etapa manual quando necessário).
5. O sistema verifica o status periodicamente e:
   • Se aprovado → captura o pagamento (efetiva a cobrança).
   • Se reprovado → aguarda o delay configurado (0 a 7 dias) e cancela a cobrança automaticamente na REDE/Safe2Pay.
   • Se em análise manual → continua aguardando até definição.

❗Importante: em pedidos com outras formas de pagamento (PIX, boleto comum, gateways diferentes de REDE/Safe2Pay), o Total Garantido é ignorado. Só vale para REDE e Safe2Pay com cartão de crédito.

6. Onde ver o veredito de cada pedido

Pedidos → Listagem → abrir pedido

Na ficha do pedido, depois dos dados de pagamento, há a seção Análise Antifraude com:

No detalhe do pedido, também terá uma notificação ( basta clicar no ícone ):

Cores visuais

• Verde: pedido aprovado.
• Vermelho: pedido reprovado.
• Amarelo: análise manual em andamento.

8. Cancelamento automático (Total Garantido)

Como funciona quando um pedido é reprovado pela Clear Sale com Total Garantido ativo:

1. A Clear Sale devolve o veredito de reprovação.
2. O sistema registra a data/hora da reprovação no pedido.
3. Diariamente, uma rotina automática verifica todos os pedidos reprovados.
4. Quando o tempo desde a reprovação atinge o "Dias para cancelamento automático" configurado, o sistema:
   • Cancela a cobrança no gateway (REDE ou Safe2Pay).
   • Marca o pedido como Cancelado.
5. O cliente vê o pedido cancelado na conta dele e (se houver fluxo de e-mail) recebe a notificação de cancelamento.

Dica: comece com delay de 1 ou 2 dias. Isso dá margem para sua equipe revisar manualmente antes do cancelamento automático em casos limítrofes.

9. Configuração por loja (multi-loja)

A integração suporta multi-loja: cada loja tem sua configuração independente de antifraude. Isso é útil quando:

• Diferentes lojas têm diferentes políticas de risco.
• Você quer testar a integração em uma loja antes de aplicar nas outras.

Para configurar, acesse Configurações → Antifraude com o usuário da loja específica ou troque a loja ativa no painel.

12. Melhores práticas

Antes de ativar em Produção

• Faça testes em Homologação com pedidos reais (uma compra interna, por exemplo) para validar o fluxo.
• Teste cenários de aprovação e reprovação combinando com a Clear Sale para que eles forcem retornos de teste.
• Confirme que sua equipe sabe identificar um pedido reprovado por antifraude no painel.

Operação diária

• Acompanhe a tela de pedidos com filtro pelos status "Pagamento Recusado" e investigue os reprovados.
• Para o Total Garantido, use o delay de cancelamento como margem de revisão. Pedidos suspeitos podem ter contato com o cliente antes do cancelamento automático bater.
• Quando a Clear Sale reprovar um cliente fiel ou um pedido obviamente legítimo, acione o suporte da Clear Sale para revisão. Score baixo nem sempre é fraude.

Combinação com outros antifraudes

• O sistema também integra com sistemas antifraude nativos do gateway (REDE, MyGateway, Braspag). Eles podem rodar junto com a Clear Sale.
• Mais camadas = mais segurança, mas também mais chances de falsos positivos. Calibre conforme o histórico da loja.

13. Perguntas frequentes

O cliente vê que foi reprovado pela Clear Sale? Não. O cliente vê apenas que o pagamento foi recusado. A Clear Sale é uma camada interna de avaliação.

Posso desabilitar a Clear Sale temporariamente sem perder a configuração? Sim. Basta desmarcar "Habilitado" e salvar. As credenciais ficam guardadas e você reativa quando quiser.

O que acontece com pedidos que estão em análise quando eu desativo o serviço? Análises em andamento podem não ser concluídas. Antes de desabilitar, aguarde a conclusão dos pedidos pendentes ou contate o suporte para orientações.

Posso usar Realtime Decision e Total Garantido ao mesmo tempo? Sim, desde que sua contratação com a Clear Sale inclua os dois. Habilite ambos na tela de Antifraude.

E se a Clear Sale ficar fora do ar? Em caso de falha de comunicação, o pedido segue o fluxo normal (sem análise). Verifique periodicamente os logs de pedidos para identificar lapsos.

Por que um pedido legítimo foi reprovado? A análise é estatística. CPF com pouco histórico, mudança de endereço recente, dispositivos novos ou comportamento atípico podem gerar falsos positivos. Para revisão, contate a Clear Sale.

Posso configurar valor mínimo para análise? Não pela tela atual. Todos os pedidos com forma de pagamento aplicável (cartão de crédito, conforme o plano) são enviados para análise. Para análise por valor, fale com a Clear Sale para ajustes na regra de aprovação automática deles.

E quando o pedido é pago em PIX ou boleto?

• Realtime Decision analisa boletos e boletos a faturar.
• Total Garantido ignora. Só funciona com cartão via REDE ou Safe2Pay.
• PIX geralmente fica fora do escopo (pago à vista, sem chargeback).

O Total Garantido cobre TODAS as fraudes? Cobre conforme contrato com a Clear Sale, geralmente para chargeback de cartão de crédito após análise aprovada. Confirme as cláusulas específicas com seu gerente de conta.

Como sei se as credenciais que recebi estão corretas? Configure no ambiente Homologação, faça um pedido de teste e verifique no painel se a análise foi registrada. Se não aparecer, as credenciais ou a URL podem estar erradas — contate o suporte da Clear Sale.

Posso ver quantos pedidos foram aprovados/reprovados no mês? Não há relatório consolidado no painel. Para essa análise, exporte os pedidos do mês e cruze com os status de antifraude registrados, ou solicite à equipe técnica uma extração direta.

A Clear Sale altera o status do pedido sozinha? Sim, em Total Garantido. Quando a análise é concluída, o sistema atualiza automaticamente: aprovado → captura, reprovado → cancela após o delay. Em Realtime Decision, a alteração é instantânea no checkout (segue ou bloqueia).

O que acontece se o cliente cancelar o pedido antes da Clear Sale concluir? O pedido é cancelado normalmente. A análise da Clear Sale fica registrada, mas o cancelamento manual sobrepõe.

Como funciona o reenvio quando muda o status do pedido? A Clear Sale recebe a primeira análise no momento da criação do pedido. Mudanças posteriores no pedido não geram reanálise automática. Para reanalisar, a integração teria que ser refeita pela equipe técnica.

Esperamos que este material possa ter auxiliado no seu uso à plataforma Flexy, no entanto, caso ainda hajam dúvidas ou necessidades, por favor, entre em contato com nossa equipe de atendimento, que terá prazer em auxiliá-lo.