Skip to main content
Quando o provedor recusa várias vezes o estorno de uma mesma cobrança, a Malga para de enviar novos pedidos de estorno ao provedor. Assim, tentativas que tendem a falhar do mesmo jeito não sobrecarregam o provedor. O limite vale para os estornos feitos pela requisição de void, em qualquer meio de pagamento.

Como a contagem funciona

  • Contam as tentativas de estorno da cobrança no mesmo provedor que não terminaram com sucesso, inclusive as que ainda estão em processamento.
  • Um estorno concluído com sucesso zera a contagem.

Erros retornados

Ao atingir o limite, a requisição de void é recusada com um dos erros abaixo: Nesses dois casos, a Malga não envia o pedido ao provedor, não cria um novo transactionRequest e não altera o status da cobrança. A resposta é um erro HTTP, e não um 201 com um transactionRequest com status failed.

Exemplo de requisição

Resposta 429

O corpo traz o tempo de espera em minutos (retry_after_minutes) e o horário em UTC a partir do qual você pode tentar de novo (retry_after_at):

Resposta 422

Como tratar na sua integração

1

Respeite o tempo de espera do 429

Se a sua integração repete o estorno automaticamente, não faça uma nova tentativa antes do horário de retry_after_at.
2

Trate o 422 como erro final

Não repita a requisição: a resposta continua sendo 422, mesmo depois de algum tempo.
3

Se necessário, fale com o suporte

Se precisar de ajuda, entre em contato com o suporte da Malga.
Veja também a tabela de erros da API.