支付接口介绍

使用此接口可以实现支付宝、QQ钱包、微信支付的即时到账,免签约,无需企业认证。

本文阅读对象:商户系统(在线购物平台、人工收银系统、自动化智能收银系统或其他)集成彩虹云支付涉及的技术架构师,研发工程师,测试工程师,系统运维工程师。


接口申请方式

共有两种接口模式:

(一)普通支付商户
可以获得一个支付商户。请前往网址http://pay.chshuju.com进行申请,申请之后会将商户ID和商户KEY给你!

(二)合作支付商户
获得一个合作者身份TOKEN,可以集成到你开发的程序里面,通过接口无限申请普通支付商户,并且每个普通支付商户单独结算,相对独立。申请需要进行企业或开发者资质认证,请联系人工申请QQ800856677,申请之后会将合作者身份TOKEN给你!


协议规则

传输方式:HTTP

数据格式:JSON

签名算法:MD5

字符编码:UTF-8


[API]创建商户

API权限:该API只能合作支付商户调用

URL地址:http://api.zhaixiaolan/api.php?act=apply&pid=1034&token=TOKEN&email=邮件地址

请求参数说明:

字段名变量名必填类型示例值描述
操作类型actStringapply此API固定值
用户pidpid

string1034用户id
合作者TOKENtokenString9ddab6c4f2c87ce442de371b04f36d68需要事先申请
商户邮件emailStringadmin@javaw.me


返回结果:

字段名变量名类型示例值描述
返回状态码codeInt11为成功,其它值为失败
返回信息msgString添加支付商户成功!
商户IDpidInt1001所创建的商户ID
商户密钥keyString(32)89unJUB854Hj7x4nUj56HN4nUzUJ8i商户密钥
邮件发送send_emailbooleantrue

是否邮件通知

用户名userstringd2m21nqq登录账号
密码passwdstring89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i密码

[API]查询商户信息与结算规则

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

请求参数说明:

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

返回结果:

字段名变量名类型示例值描述
返回状态码codeInt11为成功,其它值为失败
商户IDpidInt1001所创建的商户ID
商户密钥keyString(32)89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i所创建的商户密钥
商户类型typeInt1此值暂无用
商户状态activeInt11为正常,0为封禁
商户余额moneyString0.00商户所拥有的余额
结算账号accountString1070077170@qq.com结算的支付宝账号
结算姓名usernameString张三结算的支付宝姓名
满多少自动结算settle_moneyString30此值为系统预定义
手动结算手续费settle_feeString1此值为系统预定义
每笔订单分成比例money_rateString98此值为系统预定义

[API]修改结算账号

URL地址:https://api.zhaixiaolan.com/api.php?act=change&pid={商户ID}&key={商户密钥}&account={结算账号}&username={结算姓名}

请求参数说明:

字段名变量名必填类型示例值描述
操作类型actStringchange此API固定值
商户IDpidInt1001
商户密钥keyString89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i
结算账号accountStringpay.svip结算的支付宝账号
结算姓名usernameString张三结算的支付宝姓名
类型sett_typeString11.微信 2.支付宝 3.QQ

返回结果:

字段名变量名类型示例值描述
返回状态码codeInt11为成功,其它值为失败
返回信息msgString修改收款账号成功!

[API]查询结算记录

URL地址:https://api.zhaixiaolan.com/api.php?act=settle&pid={商户ID}&key={商户密钥}

请求参数说明:

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

返回结果:

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

[API]查询单个订单

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

请求参数说明:

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

返回结果:

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


[API]批量查询订单

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

请求参数说明:

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

返回结果:

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


[API]订单退款申请

URL地址:https://api.zhaixiaolan/api.php?act=refund&pid={商户ID}&key={商户密钥}&trade_no={系统订单号}

请求参数说明:

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

系统订单号

返回结果:

字段名变量名类型示例值描述
返回状态码codeInt00为成功,其它值为失败
返回信息msgString

退款成功!



发起支付请求

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

请求方式说明:必须为POST请求

请求参数说明:

字段名变量名必填类型示例值描述
商户IDpidInt1001
支付方式typeStringalipayalipay:支付宝,tenpay:财付通,
qqpay:QQ钱包,wxpay:微信支付
商户订单号out_trade_noString20160806151343349
异步通知地址notify_urlStringhttp://www.cccyun.cc/notify_url.php服务器异步通知地址
跳转通知地址return_urlStringhttp://www.cccyun.cc/return_url.php页面跳转通知地址
商品名称nameStringVIP会员
商品金额moneyString1.00
网站名称sitenameString某某某平台
签名字符串signString202cb962ac59075b964b07152d234b70签名算法与支付宝签名算法相同
签名类型sign_typeStringMD5默认为MD5


支付结果通知

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

请求方式:GET

请求参数说明:

字段名变量名必填类型示例值描述
商户IDpidInt1001
易支付订单号trade_noString20160806151343349021易支付订单号
商户订单号out_trade_noString20160806151343349商户系统内部的订单号
支付方式typeStringalipayalipay:支付宝,tenpay:财付通,
qqpay:QQ钱包,wxpay:微信支付
名称nameStringVIP充值名称
商品金额moneyString1.00
支付状态trade_statusStringTRADE_SUCCESS
签名字符串signString202cb962ac59075b964b07152d234b70签名算法与支付宝签名算法相同
签名类型sign_typeStringMD5默认为MD5


SDK下载

通过商户中心下载插件和SDK