A ClearSale é uma solução de análise antifraude utilizada por diversos e-commerces para avaliar transações realizadas por cartão de crédito. Quando integrada à wBuy, ela trabalha em conjunto com o seu meio de pagamento para analisar cada compra antes da conclusão do processo.
Importante: a ClearSale não processa pagamentos. Ela apenas realiza a análise antifraude. O pagamento continua sendo processado pelo gateway contratado (veja lista abaixo).
Como funciona o fluxo da integração
Quando um cliente realiza uma compra utilizando cartão de crédito, três sistemas participam do processo:
- wBuy: gerencia o pedido da loja.
- Gateway de pagamento (veja lista abaixo): processa o pagamento.
- ClearSale: realiza a análise antifraude.
O fluxo ocorre da seguinte forma:
- O cliente finaliza o pedido na loja.
- A wBuy envia a transação para o gateway de pagamento configurado.
- O gateway processa o pagamento.
- Caso o gateway esteja configurado para utilizar a ClearSale como antifraude, o pedido é enviado para análise.
- Enquanto a análise estiver em andamento, a wBuy mantém o pedido com o status Em análise.
- Após finalizar a análise, a ClearSale envia o resultado para a wBuy.
A partir desse momento podem ocorrer dois cenários:
Pedido aprovado
Se a ClearSale aprovar a transação:
- o pedido continua seu fluxo normalmente;
- a wBuy atualiza o status do pedido;
- o lojista poderá seguir com faturamento e envio.
Pedido reprovado
Se a ClearSale reprovar a transação:
- a wBuy recebe a reprovação;
- solicita automaticamente ao gateway o cancelamento ou estorno da cobrança (quando suportado pela integração);
- o pedido permanece registrado na loja para consulta e histórico.
Importante: o cancelamento financeiro é realizado pelo gateway de pagamento. A wBuy apenas envia a solicitação conforme o retorno recebido da ClearSale.
Fluxo resumido
Antes de iniciar - ClearSale
Para utilizar a integração será necessário contratar a ClearSale.
Após a contratação, a ClearSale fornecerá:
- Usuário
- Senha
- App ID
- SLA (quando contratado)
- Ambiente de homologação (Sandbox), quando contratado
- Ambiente de Produção.
Além disso, será necessário cadastrar o webhook de retorno da wBuy na plataforma da ClearSale.
Como obter as credenciais
Após contratar a ClearSale:
- Aguarde o envio do formulário de credenciamento
- Preencha os dados solicitados
- Após aprovação, a ClearSale enviará por e-mail:Usuário
- Senha
- App ID
- Caso não receba os dados, entre em contato com o suporte da ClearSale
Configurando a integração na wBuy
No painel da wBuy acesse: Aplicativos > ClearSale e clique em Instalar.
Ative o Status da loja, informe as credenciais, preencha:
- Usuário
- Senha
- App ID (Fingerprint)
- Caso contratado junto à ClearSale, informe também o SLA.
A integração possui dois ambientes:
- Sandbox: Utilizado para homologação e testes.
- Produção: Utilizado para vendas reais.
Recomendamos utilizar Produção somente após validar toda a integração em ambiente de testes.
Por fim no campo de "Endereço de su aloja física cadastrada na CleaSale" informe exatamente os dados do seu cadastro na ClearSale
Agora basta clicar em Gravar
Configure o webhook
Na tela de configuração da integração será exibida uma URL de retorno (Webhook). Copie essa URL e cadastre-a na plataforma da ClearSale.
Importante: É através desse endereço que a ClearSale informará à wBuy o resultado das análises.
Como acompanhar a análise
Durante a análise antifraude, o pedido permanecerá com o status Em análise.
Esse status indica apenas que a wBuy está aguardando o retorno da ClearSale.
Após a conclusão da análise, o pedido será atualizado automaticamente conforme o resultado recebido.
Meios de pagamento compatíveis
A integração da ClearSale pode ser utilizada com os seguintes gateways de pagamento:
- Assas
- Cielo API
- Divibank
- e-Rede
- Getnet
- Pagar.me
- SafraPay
Todos eles pemitem o fluxo para uso de antifraude.
Importante
- A ClearSale não altera pedidos diretamente na wBuy. Ela envia o resultado da análise para que a plataforma processe o fluxo automaticamente.
- A wBuy depende do retorno enviado pela ClearSale e do processamento realizado pelo gateway de pagamento.
- Em situações em que o gateway retornar erro ao processar um cancelamento ou estorno, a análise deverá ser realizada junto ao suporte do próprio gateway, pois a wBuy apenas encaminha a solicitação.
Responsabilidade de cada sistema
| Sistema | Responsabilidade |
| wBuy | Enviar o pedido ao gateway, receber os retornos da ClearSale e atualizar o pedido na loja. |
| Gateway de pagamento | Autorizar pagamentos, capturar valores, cancelar ou realizar estornos e enviar notificações financeiras. |
| ClearSale | Realizar exclusivamente a análise antifraude e informar se a compra foi aprovada ou reprovada. |
Dúvidas frequentes
Como saber se o pedido foi enviado e integrado na ClearSale?
Quando o pedido é integrado com sucesso é salvo nos detalhes extras do pedido um código de identificação como mostra na imagem de exemplo abaixo:
O pedido ficou "Em análise". Isso significa que o pagamento foi recusado?
Não. O status Em análise apenas indica que a compra está aguardando o retorno da análise antifraude da ClearSale. O pagamento pode já ter sido autorizado pelo gateway, mas a decisão final ainda depende da análise da ClearSale.
Quanto tempo a ClearSale leva para responder?
O tempo de análise varia conforme as políticas da ClearSale e o perfil da compra. Enquanto o retorno não for enviado, o pedido permanecerá com o status Em análise na wBuy.
Posso alterar manualmente o status do pedido?
Sim. Caso sua operação permita, o pedido poderá ser atualizado manualmente. Porém, recomendamos aguardar a conclusão da análise da ClearSale para evitar faturamento ou envio de pedidos posteriormente reprovados.
Quem altera o status do pedido?
A atualização ocorre automaticamente quando a wBuy recebe uma notificação da ClearSale ou do gateway de pagamento. Em alguns casos, alterações manuais realizadas diretamente no gateway também podem refletir na loja, dependendo da integração utilizada.
A ClearSale cancela o pagamento?
Não. A ClearSale apenas informa se a transação foi aprovada ou reprovada. O cancelamento, estorno ou captura do pagamento é responsabilidade do gateway de pagamento (Pagar.me, Cielo, Braspag, Getnet, etc.).
O que acontece se o gateway apresentar erro ao cancelar ou estornar um pagamento?
A wBuy envia a solicitação de cancelamento conforme o retorno da ClearSale. Caso o gateway retorne algum erro interno ou não conclua a operação, será necessário entrar em contato com o suporte do próprio gateway para verificar o motivo da falha.
Meu pedido foi aprovado pela ClearSale, mas continua com outro status na loja.
Nesse caso, verifique:
- se o gateway enviou corretamente as notificações (webhooks);
- se a integração está ativa;
- se não houve falha de comunicação entre os serviços.
Se necessário, entre em contato com o suporte da wBuy informando o número do pedido para análise dos logs.
Meu pedido foi reprovado. O valor será devolvido automaticamente?
Depende do gateway de pagamento.
Na maioria das integrações, a wBuy envia automaticamente a solicitação de estorno ao gateway após receber a reprovação da ClearSale. Entretanto, a efetivação do estorno depende exclusivamente do processamento realizado pelo gateway.
Posso utilizar a ClearSale com qualquer meio de pagamento?
Não. integração é compatível apenas com os gateways homologados pela wBuy, veja lista acima.
Como saber se houve erro na comunicação entre os sistemas?
A wBuy registra todas as comunicações realizadas com a ClearSale e com o gateway de pagamento em logs técnicos. Caso seja necessária uma investigação, nossa equipe poderá analisar esses registros para identificar em qual etapa ocorreu a inconsistência.