Sandbox
触发各种结果的金额:提现已取消、处理中或已完成,退款报错、已取消或已完成,确定性 fixture,以及每个凭证的限额。
与生产环境的差异
| 项目 | 生产 | Sandbox |
|---|---|---|
| Host | api.payzu.processamento.com | pix.sandbox.payzu.dev |
| 凭证 | 账户 token,审核通过后签发 | 通过 e-mail 和验证码签发的 sbx_...,有效期 24 小时 |
收款(POST /v1/pix) | 付款方完成 Pix 后支付 | 初始为 PENDING,10 秒后变为 COMPLETED,并触发与生产相同签名方式的 webhook |
按密钥提现(POST /v1/withdraw) | 取决于服务商 | 低于 R$ 10,00 为 CANCELED;R$ 10,00 至 R$ 100,00 立即 COMPLETED;高于 R$ 100,00 为 PENDING,10 秒后完成 |
退款(POST /v1/refund/{transactionId}) | 取决于服务商 | 低于 R$ 1,00 返回服务商错误;低于 R$ 10,00 为 CANCELED;R$ 10,00 起为 COMPLETED |
| DICT 与二维码解析 | 真实查询 | 确定性 fixture:同一个 id 始终返回相同响应 |
| 争议(MED) | 你账户中的真实争议 | 每个凭证 12 条示例,状态为 OPEN |
| 已注册的 webhook | 直接投递 | 只有在证明 endpoint 归属之后才投递(沙盒中的 Webhook) |
| 限额 | 按账户 | 每个凭证每分钟 60 次请求、每天 2.000 次;每个 e-mail 每小时 3 个验证码 |
| 重置 | 不适用 | 没有重置路由,也没有强制改状态的路由。想要干净的环境,就生成一个新凭证 |
提现的分档金额是为了让你无需管理员路由就能测完三条路径(已取消、处理中、已完成):选好金额即可。退款的分档覆盖服务商错误、已取消和已完成;退款没有处理中状态。合同的其余部分(字段、枚举、分页、错误信封)与生产完全一致。
提现 < R$ 10CANCELED
R$ 10 至 R$ 100立即 COMPLETED
提现 > R$ 100PENDING,10 秒后完成
按金额分档的退款
curl -X POST https://pix.sandbox.payzu.dev/v1/refund/$TRANSACTION_ID \
-H "Authorization: Bearer $SANDBOX_TOKEN" \
-H "Content-Type: application/json" \
-d '{"amount":25.00,"description":"Teste de estorno"}'R$ 10,00 起退款完成(COMPLETED),金额为全额时原收款变为 REFUNDED。低于 R$ 10,00 退款被取消;低于 R$ 1,00 模拟服务商返回错误。