# Sandbox (/zh/docs/pix-processamento/sandbox)
Sandbox（沙盒）是 Pix API 的公开副本，用于开发和自动化测试。它在 `https://pix.sandbox.payzu.dev` 上响应，路由与生产环境的 `/v1` 完全一致：在这里能跑通的代码，换个 host 就能在生产环境跑通。
* **无需注册。** 填写 e-mail，确认 6 位验证码，立即获得凭证：[生成凭证](/docs/pix-processamento/sandbox/credencial)。
* **不含真实数据。** 沙盒里没有任何生产账户、交易或 Pix 密钥，在沙盒创建的内容也不会进入生产环境。测试时请勿使用真实客户的证件、密钥或 e-mail。
* **24 小时。** 凭证及其创建的一切（交易、webhook、争议）在 24 小时后全部消失。不支持续期：请重新生成凭证。
沙盒不能替代使用生产账户进行的联调验收。付款方是模拟的，清算是自动的，金额遵循固定规则。它的用途是在拿到凭证之前编写并测试集成，以及让自动化测试保持稳定。
## 第一笔收款 [#第一笔收款]
凭证放在 `SANDBOX_TOKEN` 中（见[生成凭证](/docs/pix-processamento/sandbox/credencial)）：
```bash
curl -X POST https://pix.sandbox.payzu.dev/v1/pix \
-H "Authorization: Bearer $SANDBOX_TOKEN" \
-H "Content-Type: application/json" \
-d '{"amount":25.00,"clientReference":"pedido-123"}'
```
收款初始为 `PENDING`。10 秒后变为 `COMPLETED`，已注册的 webhook 会收到带有 `X-Callback-Signature` 的 `TRANSACTION_COMPLETED`。
```bash
curl "https://pix.sandbox.payzu.dev/v1/pix?clientReference=pedido-123" \
-H "Authorization: Bearer $SANDBOX_TOKEN"
```
10 秒后，响应带有 `status: "COMPLETED"`、`endToEndId` 和 `paidAt`。同样的查询也支持按 `id` 或 `endToEndId`，见 [`GET /v1/pix`](/docs/pix-processamento/endpoints/pix-operations/get_pix)。
## 接口参考 [#接口参考]
[API 参考](/docs/pix-processamento/endpoints) 对两个环境都适用：相同路由、相同字段、不同 host。`/sandbox/...` 路由只存在于沙盒，并在本节中说明。