官方集合，拿来就能跑：一键导入，Bearer 认证已配好，还预置了三个环境，其中一个 mock 让你没拿到凭证也能先测。
官方 PayZu Pix collection 发布于 dev.payzu.com.br（Postman），通过 {{token}} 使用 Bearer Auth，并预置 3 个环境（Mock、Sandbox、Production）。
导入 collection
在 Postman 中打开或在 Postman 中通过 URL 导入：Import → Link：
https://docs.payzu.com.br/payzu-pix.postman_collection.json三步配置
导入到你的 workspace
点击上方的 Run in Postman。collection 会被 fork 到你的个人 workspace，包含完整结构：folders、认证、示例。
配置 token
在 PayZu Pix collection → Variables 标签页：
| 变量 | 值 |
|---|---|
baseUrl | https://api.payzu.processamento.com/v1（默认） |
token | 你的 PayZu Bearer token |
token 会自动出现在每个请求的 Authorization: Bearer {{token}} 请求头中。
测试一次调用
打开 Pix Charges → POST /pix → Send。示例已填好 amount、clientReference、callbackUrl，会返回 qrCodeText，可用任意支持 Pix 的银行测试。
Mock Server
无需真实 token 即可开发：collection 自带一个公开 mock server，用 OpenAPI 示例作答，还可用于在 web 工具中绕过 CORS。
https://a8aa4f94-6b53-4994-bc60-7b2347f008e1.mock.pstmn.io开发前端时用它替代 https://api.payzu.processamento.com/v1。
| 请求 | Mock 响应 |
|---|---|
POST /pix | { id, qrCodeText, status: "PENDING", ... } |
GET /pix?clientReference=order-1 | { status: "COMPLETED", ... } |
GET /user/balance | { available: 12450.75, blocked: 0, ... } |
mock 基于 OpenAPI 的 examples 作答。调用之间不保存状态，但格式与真实 API 完全一致。
最佳实践
- fork 官方 collection，而不是直接编辑原件。fork 会收到上游更新。
- 使用 environments 在 dev/prod 之间切换
baseUrl（api.payzu.processamento.com/v1与 mock）。 - 代码片段：点击任意请求右侧的
</>，导出为 curl、Node、Python、Go、PHP 等。 - Monitor：启用 Postman Monitor，每 5 分钟测试一次 API，宕机时告警。