Sandbox 與正式環境

現階段所有 API Key 都是 Sandbox(測試環境)金鑰,不會移動真實款項。

檢視 Markdown

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_ 本身就代表這是測試金鑰。