沙盒
放心測試，不怕出錯。
沙盒的運作方式與正式環境的 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
沙盒 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 指向正式環境。