每家店铺一个账户，通过 API 操作：Pix 收款、提现、Pix 复制粘贴码付款、转账和账单。
每个凭证只操作一个账户：没有任何路由接收 accountId。要操作两个账户，请使用两个凭证。
| 项目 | 规则 |
|---|
| Base URL | https://api.hub.payzu.com.br/api/v1 |
| 金额 | 整数，单位为分：1500 即 R$ 15,00。 |
| 百分比 | 以基点表示：150 即 1.5%。 |
| 日期 | UTC 时间的 ISO 8601，例如 2026-10-05T14:32:05.123Z。 |
| 列表 | 按游标分页：把响应中的 nextCursor 放入下一次调用的 cursor 参数。最后一页不返回它。 |
| 错误 | { "message", "code", "details" }。按 code 处理；message 是用于展示的文本。 |
| 操作 | 余额变化的时间 |
|---|
| 收款 | 客户付款时。会收到 PAYMENT_PAID Webhook。 |
| 提现和 Pix 复制粘贴码付款 | 发起请求时：金额和手续费从可用余额中扣出。操作失败时退回。 |
| 账户间转账 | 立即：响应中已带有结果。 |
| 无收款单的入账 Pix | Pix 到账时。会收到 DEPOSIT_RECEIVED Webhook。 |
| 退款和退回存款 | 发起请求时：金额和手续费从可用余额中扣出。退款失败时退回。 |
- Boleto 和银行卡。 API 不开具 boleto，也不进行银行卡收款。银行卡请见银行卡 API。
- 答复 MED 争议。 API 显示争议；答复在控制台中进行。
- 创建或更换凭证。 由账户持有人在控制台 hub.payzu.com.br 中完成。
