协议规则

传输方式:HTTP

数据格式:JSON

签名算法:MD5

字符编码:UTF-8


[API]查询商户信息

URL地址:https://mpay.zicyun.cn/api.php?act=query&pid={商户ID}&key={商户密钥}

请求参数说明:

字段名变量名必填类型示例值描述
操作类型actStringquery此API固定值
商户IDpidInt10001234567890
商户密钥keyString89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i

返回结果:

字段名变量名类型示例值描述
返回状态码codeInt11为成功,其它值为失败
商户IDpidInt(14)1001所创建的商户ID
商户密钥keyString(32)89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i所创建的商户密钥
绑定QQ号qqInt1商户绑定的腾讯QQ号
商户状态activeInt11为正常,0为封禁
商户余额moneyString0.00商户所拥有的余额
结算账号accountStringpay@cccyun.cn结算的支付宝账号
结算姓名usernameString张三结算的支付宝姓名
分润比例rateString96如果不存在,则默认系统统一的分润比例
是否实名认证issmrzInt11为认证,其他值则是未认证

[API]查询单个订单

URL地址:https://mpay.zicyun.cn/api.php?act=order&pid={商户ID}&key={商户密钥}&out_trade_no={商户订单号}

请求参数说明:

字段名变量名必填类型示例值描述
操作类型actStringorder此API固定值
商户IDpidInt1001
商户密钥keyString89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i
商户订单号out_trade_noString20160806151343349

返回结果:

字段名变量名类型示例值描述
返回状态码codeInt11为成功,其它值为失败
返回信息msgString查询订单号成功!
易支付订单号trade_noString2016080622555342651码支付订单号
商户订单号out_trade_noString20160806151343349商户系统内部的订单号
支付方式typeStringalipayalipay:支付宝,tenpay:财付通,wxpay:微信支付
商户IDpidInt1001发起支付的商户ID
创建订单时间addtimeString2016-08-06 22:55:52
完成交易时间endtimeString2016-08-06 22:55:52
商品名称nameStringVIP会员
商品金额moneyString1.00
支付状态statusInt01为支付成功,0为未支付

[API]批量查询订单

URL地址:https://mpay.zicyun.cn/api.php?act=orders&pid={商户ID}&key={商户密钥}

请求参数说明:

字段名变量名必填类型示例值描述
操作类型actStringorders此API固定值
商户IDpidInt1001
商户密钥keyString89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i
查询订单数量limitInt20返回的订单数量,最大50

返回结果:

字段名变量名类型示例值描述
返回状态码codeInt11为成功,其它值为失败
返回信息msgString查询结算记录成功!
订单列表dataArray订单列表

发起支付请求

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

请求参数说明:

字段名变量名必填类型示例值描述
商户IDpidInt1001
支付方式typeStringalipayalipay:支付宝,tenpay:财付通,
qqpay:QQ钱包,wxpay:微信支付
商户订单号out_trade_noString20160806151343349
异步通知地址notify_urlString//www.cccyun.cc/notify_url.php服务器异步通知地址
跳转通知地址return_urlString//www.cccyun.cc/return_url.php页面跳转通知地址
商品名称nameStringVIP会员
商品金额moneyString1.00
网站名称sitenameString彩虹云任务
签名字符串signString202cb962ac59075b964b07152d234b70签名算法与支付宝签名算法相同
(money={商品金额}&name={商品名称}& notify_url={异步通知地址}&out_trade_no={商户订单号}&pid={商户ID}&return_url={同步通知地址}&sitename={站点名称}&type={支付方式}{商户密匙})
签名类型sign_typeStringMD5默认为MD5

支付结果通知

通知类型:服务器异步通知(notify_url)、页面跳转通知(return_url)

请求方式:GET

请求参数说明:


判断 MD5(money={支付金额}&name=测试商品&out_trade_no={商户订单号}&pid={商户ID}&trade_no={支付平台订单号}&trade_status=TRADE_SUCCESS&type={支付方式}) 是否跟 返回签名 一致
字段名变量名必填类型示例值描述
商户IDpidInt1001
易支付订单号trade_noString20160806151343349021码支付订单号
商户订单号out_trade_noString20160806151343349商户系统内部的订单号
支付方式typeStringalipayalipay:支付宝,qqpay:QQ钱包,wxpay:微信支付
商品名称nameStringVIP会员PS:可能会过滤空格或违法名称
商品金额moneyString1.00PS:实际付款金额可能跟商品金额不一致
支付状态trade_statusStringTRADE_SUCCESS
签名字符串signString202cb962ac59075b964b07152d234b70签名算法与支付宝签名算法相同
签名类型sign_typeStringMD5默认为MD5

SDK下载

Php_Sdk.zip
SDK版本:V1.0