Postman
A coleção oficial pronta pra rodar: importa com um clique, já vem com o Bearer configurado e três ambientes montados, incluindo um mock pra você testar antes de ter credencial.
A collection oficial PayZu Pix está publicada em dev.payzu.com.br (Postman) com Bearer Auth via {{token}} e 3 ambientes prontos (Mock, Sandbox, Production).
Importar a collection
Abrir no 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 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
Bibliotecas oficiais em Node e Python pra você integrar sem montar requisição na mão: instala pelo npm ou pip, passa o token e cria a primeira cobrança em minutos, com tudo tipado.
MCP server
Deixa o Claude, o Cursor e outros assistentes executarem ações reais na sua conta enquanto você desenvolve: roda local via npx, usa o seu token e traz as ferramentas prontas, com validação de valores em reais e retry automático.