Postman
The official PayZu Pix collection is published at dev.payzu.com.br (Postman) with 29 endpoints organized in 7 folders, Bearer Auth via {{token}} and 3 ready environments (Mock, Sandbox, Production).
Import the collection
Run in PostmanOr via URL in Postman: Import → Link:
https://docs.payzu.com.br/payzu-pix.postman_collection.jsonSetup in 3 steps
Import into your workspace
Click Run in Postman above. The collection is forked into your personal workspace, with the entire structure: folders, authentication, examples.
Configure the token
In the PayZu Pix collection → Variables tab:
| Variable | Value |
|---|---|
baseUrl | https://api.payzu.processamento.com/v1 (default) |
token | Your PayZu Bearer token |
The token appears automatically in the Authorization: Bearer {{token}} header of all 29 requests.
Test a call
Open Cobranças Pix → POST /pix → Send. The example already comes filled in with amount, clientReference, callbackUrl. It returns the qrCodeText so you can test with any bank that supports Pix.
Mock Server
For development without needing the real token, the collection has a public mock server that responds with the OpenAPI examples. Also useful to work around CORS in web tools.
https://a8aa4f94-6b53-4994-bc60-7b2347f008e1.mock.pstmn.ioUse it instead of https://api.payzu.processamento.com/v1 while developing the front-end.
| Request | Mock response |
|---|---|
POST /pix | { id, qrCodeText, status: "PENDING", ... } |
GET /pix?clientReference=order-1 | { status: "COMPLETED", ... } |
GET /user/balance | { available: 12450.75, blocked: 0, ... } |
The mock responds based on the OpenAPI examples. It does not persist state between calls, but the format is identical to the real API.
Best practices
- Create a fork of the official collection instead of editing the original. Forks receive upstream updates.
- Use environments to switch
baseUrlbetween dev/prod (api.payzu.processamento.com/v1vs mock). - Code snippets: click
</>in the right corner of any request to export to curl, Node, Python, Go, PHP, etc. - Monitor: enable Postman Monitor to test the API every 5 min and get alerted if it goes down.
Comparison with other viewers
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.