把数字账户的集合导入 Postman,用已配置好的认证调用全部 38 个路由。
PayZu Conta Digital API 集合按路径的每一段划分文件夹:POST /transactions/payment/{paymentId}/refund 位于 transactions › payment › {paymentId} › refund。每个请求都带有一个已保存的响应示例。
调用会发送到生产环境,并在凭证所属账户中移动真实资金。
导入集合
在 Postman 中选择 Import → Link:
https://docs.payzu.com.br/payzu-conta-digital.postman_collection.json填写凭证
在集合变量中填写 clientId 和 clientSecret:
| 变量 | 值 |
|---|---|
baseUrl | https://api.hub.payzu.com.br/api/v1 |
clientId | 凭证的 client_id |
clientSecret | 凭证的 client_secret |
token | 由 Get access token 请求填入 |
获取令牌
运行 Get access token(POST /oauth/token)。它使用带 clientId 和 clientSecret 的 Basic Auth,并在 200 响应时把 access_token 写入 token。
令牌有效期 15 分钟。当请求开始返回 401 和 TOKEN_INVALID 时,再运行一次 Get access token。
调用路由
其他请求从集合继承 Authorization: Bearer {{token}} header。选择请求并发送即可。
重试提现、Pix 复制粘贴码付款和转账
提现、Pix 复制粘贴码付款和转账请求已经会发送 Idempotency-Key。集合在首次发送前生成该键,只有收到低于 500 的响应时才丢弃它。遇到 5xx 或网络故障后,再次发送即可:键不变,操作不会重复执行。