> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kyrenpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Epay 兼容迁移

> 将现有 Epay 风格集成迁移到 Kyren Pay 兼容端点。

如果你已经有 Epay 风格的集成，并希望在迁移到 Kyren Pay 时保留原有请求格式，请使用 Epay 兼容路径。新接入建议优先使用原生 Kyren Checkout，参考[快速开始](/zh/quickstart)，因为原生 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` | 退款兼容路径    | 当前返回不支持的兼容错误。退款需通过平台协助另行处理。                                     |

## 迁移流程

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`](/zh/epay-migration/submit-php)，服务端创建支付接入 [`mapi.php`](/zh/epay-migration/mapi-php)。
6. 从 `notify_url` 的 GET 通知中校验支付结果，处理完成后返回纯文本 `success`。
7. 使用 [`api.php?act=order`](/zh/epay-migration/api-php) 做兼容订单查询，并对账 Kyren 订单与结算。

## 相关页面

* [Epay MD5 签名](/zh/epay-migration/signature)
* [submit.php 跳转收银台](/zh/epay-migration/submit-php)
* [mapi.php 直连创建支付](/zh/epay-migration/mapi-php)
* [api.php 订单查询与退款兼容](/zh/epay-migration/api-php)
* [Epay 迁移检查清单](/zh/epay-migration/migration-checklist)