A Konduto é 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 Konduto 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.
- Konduto: 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 Konduto 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 Konduto envia o resultado para a wBuy.
A partir desse momento podem ocorrer dois cenários:
Pedido aprovado
Se a Konduto 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 Konduto 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 Konduto.
Fluxo resumido
Antes de iniciar - Konduto
Para utilizar a integração será necessário contratar a Konduto.
Após a contratação, a Konduto fornecerá:
- Chave privada
- Chave pública
Além disso, será necessário cadastrar o webhook de retorno da wBuy na plataforma da Konduto. Solicite ajuda ao time da Konduto suporte para te ajudar.
Como obter as credenciais
Após contratar a Kobduto, solicite o registro das chaves diretamente com o time da Konduto.
Configurando a integração na wBuy
No painel da wBuy acesse: Aplicativos > Konduto e clique em Instalar.
Ative o Status da loja, informe as credenciais, preencha:
- Chave privada
- Chave pública
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 Konduto.
Importante: É através desse endereço que a Konduto 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 Konduto.
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 Konduto 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 Konduto 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. |
| Konduto | 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 Konduto?
Quando o pedido é integrado com sucesso é salvo nos detalhes extras do pedido com a resposta da Konduto se aprovado ou nã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 Konduto. O pagamento pode já ter sido autorizado pelo gateway, mas a decisão final ainda depende da análise da Konduto.
Quanto tempo a Konduto leva para responder?
O tempo de análise varia conforme as políticas da Konduto 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 Konduto cancela o pagamento?
Não. A Konduto 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 Konduto. 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 Konduto, 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 Konduto. Entretanto, a efetivação do estorno depende exclusivamente do processamento realizado pelo gateway.
Posso utilizar a Konduto 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 Konduto 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.