Skip to main content
/epay/api.php 提供 Epay 兼容的运维动作。使用 act=order 查询迁移后的 Epay 风格订单。使用 act=refund 为符合条件的 Epay 来源订单提交退款。

​
订单查询

调用 GET 或 POST /epay/api.php?act=order，传入 pid、原始商户 key，以及 out_trade_no 或 trade_no 之一。 该端点为了兼容订单查询，使用原始商户 key 和 pid。开启 API IP 白名单时可能会校验来源 IP。
成功响应示例：
addtime 和 endtime 在该兼容查询暴露时是 Epay 兼容的日期时间字符串。 失败响应示例：

​
Paydify 订单确认

Paydify 易支付订单继续使用本页查询接口，不需要调用 Paydify API。查询结果的 type 为 crypto，money 是原商品计价金额，不是 USDT 付款数量。
  • 查询 code=1 只表示查询成功。status=1 对应已确认的本地 PAID/SETTLED；其余状态返回 0，不能仅凭 0 区分待支付、失败或关闭。
  • 上游回调经验证并主动查询确认金额、币种及订单关联后，才更新本地付款状态并发送既有易支付 GET 通知。通知仍使用 trade_status=TRADE_SUCCESS、MD5 签名和原商品金额。
  • 商户应验签、核对订单和金额、幂等处理，再返回纯文本 success。浏览器回跳和上游创建成功不是资金到账证据。
  • 本次 Paydify 接入不新增退款能力，不应因存在通用 act=refund 就假定该通道支持退款。

​
退款兼容

调用 GET 或 POST /epay/api.php?act=refund，传入 pid、原始商户 key、money，以及 out_trade_no 或 trade_no 之一。 该路径只用于通过 Epay 兼容端点创建的订单。原生 Kyren API 订单应使用原生退款 API。商户账户必须已开通退款权限，且订单仍有足够的可退金额。 可选的 refund_no 用于幂等。如果不传，Kyren 会使用订单 ID 和标准化后的退款金额生成兼容幂等键。
响应示例：
查看 api.php API 参考。