Skip to main content
Os provedores antifraude síncronos na Malga podem ser configurados para serem executados antes ou depois das transações através da opção runBeforeCharge. Para runBeforeCharge=false, o ciclo de vida de uma transação com avaliação antifraude percorre três etapas:
  1. Pré Autorização
  2. Análise Antifraude
  3. Captura
Para garantir que a venda não será perdida e que está apta a ser processada pelo antifraude, o pagamento é pré-autorizado e, em seguida, é feita uma verificação no provedor de risco. Por padrão, caso a análise seja aprovada, o pagamento é capturado. Caso contrário, ela é estornada automaticamente. Fluxo Antifraude
O comportamento automatizado do ciclo de vida da transação pode ser escolhido utilizando as configurações de captureOnApproved e refundOnReproved feitas diretamente no setup de provedor de antifraude para uso na Malga.
Para runBeforeCharge=true, o ciclo de vida de uma transação com avaliação antifraude percorre duas etapas:
  1. Análise Antifraude
  2. Captura
Fluxo Antifraude Com esta configuração, todas as transações serão avaliadas pelo antifraude antes de serem processadas nos provedores de cobrança.

​
Quais opções valem em cada arranjo

O capture que você envia na cobrança define quais opções do provedor antifraude chegam a ser consideradas. É a fonte mais comum de confusão, porque a intuição costuma ser a oposta do comportamento real.
Com capture: true e antifraude configurado, a Malga pré-autoriza a cobrança e captura sozinha quando o antifraude aprova, sem que você chame o serviço de captura. Esse comportamento vale para cartão de crédito, inclusive Click to Pay, em merchants sem fluxo de pagamentos. Não vale para 3DS com setupId nem para MPI externo.Durante a análise, a cobrança aparece como pre_authorized com capture: false. Depois da captura, ela passa a authorized com capture: true, e os webhooks seguem o status.O recurso está em liberação gradual. Enquanto a sua conta não for liberada, a API responde 400 com a mensagem “The capture cannot be true in this operation”. Fale com o suporte para habilitar. Se você quer que o resultado do antifraude decida os dois lados sem depender dessa liberação, envie capture: false.
O prazo para o antifraude aprovar e a cobrança ser capturada é de 72 horas, contadas da criação. Uma aprovação que chega depois do prazo não captura. Uma pré-autorização que continua sem veredito após as 72 horas é cancelada automaticamente. Reprovação e erro do antifraude seguem as opções do provedor, como em qualquer outra cobrança. No sandbox, a simulação do veredito segue a mesma regra, mas o cancelamento automático em 72 horas não existe.

​
Exemplos de uso do antifraude

Para utilizar análises antifraude em suas transações basta estar credenciado em um provedor antifraude e configurá-lo em seu fluxo de pagamentos. Assim, será possível processar uma transação enviando as informações adicionais de antifraude.

​
Exemplo de cobrança com Antifraude aprovado

Os exemplos abaixo usam a URL de produção (https://api.malga.io). Para testar no sandbox, use https://sandbox-api.malga.io com suas credenciais de sandbox. As cobranças de sandbox aparecem no ambiente de testes do Dashboard. Veja Ambientes.
Após a pré autorização, se a cobrança passar pela avaliação de risco, é aprovada e capturada na sequência.

​
Exemplo de cobrança com Antifraude reprovado

Após a pré autorização, se a análise de risco for reprovada, a transação é rejeitada e a pré autorização é cancelada automaticamente.
Sempre que a transação for reprovada no antifraude, por padrão faremos o cancelamento da pré autorização automaticamente. Caso a tentativa de cancelamento falhe, a transação manterá o status pre_authorized e poderá ser cancelada ou capturada manualmente, de acordo com a sua preferência.

​
Exemplo de cobrança com erro ao acessar Antifraude

Em cobranças com capture: false, caso um erro ocorra no provedor antifraude e nenhuma das opções de erro esteja habilitada, a transação é retornada ainda pré-autorizada. Em cobranças com capture: true e antifraude, a pré-autorização também existe até o veredito, e o desfecho segue captureOnError ou refundOnError.
Caso ocorra alguma instabilidade com o provedor antifraude, existem duas opções para lidar com este cenário que devem ser configuradas em seu fluxo de pagamentos: - captureOnError: Faz a captura mesmo que ocorra instabilidade no provedor de antifraude. - refundOnError: Faz o estorno da transação em caso de instabilidade no provedor de antifraude. Não pode ser ligada ao mesmo tempo que captureOnError. Em cobranças com capture: false, quando captureOnError e refundOnError estão desligadas, a transação é retornada como pre_authorized. Em cobranças com capture: true e antifraude, a transação segue pré-autorizada até o veredito e, sem veredito em 72 horas, é cancelada automaticamente.