跳转到主要内容
/epay/mapi.php 是服务端到服务端的 Epay 兼容端点。它接收表单 POST，创建或复用 Kyren 订单，并根据所选渠道返回 payurl、qrcode、img、trade_no 等 Epay 风格字段。 该端点使用 pid + sign，不使用 x-api-key。由于它是服务端直连端点，开启 API IP 白名单时可能会校验来源 IP。白名单校验失败时可能返回数字 code 为 0，并附带 msg。

​
参数

必填参数：
参数说明
pidKyren 发放的商户 Epay 兼容商户 ID。
type支付类型。支持值包括 alipay、wxpay、creditcard、crypto、paynow。
out_trade_no你的商户订单号。
notify_url商户支付结果通知 URL。
name订单或商品名称。
money十进制字符串金额，例如 "9.99"。
clientip你的服务端采集到的终端用户 IP。
signEpay 兼容 MD5 签名。
sign_type签名类型，通常为 MD5。
可选参数：
参数说明
return_url渠道需要支付页时使用的浏览器返回 URL。
money_type你的现有集成传入的币种或金额类型。
device你的现有集成传入的设备上下文。
display_merchant_name本次支付在 Kyren 中间页展示的商户名称。
param商户透传元数据，会在通知中返回。
channel_param渠道相关扩展数据。

​
请求示例

curl -X POST https://api.kyren.top/epay/mapi.php \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "pid=10001" \
  --data-urlencode "type=alipay" \
  --data-urlencode "out_trade_no=ORDER_10002" \
  --data-urlencode "notify_url=https://merchant.example.com/notify" \
  --data-urlencode "name=AI credits" \
  --data-urlencode "money=9.99" \
  --data-urlencode "display_merchant_name=Campaign Store" \
  --data-urlencode "clientip=203.0.113.10" \
  --data-urlencode "sign=lowercase_md5_signature" \
  --data-urlencode "sign_type=MD5"

​
成功响应示例

{
  "code": 1,
  "trade_no": "K202605260001",
  "out_trade_no": "ORDER_10002",
  "payurl": "https://api.kyren.top/epay/redirect/order_abc123",
  "qrcode": "https://api.kyren.top/epay/qr/order_abc123",
  "img": "https://api.kyren.top/epay/qr/order_abc123.png"
}

​
失败响应示例

{
  "code": 0,
  "msg": "IP not allowed"
}
查看 Epay MD5 签名和 mapi.php API 参考。