Sandbox
24 小时凭证,无需注册,不含真实数据:用与生产完全相同的路由跑通 Pix API 的完整流程,只需更换 host。
Sandbox(沙盒)是 Pix API 的公开副本,用于开发和自动化测试。它在 https://pix.sandbox.payzu.dev 上响应,路由与生产环境的 /v1 完全一致:在这里能跑通的代码,换个 host 就能在生产环境跑通。
你的应用同一套代码
/v1
Sandboxpix.sandbox.payzu.dev
之后只需更换 host
生产环境api.payzu.processamento.com
- 无需注册。 填写 e-mail,确认 6 位验证码,立即获得凭证:生成凭证。
- 不含真实数据。 沙盒里没有任何生产账户、交易或 Pix 密钥,在沙盒创建的内容也不会进入生产环境。测试时请勿使用真实客户的证件、密钥或 e-mail。
- 24 小时。 凭证及其创建的一切(交易、webhook、争议)在 24 小时后全部消失。不支持续期:请重新生成凭证。
沙盒不能替代使用生产账户进行的联调验收。付款方是模拟的,清算是自动的,金额遵循固定规则。它的用途是在拿到凭证之前编写并测试集成,以及让自动化测试保持稳定。
第一笔收款
凭证放在 SANDBOX_TOKEN 中(见生成凭证):
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。
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。
接口参考
API 参考 对两个环境都适用:相同路由、相同字段、不同 host。/sandbox/... 路由只存在于沙盒,并在本节中说明。