Sandbox 與正式環境
現階段所有 API Key 都是 Sandbox(測試環境)金鑰,不會移動真實款項。
ReBate Pay 目前只發出 rbp_test_... 測試金鑰。每一次 API 回應都會帶一個 sandbox 欄位({ mode: "sandbox", realMoney: false }),明確告訴你這是測試資料。
正式環境(真實扣款)目前尚未開放,需要完成商家審核(KYB)與外部驗收後才會發出正式金鑰。文件中任何提到「正式環境」的地方都只是說明未來行為,不代表現在可以使用。
Sandbox 情境選擇器
在 Sandbox,付款/退款/對帳這類 API 會接受一個 chargeScenario(或 sandboxScenario)參數,讓你模擬不同結果,不需要真的接測試卡:
| 值 | 行為 |
|---|---|
success | 付款直接成功 |
decline | 付款直接失敗(银行拒絕) |
timeout | 付款狀態變成 unknown——這不是失敗,代表「還不確定」,必須呼叫 對帳 API 確認最終結果,不可以直接重試扣款 |
環境判斷
呼叫 GET /api/Capability 可以看到目前的環境資訊,也可以直接看每個回應的 sandbox 欄位。金鑰前綴 rbp_test_ 本身就代表這是測試金鑰。
ReBate Pay Docs