开发文档 · V2 新版
切换到 V1(MD5) 返回首页

协议规则

请求数据格式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.trc20USDT(TRC20)
更多支付方式以商户后台实际可用为准

设备类型列表

值描述说明
pc电脑浏览器默认
mobile手机浏览器
qq手机QQ内浏览器服务器内部归为 mobile
wechat微信内浏览器服务器内部归为 mobile
alipay支付宝客户端服务器内部归为 mobile
appAPP 内服务器内部归为 mobile
jump仅返回跳转 URL仅 API 支付支持,等于 method=jump

页面跳转支付

用于前台直接发起支付,支持 GET 或 POST。

https://pay.yunzexinda.com/submit.php

请求参数

字段名变量名必填类型示例值说明
商户IDpid是Int1001商户后台编号
支付方式type否Stringalipay不传则跳收银台
商户订单号out_trade_no是String20261016001只能含 a-zA-Z0-9.\_-|
异步通知地址notify_url是Stringhttp://你的域名/notify.php必须是完整 URL
跳转通知地址return_url是Stringhttp://你的域名/return.php支付完成后浏览器跳转
商品名称name是StringVIP会员超过 127 字节自动截断
商品金额money是String1.00单位:元,最多 2 位小数
业务扩展参数param否String支付后原样返回
指定通道IDchannel_id否Int不传由系统自动分配
身份证号cert_no否String部分业务需要
真实姓名cert_name否String部分业务需要
最低年龄min_age否Int部分业务需要
签名字符串sign是String见「签名算法」
签名类型sign_type是StringRSA与商户 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)

请求参数

字段名变量名必填类型示例值说明
商户IDpid是Int1001
支付方式type是Stringalipaymethod=scan 时可省
商户订单号out_trade_no是String20261016001只能含 a-zA-Z0-9.\_-|
异步通知地址notify_url是Stringhttp://你的域名/notify.php
跳转通知地址return_url否Stringhttp://你的域名/return.php
商品名称name是StringVIP会员
商品金额money是String1.00
用户IPclientip是String1.2.3.4必须是合法 IPv4/IPv6
设备类型device否Stringpc默认 pc
支付场景method否Stringwebweb / jump / jsapi / scan
公众号OpenIDsub_openid否Stringmethod=jsapi 时必填
子商户AppIDsub_appid否String
是否小程序is_applet否Int0/1
付款码auth_code否Stringmethod=scan 时必填
业务扩展参数param否String
指定通道IDchannel_id否Int
身份证号cert_no否String
真实姓名cert_name否String
最低年龄min_age否Int
时间戳timestamp是Int172120607210位秒级,±300秒内有效
签名字符串sign是String
签名类型sign_type是StringRSA

返回结果(JSON)

{
  "code": 0,
  "trade_no": "20261016123456789",
  "pay_type": "jump",           // jump | qrcode | html
  "pay_info": "https://..."
}
1. code=0 表示成功。
2. code=-3 签名错误;code=-4 参数缺失。
3. clientip 必须是合法 IP。

支付结果通知(异步)

订单支付成功后,平台会 GET 请求你提交的 notify_url。

收到后请返回纯文本 success(无引号无空格),否则平台会重试多次。

字段名变量名类型说明
商户IDpidInt
平台订单号trade_noString亚泰支付系统内订单号
商户订单号out_trade_noString发起支付时的订单号
支付方式typeString如 alipay
商品名称nameString
商品金额moneyString
交易状态trade_statusString只有 TRADE_SUCCESS 是成功
业务扩展参数paramString原样返回
签名字符串signString使用平台公钥验证(RSA)
签名类型sign_typeStringRSA
建议处理逻辑:验签通过 → 检查 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
字段名变量名必填类型说明
商户IDpid是Int
商户KEYkey是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   ← 配置文件
💡 使用说明:
1. 下载后解压,修改 lib/epay.config.php 里的商户 ID / KEY / API 地址。
2. 参考 index.php 发起支付,notify_url.php 处理异步回调。
3. 完整的对接流程参见本页上方各章节。