Changelog

Mudanças da API pública do Wolf Sandbox. A versão atual do contrato é 1.0.0.

Política de compatibilidade

Compatíveis (sem aviso prévio): novas operações, novos campos opcionais em requisições, novos campos e novos valores de enum em respostas, novos tipos de evento e novos códigos de erro. Seu código deve ignorar o que não conhece.
Incompatíveis: remover operação ou campo de resposta, tornar um campo obrigatório, restringir tipos ou valores aceitos, exigir novo escopo. Cada mudança assim é detectada automaticamente na integração contínua a partir do contrato gerado, só é aceita com registro explícito e aparece aqui antes de entrar em vigor.

Documento OpenAPI 3.1 gerado dos contratos da API, servido em /openapi.json com o servidor de cada ambiente.
PaymentIntents com payment_method_types, pagador (payer, documento protegido), description, metadata e next_action.
Pix simulado assíncrono (QR sintético, vencimento em 30 minutos, POST /v1/simulator/payment-intents/{id}/pix/pay) e cinco cartões de teste escolhidos por cenário.
Checkout hospedado com pagador e método de pagamento, pedidos criados a partir da oferta e Payment Links persistentes.
Idempotency-Key obrigatória em todas as criações, com secret_already_revealed nos replays que revelariam segredos.
Rate limits por credencial, por Payment Link e por sessão de checkout, com 429 RATE_LIMITED e Retry-After.
API keys somente sk_test_, com expiração opcional.
Webhooks live assinados com teste, replay, desativação, exclusão, rotação de segredo e auto-desativação.

payment_method_token deixou de existir na confirmação de PaymentIntents e no pagamento do checkout (400 VALIDATION_FAILED); use payment_method.
Idempotency-Key passou a ser obrigatória nas criações de produtos, ofertas, sessões de checkout, endpoints de webhook e API keys (400 IDEMPOTENCY_KEY_REQUIRED).