mapi.php direct payment creation

/epay/mapi.php is the server-to-server Epay compatibility endpoint. It accepts form POST, creates or reuses a Kyren order, and returns Epay-style response fields such as payurl, qrcode, img, and trade_no depending on the selected channel. This endpoint uses pid + sign, not x-api-key. Because it is server-to-server, it may be subject to the API IP allowlist when enabled. A failed allowlist check can return numeric code 0 with msg.

Parameters

Required parameters:

Parameter	Description
`pid`	Kyren-issued merchant Epay-compatible merchant ID.
`type`	Payment type. Supported values include `alipay`, `wxpay`, `creditcard`, `crypto`, and `paynow`.
`out_trade_no`	Your merchant order number.
`notify_url`	Merchant payment result notification URL.
`name`	Order or product name.
`money`	Decimal string amount, for example `"9.99"`.
`clientip`	End-user client IP collected by your server.
`sign`	Epay-compatible MD5 signature.
`sign_type`	Signature type, usually `MD5`.

Optional parameters:

Parameter	Description
`return_url`	Browser return URL when the channel uses a payment page.
`money_type`	Currency or money type if provided by your existing integration.
`device`	Optional device hint: `pc` or `mobile`. Reusing the same order number with a different Alipay/WeChat device flow can be rejected.
`display_merchant_name`	Per-payment merchant display name shown on Kyren intermediate payment pages.
`param`	Passthrough merchant metadata returned in notifications.
`userId`	Optional merchant user identifier passed to the payment gateway when supported.
`channel_param`	Optional JSON string for channel-specific fields.

Example request

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"

Success response example

{
  "code": 1,
  "trade_no": "K202605260001",
  "out_trade_no": "ORDER_10002",
  "payurl": "https://payment.kyren.io/epay/redirect/order_abc123"
}

Failure response example

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

See Epay MD5 signature and the mapi.php API reference.

Start Here

Dashboard Guide

Webhooks

Troubleshooting

Epay Migration

FAQ

References

mapi.php direct payment creation

Parameters

Example request

Success response example

Failure response example

​Parameters

​Example request

​Success response example

​Failure response example

Parameters

Example request

Success response example

Failure response example