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 devoid é 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.