現象
建立 Checkout Session 返回錯誤,或未產生託管收銀台 URL。常見原因
product_id不存在,或屬於其他商戶。- 產品已封存,不能用於新的 Session。
- 請求的幣種不受支援。
- 金額或價格欄位以數字傳入,而不是十進位字串。
- 缺少
success_url或cancel_url,或 URL 無效。 - 驗證失敗,請求未進入 Checkout 處理。
在 Kyren 中檢查
- 在 控制台 > 產品 確認產品處於啟用狀態。
- 檢查產品價格和幣種。
- 確認 Checkout 使用有效的跳轉 URL。
- 如果 API 回應提示驗證失敗,請檢查開發者設定。
在你的伺服器檢查
- 金額和價格值必須使用十進位字串,例如
"9.99"。 - 使用受支援的三位幣種代碼,例如
USD。 - 確認
success_url和cancel_url是完整 HTTPS URL。 - 記錄請求體和 Kyren 回應狀態,但不要記錄密鑰。
修復
更新請求,使用啟用中的產品、受支援幣種、十進位字串金額、有效跳轉 URL 和有效的x-api-key。