卡片接口的全部路由,从获取令牌到退款。
典型集成流程
流程是:获取 token,创建收款,通过 webhook 接收处理结果,需要时查询状态,必要时发起退款。
Token
API 身份认证:用 client_id 和 client_secret 换取 JWT token。
收款
创建、查询和退款信用卡收款。
循环扣款
管理通过 POST /charges 中的 recurrence 节点创建的订阅。
汇率
用于国际收款的参考汇率与换算。
约定
| 项目 | 值 |
|---|---|
| Base URL(生产环境) | https://api.payzu.io/v1 |
| Base URL(sandbox) | https://api.sandbox.payzu.io/v1 |
| 身份认证 | mTLS(客户端证书)+ Authorization: Bearer YOUR_TOKEN,通过 POST /token 获取。参见身份认证 |
| Content-Type | application/json |
| 金额 | 以分为单位(10000 = R$ 100,00)。汇率(rate.bid、rate.ask)为小数 |