VamPay
VamPay

Erros e códigos HTTP

Como a API avisa que algo deu errado e o que fazer em cada caso.

Formato

Toda resposta de erro tem o status HTTP certo e um JSON com success: false e uma message em português que você pode mostrar ou registrar. Alguns erros trazem também um code pra tratar no código.

400 Bad Requestjson
{
  "success": false,
  "message": "Valor mínimo: R$ 1,50"
}

Códigos

ParâmetroTipo
200 / 201Sucesso
400Requisição inválida
401Não autenticado
403Sem permissão
404Não encontrado
409Conflito
429Muitas requisições
500 / 502 / 503Erro do nosso lado

Boas práticas

  • • Trate 5xx e 429 com nova tentativa e espera crescente. Não repita 400, 401, 403 e 404: eles não se resolvem sozinhos.
  • • Em criação de cobrança ou saque, se a resposta se perdeu, consulte antes de repetir pra não duplicar.
  • • Registre a message inteira nos seus logs: ela costuma dizer exatamente o que ajustar.
O limite de requisições está em Rate Limiting e o estado da plataforma em Status.