📖 亚泰支付 · V2 新版文档RSA 签名
RSA 签名(SHA256WithRSA)· 更安全的接口鉴权 · 推荐新商户使用
协议规则
| 请求数据格式 | application/x-www-form-urlencoded |
|---|---|
| 返回数据格式 | JSON |
| 字符编码 | UTF-8 |
| 签名算法 | RSA (SHA256WithRSA),商户 keytype=1 时强制使用 |
本页为 V2 文档,使用 RSA 签名。若你使用的是 MD5 签名,请切换到 V1 文档。
签名算法
通用步骤
1、取所有请求参数(不含数组、文件等),剔除 sign、sign_type 和空值。
2、按参数名 ASCII 码从小到大排序(a→z)。
3、拼接成 a=b&c=d&e=f 格式(不要 URL 编码)。
4、得到待签名字符串 signStr。
RSA 签名(V2)
sign = base64_encode( openssl_sign( signStr, 商户私钥, SHA256WithRSA ) )
前置步骤:先在商户后台 → 个人资料 → API信息 生成「商户 RSA 密钥对」,把 商户私钥 保存到你的服务器代码中(不要泄露)。
平台公钥用于验证接口返回数据的签名(回调通知的验签)。
V2 接口请求必须携带
timestamp(10 位秒级整数),且与服务器时间相差 ≤ 300 秒,否则会返回「时间戳字段不正确」。支付方式列表
| 调用值(type) | 描述 |
|---|---|
alipay | 支付宝 |
wxpay | 微信支付 |
usdt.trc20 | USDT(TRC20) |
| 更多支付方式以商户后台实际可用为准 | |
设备类型列表
| 值 | 描述 | 说明 |
|---|---|---|
pc | 电脑浏览器 | 默认 |
mobile | 手机浏览器 | |
qq | 手机QQ内浏览器 | 服务器内部归为 mobile |
wechat | 微信内浏览器 | 服务器内部归为 mobile |
alipay | 支付宝客户端 | 服务器内部归为 mobile |
app | APP 内 | 服务器内部归为 mobile |
jump | 仅返回跳转 URL | 仅 API 支付支持,等于 method=jump |
页面跳转支付
用于前台直接发起支付,支持 GET 或 POST。
https://pay.yunzexinda.com/submit.php
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|---|
| 商户ID | pid | 是 | Int | 1001 | 商户后台编号 |
| 支付方式 | type | 否 | String | alipay | 不传则跳收银台 |
| 商户订单号 | out_trade_no | 是 | String | 20261016001 | 只能含 a-zA-Z0-9.\_-| |
| 异步通知地址 | notify_url | 是 | String | http://你的域名/notify.php | 必须是完整 URL |
| 跳转通知地址 | return_url | 是 | String | http://你的域名/return.php | 支付完成后浏览器跳转 |
| 商品名称 | name | 是 | String | VIP会员 | 超过 127 字节自动截断 |
| 商品金额 | money | 是 | String | 1.00 | 单位:元,最多 2 位小数 |
| 业务扩展参数 | param | 否 | String | 支付后原样返回 | |
| 指定通道ID | channel_id | 否 | Int | 不传由系统自动分配 | |
| 身份证号 | cert_no | 否 | String | 部分业务需要 | |
| 真实姓名 | cert_name | 否 | String | 部分业务需要 | |
| 最低年龄 | min_age | 否 | Int | 部分业务需要 | |
| 签名字符串 | sign | 是 | String | 见「签名算法」 | |
| 签名类型 | sign_type | 是 | String | RSA | 与商户 keytype 匹配 |
⚠️ 注意:此接口 不支持
clientip 和 device 参数,系统自动识别 IP 和设备。不要传,传了也不会被使用。返回结果
{
"code": 1,
"msg": "",
"trade_no": "20261016123456789",
"out_trade_no": "20261016001",
"payurl": "https://pay.yunzexinda.com/paypage/mapay.php?trade_no=20261016123456789"
}
拿到 payurl 后 302 跳转或 window.location 跳转即可让用户付款。
API接口支付(服务器调用)
用于服务端发起支付,返回支付二维码 / 跳转链接,不直接给用户看。
https://pay.yunzexinda.com/mapi.php
请求方式:POST(仅支持 POST,不接受 GET)
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|---|
| 商户ID | pid | 是 | Int | 1001 | |
| 支付方式 | type | 是 | String | alipay | method=scan 时可省 |
| 商户订单号 | out_trade_no | 是 | String | 20261016001 | 只能含 a-zA-Z0-9.\_-| |
| 异步通知地址 | notify_url | 是 | String | http://你的域名/notify.php | |
| 跳转通知地址 | return_url | 否 | String | http://你的域名/return.php | |
| 商品名称 | name | 是 | String | VIP会员 | |
| 商品金额 | money | 是 | String | 1.00 | |
| 用户IP | clientip | 是 | String | 1.2.3.4 | 必须是合法 IPv4/IPv6 |
| 设备类型 | device | 否 | String | pc | 默认 pc |
| 支付场景 | method | 否 | String | web | web / jump / jsapi / scan |
| 公众号OpenID | sub_openid | 否 | String | method=jsapi 时必填 | |
| 子商户AppID | sub_appid | 否 | String | ||
| 是否小程序 | is_applet | 否 | Int | 0/1 | |
| 付款码 | auth_code | 否 | String | method=scan 时必填 | |
| 业务扩展参数 | param | 否 | String | ||
| 指定通道ID | channel_id | 否 | Int | ||
| 身份证号 | cert_no | 否 | String | ||
| 真实姓名 | cert_name | 否 | String | ||
| 最低年龄 | min_age | 否 | Int | ||
| 时间戳 | timestamp | 是 | Int | 1721206072 | 10位秒级,±300秒内有效 |
| 签名字符串 | sign | 是 | String | ||
| 签名类型 | sign_type | 是 | String | RSA |
返回结果(JSON)
{
"code": 0,
"trade_no": "20261016123456789",
"pay_type": "jump", // jump | qrcode | html
"pay_info": "https://..."
}
1.
2.
3.
code=0 表示成功。2.
code=-3 签名错误;code=-4 参数缺失。3.
clientip 必须是合法 IP。
支付结果通知(异步)
订单支付成功后,平台会 GET 请求你提交的 notify_url。
收到后请返回纯文本 success(无引号无空格),否则平台会重试多次。
| 字段名 | 变量名 | 类型 | 说明 |
|---|---|---|---|
| 商户ID | pid | Int | |
| 平台订单号 | trade_no | String | 亚泰支付系统内订单号 |
| 商户订单号 | out_trade_no | String | 发起支付时的订单号 |
| 支付方式 | type | String | 如 alipay |
| 商品名称 | name | String | |
| 商品金额 | money | String | |
| 交易状态 | trade_status | String | 只有 TRADE_SUCCESS 是成功 |
| 业务扩展参数 | param | String | 原样返回 |
| 签名字符串 | sign | String | 使用平台公钥验证(RSA) |
| 签名类型 | sign_type | String | RSA |
建议处理逻辑:验签通过 → 检查 trade_status 是否为 TRADE_SUCCESS → 更新你的订单 → 输出
success[API] 查询商户信息
GET https://pay.yunzexinda.com/api.php?act=query&pid={商户ID}&key={商户KEY}
使用 商户KEY 明文校验。
{
"code": 1,
"pid": 1001,
"key": "...",
"active": 1,
"money": "0.00",
"type": 1,
"account": "...",
"username": "...",
"orders": 30,
"orders_today": 15,
"orders_lastday": 15
}
[API] 查询结算记录
GET https://pay.yunzexinda.com/api.php?act=settle&pid={商户ID}&key={商户KEY}&limit=20&offset=0
可选参数:limit(最大 50)、offset(起始位置)
{
"code": 1,
"msg": "查询结算记录成功!",
"data": [ { ... 结算记录数组 ... } ]
}
[API] 查询单个订单
GET https://pay.yunzexinda.com/api.php?act=order&pid={商户ID}&key={商户KEY}&trade_no={平台订单号}
或:&out_trade_no={商户订单号},二选一。
{
"code": 1,
"msg": "succ",
"trade_no": "20261016123456789",
"out_trade_no": "20261016001",
"api_trade_no": "",
"type": "alipay",
"pid": 1001,
"addtime": "2026-10-16 12:00:00",
"endtime": "2026-10-16 12:01:00",
"name": "VIP会员",
"money": "1.00",
"param": "",
"buyer": "",
"status": 1,
"payurl": ""
}
[API] 批量查询订单
GET https://pay.yunzexinda.com/api.php?act=orders&pid={商户ID}&key={商户KEY}&limit=20&offset=0&status=1
可选参数:limit(最大 50)、offset、status
{
"code": 1,
"msg": "查询订单记录成功!",
"count": 20,
"data": [ { "trade_no": "...", "out_trade_no": "...", "status": 1 }, ... ]
}
[API] 订单退款
需先在商户后台开启「订单退款 API 接口」开关
POST https://pay.yunzexinda.com/api.php?act=refund
| 字段名 | 变量名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 商户ID | pid | 是 | Int | |
| 商户KEY | key | 是 | String | 明文 |
| 平台订单号 | trade_no | 二选一 | String | |
| 商户订单号 | out_trade_no | 二选一 | String | |
| 退款金额 | money | 是 | String | 单位:元 |
{
"code": 0,
"msg": "退款成功!退款金额¥1.00",
"refund_no": "...",
"trade_no": "...",
"money": "1.00",
"reducemoney": "1.00"
}
注意:
code=0 才是成功。SDK 下载
📦
亚泰支付 V2 SDK
PHP 版 SDK · RSA 签名 · 含支付 / 查询 / 退款完整示例
⬇ 下载 SDK_2.0.zip
📂 压缩包内容:
SDK/index.php ← 发起支付示例
SDK/epayapi.php ← 页面跳转支付演示
SDK/notify_url.php ← 异步通知处理
SDK/return_url.php ← 同步回调处理
SDK/query.php ← 订单查询
SDK/refund.php ← 订单退款
SDK/lib/EpayCore.class.php ← 核心类(RSA 签名实现)
SDK/lib/epay.config.php ← 配置文件
SDK/index.php ← 发起支付示例
SDK/epayapi.php ← 页面跳转支付演示
SDK/notify_url.php ← 异步通知处理
SDK/return_url.php ← 同步回调处理
SDK/query.php ← 订单查询
SDK/refund.php ← 订单退款
SDK/lib/EpayCore.class.php ← 核心类(RSA 签名实现)
SDK/lib/epay.config.php ← 配置文件
💡 使用说明:
1. 下载后解压,修改
2. 参考
3. 完整的对接流程参见本页上方各章节。
1. 下载后解压,修改
lib/epay.config.php 里的商户 ID / KEY / API 地址。2. 参考
index.php 发起支付,notify_url.php 处理异步回调。3. 完整的对接流程参见本页上方各章节。