开始使用
应该使用哪种集成方式？
新集成优先使用原生 Kyren Checkout。只有在你已经有 Epay 风格集成，并希望保留大部分现有 SDK 或请求结构时，才使用 Epay 兼容。 阅读：开始使用、Epay 兼容迁移。不写 API，可以在控制台创建付款吗？
可以。你可以在商户控制台创建产品和 Checkout 链接。若需要自动创建收银台，请使用 API。 阅读：产品控制台、Checkout 控制台、快速开始。金额应该用什么格式？
使用十进制字符串，不要使用浮点 JSON 数字。例如发送"9.99"，不要发送 9.99。
阅读：金额、币种或时间戳校验失败。
API 和 Webhook
为什么 API 请求返回 401？
常见原因包括缺少x-api-key、Key 错误、使用了错误环境的 Key，或开启 IP 白名单后来源 IP 不匹配。不要在浏览器代码中暴露密钥。
阅读：API 请求返回 401、认证。
为什么 Webhook 签名验证失败？
请检查原始请求体、正确的 Webhook secret、毫秒级时间戳、签名字符串拼接方式，以及是否使用恒定时间比较。 阅读：Webhook 签名验证失败、Webhook 签名。为什么客户付款了但没有加积分？
检查 Kyren 订单是否已支付、你的服务器是否收到并处理order.paid 事件、履约逻辑是否幂等，以及创建 Checkout 时是否在 metadata 中保存了内部用户或订单 ID。
阅读：客户已付款但未到账。
控制台和运营
在哪里查订单？
使用订单控制台搜索并查看支付状态。咨询具体支付问题时，请向支持提供 Kyren 订单号。 阅读：订单控制台、订单状态不符合预期。为什么无法结算？
结算资格可能取决于 KYC/KYB 状态、可用余额、待结余额、冻结资金和配置阈值。Kyren 支持可以协助查看，但文档不能保证审批或时间。 阅读：未满足结款条件。联系支持时应该提供什么？
提供商户账户、受影响流程、订单号或 Checkout Session ID、时间戳、端点或控制台页面、响应状态和已脱敏日志。不要发送完整 API Key、Webhook secret、卡数据或私密凭证。 阅读：支持升级清单。Epay 兼容
可以继续使用 Epay 风格 SDK 吗？
很多情况下可以。你需要替换 Base URL，使用 Kyren 签发的pid 和商户密钥，验证 MD5 签名，并将支付类型映射到 Kyren 支持的值。
阅读：Epay 迁移清单。
Epay MD5 签名怎么算？
移除sign、sign_type 和空值；按 key 排序剩余参数；用 & 拼接成 k=v；直接在末尾追加商户密钥；然后计算小写 MD5。
阅读：Epay MD5 签名。