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

Ciclo de vida das transações no Pagar.me

Depois de criada, uma transação (ou seja, uma compra feita no seu site ou app) pode ter vários status aqui no Pagar.me, e entender cada um deles é essencial para ter mais controle no dia a dia da sua operação.

  1. Compras feitas no Cartão de crédito
  2. Compras feitas por Boleto bancário

Compras feitas no Cartão de crédito

Não existe um ciclo de vida único, já que nem todas as transações passam por todos esses status, mas no geral uma compra de cartão segue um fluxo parecido com este:

Veja uma explicação de cada status para entender melhor esse fluxo.

  • [Processando] A transação foi criada e recebida pelo Pagar.me, e está sendo processada na cadeia de pagamentos. Normalmente esse status dura poucos milissegundos, até que uma resposta seja retornada com a autorização ou recusa.
  • [Autorizada] Uma transação fica nesse status quando ela foi autorizada pelo emissor e pelo antifraude, porém ainda não foi capturada. Ou seja, o valor foi reservado no saldo do comprador e é então necessário confirmar a compra. Normalmente esse fluxo é feito automaticamente, mas você pode optar por não fazer a captura automática se fizer sentido para o seu negócio. Saiba mais sobre autorização e captura na nossa documentação.
  • [Recusada] Uma transação pode ser recusada por várias razões, como cartão bloqueado, falta de saldo, falha na comunicação, análise do antifraude etc. Nessa tabela você pode ver os principais motivos de recusa para entender por que uma compra não foi aprovada.
  • [Recusada (capture_timeout)] Se a transação não for capturada em até sete dias (esse tempo varia de acordo com a chave usada na autorização, veja mais aqui), ela é automaticamente recusada e o saldo é liberado no cartão do comprador.
  • [Paga] Assim que é capturada, a transação passa de autorizada para paga. Isso quer dizer que o valor dessa compra entrou na sua agenda de recebimento e você pode enviar o produto ou liberar o serviço para o seu cliente.
  • [Estornada] Uma transação recebe esse status quando você precisa devolver o valor para o cliente e pede um estorno (isso pode ser feito pela Dashboard ou API). Se for realizado um estorno parcial (ou seja, apenas uma parte do valor for devolvida), a transação permanece como “Paga”, só mudando o status para “Estornada” se o valor total da compra for atingido. Atenção: o estorno de uma transação não pode ser revertido.
  • [Chargeback] Chargeback é a contestação de uma compra, feita pelo portador junto ao emissor do cartão. Saiba mais sobre isso na nossa Central de Ajuda. Quando isso ocorre, o dinheiro nunca chega ao Pagar.me, então o valor é debitado do lojista. Para tentar reaver o dinheiro, é possível entrar com um processo de reapresentação junto ao emissor (banco).

Compras feitas por Boleto bancário

Já as transações de boleto podem passar pelos seguintes status:

Veja uma explicação de cada status:

  • [Processando] Esse status costuma durar apenas alguns instantes. Ele indica que a transação foi criada e estamos gerando o boleto.
  • [Aguardando pagamento] Assim que o boleto é gerado e registrado pelo banco a transação ganha com esse status. Ele permanece até que a compra seja conciliada, o que acontece no próximo dia útil depois que é feito o pagamento do documento.
  • [Recusada] Esse status é bastante raro e indica que houve um problema ao gerar ou registar o boleto.
  • [Paga] Transações de boleto recebem esse status assim que o documento é conciliado, o que acontece no próximo dia útil depois que é feito o pagamento pelo cliente.
  • [Estorno pendente] Se você precisar devolver o dinheiro de uma venda para o comprador é possível realizar um estorno. Para transações de boleto essa devolução é feita por uma transferência bancária, portanto quando essa devolução é solicitada a transação permanece com o status “Estorno pendente” até que o emissor (banco) confirme a operação. Se for realizado um estorno parcial (ou seja, apenas uma parte do valor for devolvida), a transação permanece como “Paga”.
  • [Estornada] Esse status é mostrado quando o banco confirma a transferência do valor para a conta bancária do cliente. Não é possível desfazer essa ação.

Voltar para os Guias