The official collection ready to run: import in one click, Bearer auth already wired up, and three environments set up, including a mock so you can test before you even have credentials.
The official PayZu Pix collection is published at dev.payzu.com.br (Postman) with 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 whole 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 every request.
Test a call
Open Pix Charges → POST /pix → Send. The example is already filled with amount, clientReference, callbackUrl. It returns the qrCodeText to test with any bank that supports Pix.
Mock Server
For development without a 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
</>on the right of any request to export it as curl, Node, Python, Go, PHP, etc. - Monitor: enable Postman Monitor to test the API every 5 min and get alerted if it goes down.