Swagger UI

Console interativo para testar os endpoints contra o sandbox, direto do navegador.

Sandbox apenas

Nunca use credenciais de produção nesta página. O console roda no seu navegador e o token fica em memória, mas credencial de produção não deve sair do cofre de segredos em nenhuma circunstância.

Implementada por PDV Parceiro.

Carregando o console…

Por que duas ferramentas

O portal usa Redoc para a referência e Swagger UI para o console. As duas consomem exatamente o mesmo arquivo OpenAPI.

Ferramenta	Onde	Para quê
Redoc	Referência	Leitura, navegação, busca, schemas expandidos
Swagger UI	Esta página	Executar chamadas reais contra o sandbox

Redoc é melhor para ler; Swagger UI é a única das duas que executa. Manter as duas custa um arquivo de configuração e resolve os dois usos sem comprometer nenhum.

Como autenticar no console

1. Abra POST /oauth/token e execute com o seu client_id e client_secret de sandbox.
2. Copie o access_token da resposta.
3. Clique em Authorize, no topo, e cole o token.
4. Os demais endpoints passam a enviar o header Authorization automaticamente.

Os headers X-Request-Id, X-Correlation-Id e Idempotency-Key precisam ser preenchidos manualmente. Gere UUIDs v4 — o console não os gera sozinho.