Começo

Erros

Todo erro volta no mesmo formato, com uma mensagem em português pronta para mostrar.

Resposta de erro

{
  "errors": [
    {
      "message": "Preço inválido. Use o formato 1.500,00 ou 49,90 (mínimo R$ 1,00)."
    }
  ]
}

Código	Quando
`400`	Corpo que não é JSON válido, ou não é um objeto.
`401`	Chave ausente, em formato errado, desconhecida ou revogada.
`402`	Loja sem plano ativo ou suspensa.
`403`	A chave não tem a permissão exigida pela rota (a mensagem diz qual).
`404`	Recurso não encontrado na loja da chave, ou rota que não existe.
`409`	Conflito: o estado mudou enquanto você decidia (ex.: comissão nova entrou antes de marcar como paga).
`413`	Corpo grande demais.
`422`	Dados inválidos: campo obrigatório faltando, formato errado ou regra da loja (ex.: opção com nome repetido).
`429`	Limite de requisições atingido. Respeite o cabeçalho Retry-After.
`500`	Erro nosso. Tente de novo; se continuar, fale com o suporte.

Respostas de sucesso: 200 (leitura e edição), 201 (criou algo) e 202 (aceito para envio, como o teste de webhook).