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

参数

必填参数:
参数说明
pidKyren 发放的商户 Epay 兼容商户 ID。
type支付类型。支持值包括 alipaywxpaycreditcardcryptopaynow
out_trade_no你的商户订单号。
notify_url商户支付结果通知 URL。
return_url收银台结束后的浏览器返回 URL。
name订单或商品名称。
money十进制字符串金额,例如 "9.99"
signEpay 兼容 MD5 签名。
sign_type签名类型,通常为 MD5
可选参数:
参数说明
money_type你的现有集成传入的币种或金额类型。
display_merchant_name本次支付在 Kyren 中间页展示的商户名称。
param商户透传元数据,会在通知中返回。

表单示例

<form method="post" action="https://api.kyren.top/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 请求,包含: pidtrade_noout_trade_notypenamemoneytrade_statusparamsignsign_type 校验签名,幂等处理结果,然后返回纯文本:
success
查看 Epay MD5 签名submit.php API 参考