上线前先在沙盒中完成测试

支付集成应当在真实客户使用之前完成测试。PAYWISE 为每个账户提供沙盒：一个与正式环境运作方式相同、但不涉及真实资金的测试环境。

沙盒密钥

在 API 密钥页面创建密钥并选择沙盒环境。沙盒密钥以 pw_test_ 开头，正式密钥以 pw_live_ 开头。每个密钥只在自己的环境中有效，因此测试绝不会误创建真实付款。沙盒交易也不会计入您的正式报表。

自己决定付款结果

在现实中，您需要等待客户付款。在沙盒中，结果由您决定：

1. 使用沙盒密钥创建一笔付款。
2. 打开它的 checkout_url。
3. 在模拟结果下选择已支付、失败或已过期。

您的 Webhook 地址会收到与真实付款完全相同、同样带签名的事件。这是测试订单处理逻辑（包括失败情况）的最佳方式。

还没写代码？试试 API 演练场

控制台中的 API 演练场可以通过表单用您的沙盒密钥发送真实请求，并显示请求和响应内容。在编写代码之前，这是了解 API 返回结果的快捷方式。

上线前检查清单

• 即使 Webhook 到达两次，已付款也只会将订单标记为已付款一次。
• 失败和过期的付款不会触发发货。
• 您的服务器会拒绝签名错误的 Webhook。
• 重复发送相同的 merchant_reference 不会创建第二笔付款。
• API 日志页面显示的请求状态码符合预期。

全部通过后，创建正式密钥替换沙盒密钥即可，代码的其他部分无需任何修改。