支付网关接入规范
为您提供稳定、合规的代收通道。支持 SHA256WithRSA 高级别加密验签，保障商户资金安全。
SHA256WithRSA 签名
JSON 数据格式
毫秒级异步回调
01
统一下单接口
用于服务器后端创建订单，并返回收银台链接。
POST
/api/pay/create
请求地址：https://web.lynli.me/api/pay/create
提交格式：application/x-www-form-urlencoded
请求参数：
| 参数名 | 必填 | 说明 |
|---|---|---|
| pid | 是 | 商户 ID |
| type | 是 | 支付方式：alipay 或 usdt |
| out_trade_no | 是 | 商户订单号，需保持唯一 |
| notify_url | 是 | 服务器异步通知地址 |
| return_url | 是 | 支付后页面跳转地址 |
| name | 是 | 商品名称 |
| money | 是 | 订单金额，单位元，最多 2 位小数 |
| param | 否 | 业务扩展参数，支付后原样返回 |
| clientip | 否 | 用户 IP，不传则使用请求 IP |
| timestamp | 是 | 10 位秒级时间戳 |
| sign | 是 | RSA 签名（见下方说明） |
| sign_type | 是 | 固定传 RSA |
返回示例：
复制
{
"code": 0,
"msg": "success",
"trade_no": "202606130001000001",
"out_trade_no": "M202606130001",
"pay_type": "jump",
"payurl": "https://web.lynli.me/cashier/202606130001000001",
"qrcode": "https://web.lynli.me/cashier/202606130001000001",
"timestamp": "1781270400",
"sign_type": "RSA",
"sign": "..."
}
02
订单查询接口
POST
/api/pay/query
请求地址：https://web.lynli.me/api/pay/query
请求参数：
| 参数名 | 必填 | 说明 |
|---|---|---|
| pid | 是 | 商户 ID |
| timestamp | 是 | 10 位秒级时间戳，有效期约 5 分钟 |
| sign | 是 | RSA 签名 |
| sign_type | 是 | 固定传 RSA |
| trade_no | 二选一 | 平台订单号 |
| out_trade_no | 二选一 | 商户订单号 |
返回字段：
| 字段名 | 说明 |
|---|---|
| code | 0 为成功 |
| trade_no | 平台订单号 |
| out_trade_no | 商户订单号 |
| status | 1 为已支付，0 为未支付 |
| money | 订单金额 |
| type | 支付方式 |
| addtime | 创建时间 |
| endtime | 支付完成时间 |
03
关闭订单接口
POST
/api/pay/close
请求地址：https://web.lynli.me/api/pay/close
请求参数：
| 参数名 | 必填 | 说明 |
|---|---|---|
| pid | 是 | 商户 ID |
| timestamp | 是 | 10 位秒级时间戳，请求有效期约 5 分钟 |
| sign | 是 | RSA 签名 |
| sign_type | 是 | 固定传 RSA |
| trade_no | 二选一 | 平台订单号 |
| out_trade_no | 二选一 | 商户订单号 |
说明：仅未支付订单可关闭。
04
支付结果通知
订单支付成功后，平台会向商户传入的 notify_url 发起 GET 通知。
💡 通知签名说明：
通知签名跟随下单接口：V2接口使用 RSA；V1兼容接口使用 MD5。
通知签名跟随下单接口：V2接口使用 RSA；V1兼容接口使用 MD5。
通知参数：
| 字段名 | 说明 |
|---|---|
| pid | 商户 ID |
| trade_no | 平台订单号 |
| out_trade_no | 商户订单号 |
| type | 支付方式 |
| name | 商品名称 |
| money | 订单金额 |
| trade_status | 支付成功固定为 TRADE_SUCCESS |
| param | 业务扩展参数 |
| sign/sign_type | V2为RSA验签参数；V1为MD5验签参数 |
| timestamp | 仅V2 RSA通知携带 |
⚠️ 处理规则：商户系统验签成功并确认订单状态后，必须返回纯文本
success，否则平台将判定通知失败并重复发送。
05
RSA 签名规则 (V2)
生成签名 (请求)
1. 取所有非空普通参数，排除 sign、sign_type 和数组参数。
2. 按参数名 ASCII 升序排序。
3. 拼接为 key=value&key2=value2 格式。
4. 使用商户私钥执行 SHA256WithRSA 签名，将结果进行 Base64 编码。
验证签名 (回调/返回)
接口返回、异步通知均使用平台私钥签名。商户系统按同样规则拼接待签名字符串，再用平台公钥验签。
待签名串示例
复制
money=1.00&name=支付测试¬ify_url=https://merchant.example.com/notify_url.php&out_trade_no=202606130001&pid=1001&return_url=https://merchant.example.com/return_url.php×tamp=1781270400&type=alipay
06
商户相关接口 (补充)
GET
/api/merchant/balance
查询当前商户可提现余额与待结算资金。
返回示例：
复制
{
"code": 0,
"data": {
"balance": "1000.00",
"pending": "50.00"
}
}
07
SDK 工具包下载
为降低您的开发成本，我们提供了封装好 RSA 签名算法的官方 SDK。请下载后修改 epay.config.php，填入商户 ID 与私钥即可使用。
PHP
PHP-SDK.zip (V2.1)
适配 ThinkPHP / Laravel 等主流框架
JAVA
Java-SDK.zip
正在整理中...