PayZuDocs
Sandbox

触发各种结果的金额:提现已取消、处理中或已完成,退款报错、已取消或已完成,确定性 fixture,以及每个凭证的限额。

与生产环境的差异

项目生产Sandbox
Hostapi.payzu.processamento.compix.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 模拟服务商返回错误。

本页内容