支付接口介绍

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

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





接口申请方式

共有两种接口模式:

(一)普通支付商户
可以获得一个支付商户,完全免费申请。公测期间请联系人工申请QQ690155,申请之后会将商户ID和商户KEY给你!

(二)合作支付商户
获得一个合作者身份TOKEN,可以集成到你开发的程序里面,通过接口无限申请普通支付商户,并且每个普通支付商户单独结算,相对独立。公测期间请联系人工申请QQ690155,申请之后会将合作者身份TOKEN给你!


协议规则

传输方式:HTTP

数据格式:JSON

签名算法:MD5

字符编码:UTF-8





[API]创建商户

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

URL地址:http://pay.danbaiyun.cn/api.php?act=apply&token={合作者身份TOKEN}&url={商户域名}

请求参数说明:

字段名 变量名 必填 类型 示例值 描述
操作类型 act String apply 此API固定值
合作者TOKEN token String 9ddab6c4f2c87ce442de371b04f36d68 需要事先申请
商户域名 url String pay.danbaiyun.cn  

返回结果:

字段名 变量名 类型 示例值 描述
返回状态码 code Int 1 1为成功,其它值为失败
返回信息 msg String 添加支付商户成功!  
商户ID pid Int 1001 所创建的商户ID
商户密钥 key String(32) 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i 所创建的商户密钥
商户类型 type Int 1 此值暂无用





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

URL地址:http://pay.danbaiyun.cn/api.php?act=query&pid={商户ID}&key={商户密钥}

请求参数说明:

字段名 变量名 必填 类型 示例值 描述
操作类型 act String query 此API固定值
商户ID pid Int 1001  
商户密钥 key String 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i  

返回结果:

字段名 变量名 类型 示例值 描述
返回状态码 code Int 1 1为成功,其它值为失败
商户ID pid Int 1001 所创建的商户ID
商户密钥 key String(32) 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i 所创建的商户密钥
商户类型 type Int 1 此值暂无用
商户状态 active Int 1 1为正常,0为封禁
商户余额 money String 0.00 商户所拥有的余额
结算账号 account String [email protected] 结算的支付宝账号
结算姓名 username String 张三 结算的支付宝姓名
满多少自动结算 settle_money String 30 此值为系统预定义
手动结算手续费 settle_fee String 1 此值为系统预定义
每笔订单分成比例 money_rate String 98 此值为系统预定义





[API]修改结算账号

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

请求参数说明:

字段名 变量名 必填 类型 示例值 描述
操作类型 act String change 此API固定值
商户ID pid Int 1001  
商户密钥 key String 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i  
结算账号 account String [email protected] 结算的支付宝账号
结算姓名 username String 张三 结算的支付宝姓名

返回结果:

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




[API]查询结算记录

URL地址:http://pay.danbaiyun.cn/api.php?act=settle&pid={商户ID}&key={商户密钥}

请求参数说明:

字段名 变量名 必填 类型 示例值 描述
操作类型 act String settle 此API固定值
商户ID pid Int 1001  
商户密钥 key String 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i  

返回结果:

字段名 变量名 类型 示例值 描述
返回状态码 code Int 1 1为成功,其它值为失败
返回信息 msg String 查询结算记录成功!  
结算记录 data Array 结算记录列表  






[API]查询单个订单

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

请求参数说明:

字段名 变量名 必填 类型 示例值 描述
操作类型 act String order 此API固定值
商户ID pid Int 1001  
商户密钥 key String 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i  
商户订单号 out_trade_no String 20160806151343349  

返回结果:

字段名 变量名 类型 示例值 描述
返回状态码 code Int 1 1为成功,其它值为失败
返回信息 msg String 查询订单号成功!  
易支付订单号 trade_no String 2016080622555342651 蛋白云支付订单号
商户订单号 out_trade_no String 20160806151343349 商户系统内部的订单号
支付方式 type String alipay alipay:支付宝,tenpay:财付通,
qqpay:QQ钱包,wxpay:微信支付
商户ID pid Int 1001 发起支付的商户ID
创建订单时间 addtime String 2016-08-06 22:55:52  
完成交易时间 endtime String 2016-08-06 22:55:52  
商品名称 name String VIP会员  
商品金额 money String 1.00  
支付状态 status Int 0 1为支付成功,0为未支付




[API]批量查询订单

URL地址:http://pay.danbaiyun.cn/api.php?act=orders&pid={商户ID}&key={商户密钥}

请求参数说明:

字段名 变量名 必填 类型 示例值 描述
操作类型 act String orders 此API固定值
商户ID pid Int 1001  
商户密钥 key String 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i  
查询订单数量 limit Int 20 返回的订单数量,最大50

返回结果:

字段名 变量名 类型 示例值 描述
返回状态码 code Int 1 1为成功,其它值为失败
返回信息 msg String 查询结算记录成功!  
订单列表 data Array   订单列表




发起支付请求

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

请求参数说明:

字段名 变量名 必填 类型 示例值 描述
商户ID pid Int 1001  
支付方式 type String alipay alipay:支付宝,tenpay:财付通,
qqpay:QQ钱包,wxpay:微信支付
商户订单号 out_trade_no String 20160806151343349  
异步通知地址 notify_url String http://pay.danbaiyun.cn/notify_url.php 服务器异步通知地址
跳转通知地址 return_url String http://pay.danbaiyun.cn/return_url.php 页面跳转通知地址
商品名称 name String VIP会员  
商品金额 money String 1.00  
网站名称 sitename String 蛋白云支付  
签名字符串 sign String 202cb962ac59075b964b07152d234b70 签名算法与支付宝签名算法相同
签名类型 sign_type String MD5 默认为MD5




支付结果通知

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

请求方式:GET

请求参数说明:

字段名 变量名 必填 类型 示例值 描述
商户ID pid Int 1001  
易支付订单号 trade_no String 20160806151343349021 蛋白云支付订单号
商户订单号 out_trade_no String 20160806151343349 商户系统内部的订单号
支付方式 type String alipay alipay:支付宝,tenpay:财付通,
qqpay:QQ钱包,wxpay:微信支付
商品名称 name String VIP会员  
商品金额 money String 1.00  
支付状态 trade_status String TRADE_SUCCESS  
签名字符串 sign String 202cb962ac59075b964b07152d234b70 签名算法与支付宝签名算法相同
签名类型 sign_type String MD5 默认为MD5