mapi.php 直连创建支付 - Kyren Pay

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

参数

必填参数：

参数	说明
`pid`	Kyren 发放的商户 Epay 兼容商户 ID。
`type`	支付类型。支持值包括 `alipay`、`wxpay`、`creditcard`、`crypto`、`paynow`。
`out_trade_no`	你的商户订单号。
`notify_url`	商户支付结果通知 URL。
`name`	订单或商品名称。
`money`	十进制字符串金额，例如 `"9.99"`。
`clientip`	你的服务端采集到的终端用户 IP。
`sign`	Epay 兼容 MD5 签名。
`sign_type`	签名类型，通常为 `MD5`。

可选参数：

参数	说明
`return_url`	渠道需要支付页时使用的浏览器返回 URL。
`money_type`	你的现有集成传入的币种或金额类型。
`device`	可选设备提示：`pc` 或 `mobile`。同一订单号复用到不同支付宝/微信设备支付形态时可能被拒绝。
`display_merchant_name`	本次支付在 Kyren 中间页展示的商户名称。
`param`	商户透传元数据，会在通知中返回。
`userId`	可选的商户用户标识；渠道支持时会传给支付网关。
`channel_param`	可选的渠道扩展 JSON 字符串。

请求示例

curl -X POST https://api.kyrenpay.com/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://payment.kyren.io/epay/redirect/order_abc123"
}

失败响应示例

{
  "code": 0,
  "msg": "IP not allowed"
}

查看 Epay MD5 签名和 mapi.php API 参考。