# 测试场景 (/zh/docs/pix-processamento/sandbox/cenarios)

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/sandbox" title="Sandbox" />

  <QuickLink href="/docs/pix-processamento/sandbox/credencial" title="生成凭证" />

  <QuickLink href="/docs/pix-processamento/sandbox/webhooks" title="沙盒中的 Webhook" />

  <QuickLink href="/docs/pix-processamento/endpoints" title="API 参考" />
</QuickLinks>

## 与生产环境的差异 [#与生产环境的差异]

| 项目                                    | 生产                            | 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](/docs/pix-processamento/sandbox/webhooks)）              |
| 限额                                    | 按账户                           | 每个凭证每分钟 60 次请求、每天 2.000 次；每个 e-mail 每小时 3 个验证码                                                |
| 重置                                    | 不适用                           | 没有重置路由，也没有强制改状态的路由。想要干净的环境，就生成一个新凭证                                                           |

提现的分档金额是为了让你无需管理员路由就能测完三条路径（已取消、处理中、已完成）：选好金额即可。退款的分档覆盖服务商错误、已取消和已完成；退款没有处理中状态。合同的其余部分（字段、枚举、分页、错误信封）与生产完全一致。

<Flow>
  <FlowNode title="提现 < R$ 10" subtitle="CANCELED" />

  <FlowNode title="R$ 10 至 R$ 100" subtitle="立即 COMPLETED" />

  <FlowNode title="提现 > R$ 100" subtitle="PENDING，10 秒后完成" />
</Flow>

## 按金额分档的退款 [#按金额分档的退款]

```bash
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 模拟服务商返回错误。