/epay/submit.php 是面向浏览器的 Epay 兼容端点。它会创建或复用 Kyren 订单,并返回 HTTP 302 到 /epay/redirect/{orderId} 或上游支付页面。
当客户浏览器需要跳转到收银台时使用此路径。该端点使用 pid + sign,不使用 x-api-key,终端用户浏览器访问不需要商户服务器 IP 白名单。
参数
必填参数:
可选参数:
Paydify:type=crypto
商户的加密货币一次性支付通道绑定 Paydify 后,沿用本页必填参数,将 type 设为 crypto,并按原规则重新计算 MD5 签名;不要使用 type=paydify。money_type 表示商品计价币种,省略时为 CNY,money 不填 USDT 数量。
- 成功响应为 HTTP
302,目标是 Kyren 本地/epay/redirect/{orderId},不是 Paydify 托管收银台。 - 买家在本地页选择后端提供的 App / 网络、确认应付 USDT 报价后才创建上游支付;商户不需要传 App、网络或
channel_param。 - 相同
out_trade_no重试必须保持原金额、币种和支付方式;刷新付款页恢复同一笔支付。不要因暂未完成付款而不断更换订单号。 - 入口受理和浏览器回跳不作为支付成功凭据;应校验异步通知,或通过鉴权订单查询确认。
表单示例
通知处理
付款完成后,Kyren 会向notify_url 发起 GET 请求,包含:
pid、trade_no、out_trade_no、type、name、money、trade_status、param、sign、sign_type。
校验签名,幂等处理结果,然后返回纯文本:
submit.php API 参考。