Erros comuns da API Pix

Resposta rápida: Erros da API Pix seguem RFC 7807 com type no padrão https://pix.bcb.gov.br/api/v2/error/<TipoErro>; 4xx é problema do cliente, 5xx do servidor.

Tipos gerais (BACEN)

Tipo	HTTP	Significado prático
RequisicaoInvalida	400	JSON/campos inválidos
AcessoNegado	403	Autenticado sem permissão / produto não contratado
NaoEncontrado	404	txid ou recurso inexistente
ErroInternoDoServidor	500	Falha no PSP
ServicoIndisponivel	503	Manutenção / fora da janela

O que fazer primeiro

1. Ler status, title, detail do body.
2. Conferir mTLS + Bearer.
3. Validar payload contra OpenAPI BACEN.

Usado em

• Seções “Se der errado” das recipes