协议规则

传输方式：HTTP

数据格式：JSON

签名算法：MD5

字符编码：UTF-8

[API]查询商户信息

URL地址：//yun.xbyzf.xyz/api.php?act=query&pid={商户ID}&key={商户密钥}

请求参数说明：

返回结果：

[API]查询单个订单

URL地址：//yun.xbyzf.xyz/api.php?act=order&pid={商户ID}&key={商户密钥}&out_trade_no={商户订单号}

请求参数说明：

返回结果：

[API]批量查询订单

URL地址：//yun.xbyzf.xyz/api.php?act=orders&pid={商户ID}&key={商户密钥}

请求参数说明：

返回结果：

发起支付请求

URL地址：//yun.xbyzf.xyz/submit.php?pid={商户ID}&type={支付方式}&out_trade_no={商户订单号}&notify_url={服务器异步通知地址}&return_url={页面跳转通知地址}&name={商品名称}&money={金额}&sitename={网站名称}&sign={签名字符串}&sign_type=MD5

请求参数说明：

[API]服务端下单(mapi)

URL地址：//yun.xbyzf.xyz/mapi.php

请求方式：POST（推荐，application/x-www-form-urlencoded），也兼容 GET。由商户服务器发起请求，不要在买家浏览器前端调用，以免泄露商户密钥。

请求参数说明（与 submit.php 一致，可额外携带 clientip、device 等扩展参数参与签名）：

签名算法：

1、将全部请求参数（不含 sign、sign_type，值为空的参数也不参与）按参数名 ASCII 字典序（ksort）从小到大排序；

2、拼接成 URL 键值对字符串（不做 urlencode）：money=1.00&name=VIP会员&notify_url=...&out_trade_no=...&pid=1001&type=alipay；

3、字符串末尾直接拼接商户密钥后做 MD5，小写：sign = md5(排序后的字符串 . 商户密钥)。

注：本接口同时兼容 submit.php 的固定顺序签名（money、name、notify_url、out_trade_no、pid、return_url、sitename、type 顺序拼接），两种签名通过任意一种即可。

返回结果（JSON）：

成功返回示例：

{"code":1,"msg":"下单成功","type":"json","payurl":"https:\/\/yun.xbyzf.xyz\/Submit\/Mcode_Pay.php?trade_no=2026092218501312345","qrcode":"https:\/\/qr.alipay.com\/fkx123","urlscheme":"alipays:\/\/platformapi\/startapp?saId=10000007&qrcode=...","orderid":"2026092218501312345","money":"1.00"}

失败返回示例：

{"code":-1,"msg":"签名校验失败，请检查商户PID/KEY"}

注意事项：

1、同一商户订单号（out_trade_no）在订单有效期内重复请求不会重复建单，接口直接返回原订单信息，因此遇到网络超时可安全重试；

2、请将商户服务器 cURL 连接超时设置为 10 秒以上、总超时 20 秒以上，避免订单已创建但响应超时；

3、支付结果一律以 支付结果异步通知(notify_url) 为准，不要以本接口返回作为到账依据。

支付结果通知

通知类型：服务器异步通知（notify_url）、页面跳转通知（return_url）

请求方式：GET

请求参数说明：

SDK下载

Php_Sdk.zip
SDK版本：V1.0