PayZuDocs

把数字账户的集合导入 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:

变量值
baseUrlhttps://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 或网络故障后,再次发送即可:键不变,操作不会重复执行。

本页内容