Changelog

A versão está no caminho (/v1). Campo novo numa resposta, evento novo ou código de erro novo não quebram a v1: ignore o que você não conhece. Qualquer mudança incompatível vira /v2, com aviso e período de convivência.

Sem mudança de contrato: a versão continua 1.0.0.

• Método que a rota não aceita (ex.: DELETE /ping) responde 405 METODO_NAO_PERMITIDO no envelope de erro, com requestId e o cabeçalho Allow. Antes vinha um 405 de corpo vazio.
• As mensagens de VALIDACAO em detalhes.campos saem em português (ex.: "Deve ser no mínimo 60."). Decida pelo codigo, não pelo texto.
• O 429 do limite por minuto traz também RateLimit-Limit, RateLimit-Remaining: 0 e RateLimit-Reset, além do Retry-After.
• Na criação de cobrança, com mais de um motivo ao mesmo tempo, a resposta segue a ordem VINCULO_REVOGADO, PDV_INATIVO, LOJA_INATIVA. Antes, depois de a loja desconectar o sistema (o que desliga os caixas), vinha PDV_INATIVO, e o operador não ficava sabendo que precisava de um código novo.
• Ambiente de testes: reativar um caixa com a integração revogada é recusado, como na produção. Restaurar a integração nunca religou os caixas; o portal é que dizia que sim, e agora diz que eles seguem desligados até serem reativados.
• Webhooks: o mesmo endereço não pode ser cadastrado duas vezes no mesmo aplicativo e ambiente.

Primeira versão pública.

• Caixas: ativar com código (POST /pontos-de-venda/ativar), listar, consultar, desligar.
• Cobranças: criar com Idempotency-Key, consultar com espera (?aguardar=), listar, cancelar.
• Eventos: GET /eventos (30 dias) e webhooks assinados (HMAC-SHA256, t=…,v1=…).
• Ambiente de testes com dados fictícios, celular de teste, cenários automáticos e simulações da loja.
• Homologação automática com 9 itens e pedido de produção pelo portal.
• Repetir POST /cobrancas com a mesma Idempotency-Key e o mesmo corpo responde 200 com Idempotent-Replayed: true e a cobrança no estado de agora (a criação responde 201).
• O nome do caixa tem até 60 caracteres e não aceita endereço de site nem e-mail: ele aparece para o gerente da loja nos avisos da Moeda Nobre.
• Rota que não existe responde 404 RECURSO_NAO_ENCONTRADO no mesmo envelope de erro, com requestId.