Cancelamento Garantido

ūüöß

Disponível apenas para Pagar.me Gateway

Esta funcionalidade está disponível apenas para clientes Gateway

O cancelamento garantido é uma funcionalidade desenvolvida pensando na melhor experiência entre lojista e consumidor final. Para alguns modelos de negócio pode não ser viável esperar a resposta de uma transação com erro (em que não se sabe o status real: pago ou não autorizado). Muitas vezes, o lojista precisa mostrar uma resposta ao consumidor final na hora em que ele faz o pedido, já que o consumidor precisa da confirmação ou não do pedido de forma síncrona.

Com o cancelamento garantido, todas transa√ß√Ķes que sofreram algum tipo de erro no fluxo normal s√£o automaticamente canceladas, e assim o consumidor ter√° uma resposta final (transa√ß√£o aprovada ou transa√ß√£o falha) no momento do pedido, em tempo real.

Para entender melhor o que pode causar um erro na transação, precisamos falar sobre alguns pontos:

A API Pagar.me tem os seguintes status mapeados para uma cobrança:

  • Paid - quando uma cobran√ßa est√° paga;
  • Pending - quando uma cobran√ßa ainda est√° pendente de altera√ß√£o (como um boleto gerado e ainda n√£o pago, uma transa√ß√£o de cart√£o de cr√©dito autorizada e n√£o capturada ou uma transfer√™ncia banc√°ria n√£o realizada);
  • Failed - quando a transa√ß√£o falhou, foi n√£o autorizada ou n√£o confirmada;
  • Canceled - quando h√° o cancelamento ou estorno de uma cobran√ßa;
  • Processing - quando ocorreu algum fluxo inesperado, ou seja, quando a cobran√ßa n√£o seguiu o fluxo correto de processamento e retornou com erro do gateway ou quando a cobran√ßa est√° pendente de retentativa offline.

Uma transação adquire o status processing em alguns casos, como os citados abaixo:

ProblemaExplicação
Time out com a adquirenteQuando a adquirente n√£o responde a tempo
Opera√ß√Ķes com erro no retorno do gatewayIsso pode ocorrer pelos seguintes motivos:
Loja com problemas ou bloqueio na adquirente
Erro 500 no gateway
Erro no cancelamento
Erro no estorno

ūüöß

Status "processing"

Transa√ß√Ķes que entram no fluxo de retentativa offline tamb√©m recebem o status "processing". Para diferenciar as duas situa√ß√Ķes, enviamos uma flag de "pending_cancelation", mostrando que a transa√ß√£o est√° na fila de cancelamento.

Nos casos em que houve algum erro, o Pagar.me sonda a adquirente de tempos em tempos para entender qual o real status da transação (se existe e está paga, se existe e falhou ou se não existe na adquirente) e, ao concluir sobre esse status, notifica o lojista.

Essa funcionalidade garante que todas as transa√ß√Ķes que entrem no fluxo de status "processing" sejam canceladas automaticamente. Retornamos o status "processing", mas o lojista pode tratar como falha, permitindo que o consumidor tente de novo sem correr o risco de duplicar a compra.

ūüĎć

Aplica√ß√Ķes

Essa funcionalidade é muito utilizada, por exemplo, por apps de entrega. O consumidor não pode depender da verificação do gateway na adquirente porque já está esperando a entrega (comida, por exemplo). Assim, nós retornamos a transação como "falha" e possibilitamos uma nova tentativa, garantindo uma experiência mais rápida, confiável e eficiente!