認證 - Kyren Pay

公開商戶整合介面（如 /v1/products、/v1/checkouts 和 /v1/orders）透過 x-api-key 請求標頭中的 API 密鑰認證。不同介面使用不同認證方式：

介面	認證方式
公開商戶整合 API	`x-api-key`
公開 `/v1/config/*` 配置介面	無需認證
商戶控制台 `/v1/merchant/*` 介面	登入 JWT：`Authorization: Bearer <token>`；API 密鑰不能代替控制台登入
Epay 相容 API	`pid` 加介面要求的 MD5 `sign`；`/epay/api.php` 使用 `pid` 加原始 `key`

Epay 的獨立簽名規則見 Epay 簽名。

API 密鑰

啟潤支付使用 API 密鑰來認證請求。你可以在商戶控制台中管理你的 API 密鑰。當前後端實作接受生產 API 密鑰：

密鑰類型	前綴	用途
生產密鑰	`kyren_live_`	生產環境 — 真實付款

呼叫需要認證的公開商戶整合介面時，在 x-api-key 請求標頭中包含你的 API 密鑰：

curl https://api.kyrenpay.com/v1/products \
  -H "x-api-key: kyren_live_xxxxxxxxxxxxxxxxxxxx"

請妥善保管你的 API 密鑰。

環境	Base URL	API 密鑰前綴
生產環境	`https://api.kyrenpay.com`	`kyren_live_`
Staging	由 Kyren 支援提供	僅使用 Kyren 為該 Staging 環境提供的憑證

目前公開生產 API 接受 kyren_live_ 前綴的生產密鑰。商戶控制台目前不提供自助建立 kyren_test_ 測試密鑰。只有在 Kyren 向你提供對應環境的 Base URL 和憑證時，才應使用 Staging 環境。

如果你的 API 密鑰洩露，可以在控制台中重新產生：

重新產生密鑰會立即使舊密鑰失效。請確保更新所有整合中的密鑰。

需要認證的介面在缺少或拒絕 API 憑證時返回 HTTP 401 Unauthorized。認證中介軟體不保證返回 JSON 回應本體，請先檢查 HTTP 狀態，再嘗試解析 JSON。應用層 JSON 錯誤碼見錯誤處理。常見原因：