submit.php 跳转收银台 - Kyren Pay

/epay/submit.php 是面向浏览器的 Epay 兼容端点。它会创建或复用 Kyren 订单，并返回 HTTP 302 到 /epay/redirect/{orderId} 或上游支付页面。当客户浏览器需要跳转到收银台时使用此路径。该端点使用 pid + sign，不使用 x-api-key，终端用户浏览器访问不需要商户服务器 IP 白名单。

参数

必填参数：

参数	说明
`pid`	Kyren 发放的商户 Epay 兼容商户 ID。
`type`	支付类型。支持值包括 `alipay`、`wxpay`、`creditcard`、`crypto`、`paynow`。
`out_trade_no`	你的商户订单号。
`notify_url`	商户支付结果通知 URL。
`return_url`	收银台结束后的浏览器返回 URL。
`name`	订单或商品名称。
`money`	十进制字符串金额，例如 `"9.99"`。
`sign`	Epay 兼容 MD5 签名。
`sign_type`	签名类型，通常为 `MD5`。

可选参数：

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

表单示例

<form method="post" action="https://api.kyrenpay.com/epay/submit.php">
  <input type="hidden" name="pid" value="10001" />
  <input type="hidden" name="type" value="alipay" />
  <input type="hidden" name="out_trade_no" value="ORDER_10001" />
  <input type="hidden" name="notify_url" value="https://merchant.example.com/notify" />
  <input type="hidden" name="return_url" value="https://merchant.example.com/return" />
  <input type="hidden" name="name" value="AI credits" />
  <input type="hidden" name="money" value="9.99" />
  <input type="hidden" name="display_merchant_name" value="Campaign Store" />
  <input type="hidden" name="param" value="account_123" />
  <input type="hidden" name="sign" value="lowercase_md5_signature" />
  <input type="hidden" name="sign_type" value="MD5" />
  <button type="submit">Pay</button>
</form>

通知处理

付款完成后，Kyren 会向 notify_url 发起 GET 请求，包含： pid、trade_no、out_trade_no、type、name、money、trade_status、param、sign、sign_type。校验签名，幂等处理结果，然后返回纯文本：

success

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