Epay 兼容迁移 - Kyren Pay

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

端点映射

原 Epay 路径	方法	用途	Kyren 行为
`/epay/submit.php`	`GET` 或 `POST`	页面跳转收银台	创建或复用订单，然后返回 HTTP `302` 到 `/epay/redirect/{orderId}` 或上游支付页面。
`/epay/mapi.php`	`POST`	服务端直连创建支付	创建或复用订单，并根据渠道返回 `payurl`、`qrcode`、`img`、`trade_no` 等 Epay 风格字段。
`/epay/api.php?act=order`	`GET` 或 `POST`	订单查询	通过 `out_trade_no` 或 `trade_no` 查询。
`/epay/api.php?act=refund`	`GET` 或 `POST`	退款兼容路径	在开通退款权限后，为符合条件的 Epay 来源订单提交退款。

迁移流程

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

相关页面