LYNX UPBANK · Tecnologia de pagamentos Pix & Crypto

Erros

Toda resposta segue o envelope { data, error }. Em caso de erro, data é null e error traz uma mensagem legível, com o código HTTP apropriado.

json

{
  "data": null,
  "error": "Chave de API inválida ou revogada."
}

Parâmetro	Tipo	Descrição
`200`	OK	Requisição bem-sucedida.
`400`	Bad Request	Parâmetros inválidos ou faltando.
`401`	Unauthorized	Chave ausente, inválida, revogada ou expirada.
`403`	Forbidden	A chave não tem o escopo necessário.
`404`	Not Found	Recurso não encontrado.
`429`	Too Many Requests	Rate limit excedido, veja a seção Rate limiting. Aguarde e re-tente com backoff.
`502`	Bad Gateway	Falha temporária na liquidação PIX.

Boas práticas

Trate erros 4xx como definitivos: corrija a requisição em vez de re-tentar igual.
Re-tente 429 e 5xx com backoff exponencial e jitter (ex.: 1s → 2s → 4s…).
Registre a mensagem de error nos seus logs, ela é legível e descreve a causa exata.
Nunca exiba a mensagem crua ao seu cliente final; mapeie para textos do seu produto.