跳转到主要内容
如果你已经有 Epay 风格的集成，并希望在迁移到 Kyren Pay 时保留原有请求格式，请使用 Epay 兼容路径。新接入建议优先使用原生 Kyren Checkout，参考快速开始，因为原生 Checkout 直接使用 Kyren API 认证和当前订单模型。 通过这些兼容端点创建的 Epay 来源订单，会进入与原生 Checkout 订单相同的 Kyren 订单与结算系统。兼容层只影响入口路径和响应格式。

​
端点映射

原 Epay 路径方法用途Kyren 行为
/epay/submit.phpGET 或 POST页面跳转收银台创建或复用订单，然后返回 HTTP 302 到 /epay/redirect/{orderId} 或上游支付页面。
/epay/mapi.phpPOST服务端直连创建支付创建或复用订单，并根据渠道返回 payurl、qrcode、img、trade_no 等 Epay 风格字段。
/epay/api.php?act=orderGET 或 POST订单查询通过 out_trade_no 或 trade_no 查询。
/epay/api.php?act=refundGET 或 POST退款兼容路径当前返回不支持的兼容错误。退款需通过平台协助另行处理。

​
迁移流程

  1. 将 Epay 基础 URL 替换为 Kyren Pay API 基础 URL，并保留兼容路径。
  2. 使用 Kyren 发放的 pid 和商户密钥进行 Epay 兼容签名。
  3. Epay 兼容请求继续使用 pid + sign 认证。不要发送 x-api-key。
  4. 将支付 type 映射到支持值：alipay、wxpay、creditcard、crypto 或 paynow。
  5. 浏览器收银台流量接入 submit.php，服务端创建支付接入 mapi.php。
  6. 从 notify_url 的 GET 通知中校验支付结果，处理完成后返回纯文本 success。
  7. 使用 api.php?act=order 做兼容订单查询，并对账 Kyren 订单与结算。

​
相关页面