Bem-vindo à documentação pagar.me

Aqui você vai encontrar guias e exemplos para te ajudar
a integrar com a melhor API de Pagamentos do Brasil!

Começar

Você também pode buscar ou navegar pelas categorias

Revisão Manual Beta

Existe a possibilidade de ocorrerem falsos positivos nas análises automáticas do antifraude. Ou seja, é possível que o antifraude recuse transações autênticas. Todas as transações que forem classificadas com os níveis de risco alto pelo Score Pagar.me poderão passar por uma revisão manual do seu lado.

Revisão Manual

Para ajudar a minimizar as chances de que falsos positivos ocorram, todas as transações que forem classificadas com os níveis de risco alto e muito alto pelo Score Pagar.me poderão passar por uma revisão manual do seu lado.
Você terá até 48 horas a partir da criação da transação para decidir a ação que deseja tomar: aprová-la ou recusá-la. Passado esse período, a transação seguirá o fluxo como negada.

Novo status

Transações com os níveis de risco alto serão identificadas pelo novo status revisão pendente logo após a análise do antifraude. Esse novo status significa que o pedido ainda não foi confirmado. Portanto, você não deve entregar o produto ao comprador até que a revisão manual seja efetuada.

Na API, esse novo status é traduzido para pending_review.

Transação de risco alto com revisão manual pendente

Transação de risco alto com revisão manual pendente

Como tratar esse status

Para que o comprador tenha uma experiência agradável, é interessante que ele receba uma notificação avisando que o pedido está sendo analisado. Na ausência desta, o comprador pode acabar realizando pedidos duplicados ou até mesmo cancelando o pedido original.

Revisando uma transação

Atenção!

Nós recomendamos que você apenas aprove uma transação se estiver seguro sobre a procedência da compra: por exemplo, se você conhece o cliente ou sabe com certeza que se tratou de um falso negativo. Como essas transações foram recusadas na análise automática do antifraude, a responsabilidade por aprová-las manualmente é da sua operação.

Via dashboard

  1. Entre na sua dashboard através do link beta.dashboard.pagar.me
  2. Acesse a página de transações
  3. Você verá uma notificação no topo da página caso exista alguma transação com revisão manual pendente. Clique em visualizar transações para filtrá-las.
Aviso de transações para serem revisadas

Aviso de transações para serem revisadas

  1. Selecione a transação que deseja revisar.
  2. Na página de detalhes, analise as informações da compra e entre em contato com o comprador caso necessário.
  3. No topo da página, clique no botão correspondente a sua decisão: recusar ou aprovar.
  4. Digite sua senha e confirme a ação.

Via API

Para revisar uma transação pela API, você deve criar uma análise de fraude. Para isso, faça uma requisição POST para a rota /transactions/:id/antifraud_analyses com o status desejado:

  • Para aprovar: approved
  • Para recusar: refused

Além disso, lembre-se de incluir sua chave de API.

Exemplo:

curl -X POST https://api.pagar.me/1/transactions/123/antifraud_analyses -d '{
  "api_key": "ak_live_...",
  "status": "approved"
}'

Como tratar o resultado da revisão

Após a transação ser aprovada ou recusada, nós notificamos a sua integração sobre o status final da transação. Assim, você pode, por exemplo, automatizar o envio de um e-mail de confirmação ao comprador. Lembre-se sempre de enviar uma URL de postback ao criar uma transação.
Para saber mais, acesse docs.pagar.me/docs/overview-postback-url.

Expiração do período para revisão manual

As transações poderão ser revisadas por até 48 horas a partir do momento de sua criação. Após esse período, elas serão automaticamente negadas pelo nosso sistema.

Desativando a revisão manual

Caso queira desativar a ferramenta, entre em contato com o nosso relacionamento.

Ambiente de testes

Se você quiser saber como a ferramenta aparecerá em sua dashboard e simular uma revisão, basta criar transações utilizando valores de documentos (CPF) específicos em ambiente de teste pela própria dashboard ou via API.

Os documentos dessas transações fictícias serão usados para incluí-las em diferentes níveis de risco, da seguinte forma:

55555555555 = muito baixo
44444444444 = baixo
33333333333 = moderado
22222222222 = alto
11111111111 = muito alto

Assim, todas as transações que tiverem valores de documento 22222222222 irão para revisão manual.

Bloqueio de antecipação

Transações que forem revisadas manualmente pela dashboard terão sua antecipação bloqueadas por um período de 30 dias. Após esse período elas entrarão no fluxo normal de recebíveis.

Perguntas frequentes

Como eu vou saber que existem transações com revisão pendente?
Ao abrir a sua dashboard, um aviso será mostrado na parte de cima da tela com a quantidade de transações que estão na lista para revisão manual.

Existe notificação por e-mail para revisões pendentes?
Não. É necessário abrir a dashboard para ter acesso a essa informação.

É preciso fazer a captura manual de transações que foram aprovadas manualmente por mim?
Não. O fluxo da transação segue de forma normal após a aprovação.

Por que eu preciso abrir os detalhes de uma transação para fazer a revisão manual pela dashboard?
Acreditamos que é necessário fazer uma avaliação cautelosa dos dados da transação antes de aprová-la para manter seu índice de chargeback por fraude saudável.

Como saber quanto tempo ainda tenho para recusar ou aprovar uma transação?
As transações ficam 48 horas na fila de espera para serem recusadas ou aprovadas. Após esse período, elas são automaticamente negadas pelo nosso sistema. Para saber até quando você pode fazer a revisar uma venda, veja a data e a hora de criação da transação e adicione 48 horas.

Utilizo uma plataforma no meu e-commerce. Posso usar a ferramenta?
As plataformas que conseguem tratar o status de revisão pendente são:

  • Magento
  • Novaoito
  • OpenCart
  • PrestaShop
  • Showare
  • VTEX
  • WooCommerce
  • Braavo

É necessário utilizar a versão mais recente da integração de cada plataforma.

Posso revisar uma transação que tenha sido criada há mais de 48 horas?
Não. Prezando pela boa experiência do comprador ao longo de sua jornada de compra, acreditamos que esse tempo seja suficiente para manter uma transação pendente de revisão manual.

Eu posso desabilitar a revisão manual caso não queira a ferramenta na operação do meu negócio?
Sim. Basta entrar em contato com o nosso relacionamento.

O que acontece se eu desabilitar a ferramenta?
Se houver transações com o status pending_review no momento em que você desabilitar a ferramenta, elas serão automaticamente negadas.
Após a desativação, novas transações com risco alto e muito alto não mais receberão o status revisão pendente e simplesmente serão negadas, já que foram recusadas na análise automática do antifraude.

Vou poder reprocessar transações com o antifraude desligado através do Relacionamento?
Não. O reprocessamento de uma transação gera uma experiência negativa de compra para o comprador.
Caso a revisão manual não satisfaça as necessidades do seu negócio, entre em contato conosco para que possamos entender qual a melhor forma de ajudá-lo.