即将上线
加入候补名单 →

沙盒

放心试错。

沙盒的运作方式与正式环境的 TujuPay 完全相同，只是使用测试银行，不涉及真实资金。上线前，用它把顾客可能遇到的每一种情况都测试一遍。

◷ 沙盒将先向候补名单中的开发者开放。TujuPay 获得牌照后，才会提供正式密钥。

沙盒与正式环境的区别

密钥
sk_test_ 和 whsec_ 测试密钥。正式密钥在这里无效
资金
无。付款、退款和结算均为模拟
银行
测试银行，按您的选择返回结果
结算
每 10 分钟执行一次，而不是每个工作日一次
数据
保留 90 天，之后清除

测试银行

在沙盒结账页面选择以下银行之一，即可得到对应的结果。

  • ✓
    Test Bank Approve付款立即成功
  • ✕
    Test Bank Decline银行拒绝付款
  • ✕
    Test Bank Insufficient因余额不足被拒绝
  • ◷
    Test Bank Slow保持 processing 状态 2 分钟，然后成功
  • ◷
    Test Bank Timeout顾客在银行页面离开，付款过期

测试 DuitNow QR

沙盒二维码无法用真实的网银应用支付。请在商家后台打开该付款并点击“模拟扫码”，或调用模拟接口。

curl
curl https://api.tujupay.com/v1/test/payments/pay_3Kx9LmQ2/simulate_scan \
  -u sk_test_51HxQ2...: \
  -d outcome=succeeded

触发测试 Webhook

沙盒中的每个操作都会向您的端点发送真实的 Webhook。您也可以随时在商家后台发送任何类型的事件，方便测试 payout.held 等少见事件。

curl
curl https://api.tujupay.com/v1/test/webhook_events \
  -u sk_test_51HxQ2...: \
  -d type=payout.held

限制

  • 每个账户每秒最多 25 个请求。
  • 每笔测试付款最高 RM 50,000。
  • 沙盒数据与正式环境数据完全隔离。

切换到正式环境

  • 逐一测试每家测试银行，确认您的代码能处理每种结果。
  • 检查您的 Webhook 端点会拒绝无效签名。
  • 将测试密钥换成正式密钥，并把 Webhook 指向正式环境。
上一页Webhook