認證 - Kyren Pay

所有 API 請求必須透過在 x-api-key 請求標頭中傳遞 API 密鑰來進行認證。

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 返回 401 Unauthorized 回應：

{
  "code": 401,
  "message": "Unauthorized"
}

常見原因：