Skip to main content
使用本頁測試你的整合，不要假設未公開支援的環境或密鑰類型。

​
目前環境模型

除非 Kyren 已向你提供對應環境的憑證，否則不要向任意 Staging URL 傳送測試流量。

​
測試 API 密鑰

使用目標環境實際簽發的 API 密鑰：

​
測試卡號

只有在 Kyren 已向你提供 Staging 或可測試環境，或為你的商戶啟用可測試支付閘道時，才應使用以下卡號。不要假設這些卡號會在生產收銀台中產生確定性的測試結果。 對於所有測試卡：
  • 使用任意未來的到期日期（如 12/28）
  • 使用任意 3 位 CVV（如 123）
  • 使用任意持卡人姓名
  • 使用任意帳單地址

​
測試微信支付 / 支付寶

二維碼支付行為取決於商戶綁定的閘道配置。驗證非同步狀態更新時，請使用 Kyren 為目標環境提供的憑證，或配合回調模擬。

​
測試 Webhook

在本地測試 Webhook 時，可以使用 ngrok 等隧道工具暴露本地伺服器：
然後在控制台中將 ngrok URL 配置為你的 Webhook 端點：
正式上線前，記得將 Webhook URL 更新為你的生產環境端點。

​
上線檢查清單

切換到生產環境前，請確保你已經完成以下步驟：
1

替換 API 密鑰

使用 api.kyrenpay.com 對應的生產密鑰
2

更新介面位址

如果 Kyren 向你提供了 Staging Base URL，請從該位址切換到 api.kyrenpay.com
3

更新 Webhook URL

在控制台中設定生產環境的 Webhook 端點
4

驗證 Webhook 簽名

確保你的伺服器正確驗證 X-Kyren-Signature 請求標頭
5

優雅處理錯誤

測試各種錯誤場景，確保你的應用能正確處理