聚合支付接口文档

API协议接入规则

传输方式:HTTPS 请求方式:GET/POST 签名算法:MD5 字符编码:UTF-8

API提交付款接口

请求API地址:

网关提交地址:https://(隐藏)/payment.do 登录商户后台查看

请求参数说明:

字段名 变量名 是否必填 加入签名 描述
商户ID parter 宝龙支付所创建的商户ID
支付方式 type 查看API支付产品编码
订单金额 value 精确到小数点后两位,例如10.28
商户订单号 orderid 商户订单号,该值需在商户网站内唯一
充值账号 account 用于游戏充值时,可传入玩家账号
异步通知 callbackurl 支付成功后回调地址
同步通知 hrefbackurl 支付成功后会跳转到这个地址
联系方式 contact 用于游戏充值时,可传入玩家联系方式
商品名称 subject 第三方支付平台,付款界面展示的商品名称
用户IP payerIp 用户支付IP地址,例如127.0.0.1
自定义参数 param 原封返回,避免特殊字符
返回json format 值:json 返回json格式,为空跳转支付页面
备注消息 attach 备注信息,原样返回
md5签名 sign 32位小写md5签名值,请参考签名算法
提交md5签名

按顺序排序拼接

拼接顺序:"parter="+parter+"&type="+type+"&value="+value+"&orderid="+orderid+"&account="+account+"&callbackurl="+callbackurl+key
$md5String="parter={$parter}&type={$type}&value={$value}&orderid={$orderid}&account={$account}&callbackurl={$callbackurl}$key";
$sign=md5(urlencode($md5String));
上行为PHP语言拼接案例,其他语言自行拼接,key 为宝龙支付商户签名密钥。
API回调通知接口

通知类型:服务器异步通知(callbackurl)

请求方式:GET

当订单支付成功后 宝龙支付 会立即向你填写的通知地址发起回调通知

回调参数说明:

字段名 变量名 加入签名 描述
商户订单号 orderid 商户网站的订单号
订单结果 opstate 0 支付成功 1 请求参数无效 2 签名错误
订单金额 ovalue 提交订单金额,单位(元)
付款金额 ovaluesuc 订单实际支付金额,单位(元)
平台订单号 sysorderid 宝龙支付平台的订单号
订单时间 systime 订单完成时间:格式 2014/02/15 18:42:28
备注信息 attach 提交支付的attach原样返回
MD5签名 sign 验证订单是否为合法

注意: 订单回调参数如有中文,PHP语言请用 $url = urlencode('参数名') 解码,其他语言写法不同。

回调md5签名

拼接顺序:"orderid="+orderid+"&opstate="+opstate+"&ovalue="+ovalue+key
$signStr="orderid={$orderid}&opstate={$opstate}&ovalue={$ovalue}$key";
$mysign=md5(urlencode($signStr));
上行为PHP语言拼接,其他语言自行拼接,key 为宝龙支付商户签名密钥。
商户收到通知参数,在校验通过后需要给宝龙支付接口返回一个字符串 success 的结果,如通知失败,会重复通知5次。
API订单查询接口

URL网关订单查询地址:http://(隐藏)/Query.do 登录商户后台查看

请求方式:GET/POST

注意:Order 为宝龙支付平台的订单号

请求参数说明:

字段名 变量名
订单号 Order

接口返回:

参数 描述
{"status": "error"} 订单号为空!
{"status": "not_exist"} 订单不存在!
{"status": "new"} 新订单,未支付!
{"status": "success"} 订单已支付!
API支付产品编码

支付产品名称 银行编码
支付宝 alipay
微信支付 wxpay
Demo下载

编写语言 下载地址
JAVA
PHP
ASP
C#