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 參考。