Postman
A collection oficial PayZu Pix está publicada em dev.payzu.com.br (Postman) com 29 endpoints organizados em 7 folders, Bearer Auth via {{token}} e 3 ambientes prontos (Mock, Sandbox, Production).
Importar a collection
Run in PostmanOu via URL no Postman: Import → Link:
https://docs.payzu.com.br/payzu-pix.postman_collection.jsonSetup em 3 passos
Importar no seu workspace
Clica em Run in Postman acima. A collection é forkada pro seu workspace pessoal, com toda a estrutura: folders, autenticação, exemplos.
Configurar o token
Na collection PayZu Pix → aba Variables:
| Variável | Valor |
|---|---|
baseUrl | https://api.payzu.processamento.com/v1 (padrão) |
token | Seu Bearer token PayZu |
Token aparece automaticamente no header Authorization: Bearer {{token}} de todas as 29 requisições.
Testar uma chamada
Abre Cobranças Pix → POST /pix → Send. O exemplo já vem preenchido com amount, clientReference, callbackUrl. Volta o qrCodeText pra testar com qualquer banco que suporte Pix.
Mock Server
Pra desenvolvimento sem precisar do token real, a collection tem um mock server público que responde com os exemplos do OpenAPI. Útil também pra contornar CORS em ferramentas web.
https://a8aa4f94-6b53-4994-bc60-7b2347f008e1.mock.pstmn.ioUse no lugar de https://api.payzu.processamento.com/v1 enquanto desenvolve o front-end.
| Request | Resposta mock |
|---|---|
POST /pix | { id, qrCodeText, status: "PENDING", ... } |
GET /pix?clientReference=order-1 | { status: "COMPLETED", ... } |
GET /user/balance | { available: 12450.75, blocked: 0, ... } |
O mock responde com base nos examples do OpenAPI. Não persiste estado entre chamadas, mas o formato é idêntico ao da API real.
Boas práticas
- Crie um fork da collection oficial em vez de editar a original. Forks recebem updates upstream.
- Use environments pra trocar
baseUrlentre dev/prod (api.payzu.processamento.com/v1vs mock). - Snippets de código: clica em
</>no canto direito de qualquer request pra exportar em curl, Node, Python, Go, PHP, etc. - Monitor: ative Postman Monitor pra testar a API a cada 5 min e receber alerta se cair.
Comparação com outros visualizadores
SDKs
SDKs oficiais PayZu Pix em Node.js, Python, Go e PHP. Gerados automaticamente do OpenAPI sempre que a API muda. Instalação via npm, pip, go get ou composer.
Para IAs (LLMs)
Toda a documentação da PayZu disponível em formato consumível por modelos de linguagem. Copie o conteúdo direto, baixe o dump completo, ou use as URLs específicas por página. Funciona com ChatGPT, Claude, Gemini, Cursor, Copilot, etc.