本文档以雷霆传奇H5为例子,其他游戏也是大同小异。
注意:分区的回调地址,假如你的游戏网站域名是www.123.com,那么通知地址就是: http://www.123.com/pay/notify.php
对接完成后,将分组充值链接或者分区充值链接,添加到游戏网站的充值位置上即可。
请求方式:GET/POST
创建分组和分区,然后获取分区充值链接,这个充值链接可以作为请求提交地址,提交参数如下表:
假设分区充值链接为:https://(隐藏)/fenqu.do?token=2080080940816819971068721
字段名 | 变量名 | 是否必填 | 加入签名 | 描述 |
---|---|---|---|---|
商户ID | parter | 是 | 是 | 宝龙支付所创建的商户ID |
商户订单号 | orderid | 是 | 是 | 商户订单号,该值需在商户网站内唯一 |
充值账号 | account | 是 | 是 | 用于游戏充值时,可传入玩家账号 |
订单金额 | value | 是 | 是 | 精确到小数点后两位,例如10.28 |
支付方式 | type | 是 | 是 | 查看API支付产品编码 |
商品名称 | subject | 否 | 否 | 第三方支付平台,付款界面展示的商品名称 |
联系方式 | contact | 否 | 否 | 用于游戏充值时,可传入玩家联系方式 |
md5签名 | sign | 是 | 否 | 32位小写md5签名值,请参考签名算法 |
按顺序排序拼接
拼接顺序:"parter=" + parter + "&type=" + type + "&value=" + value + "&orderid=" + orderid + "&account=" + account + key |
$md5String="parter={$parter}&type={$type}&value={$value}&orderid={$orderid}&account={$account}$key"; |
$sign=md5(urlencode($md5String)); |
上行为PHP语言拼接案例,其他语言自行拼接,key 为宝龙支付商户签名密钥。 |
通知类型:服务器异步通知(callbackurl)
请求方式:GET
当订单支付成功后 宝龙支付 会立即向你填写的通知地址发起回调通知
字段名 | 变量名 | 加入签名 | 描述 |
---|---|---|---|
商户订单号 | orderid | 是 | 商户网站的订单号 |
订单结果 | opstate | 是 | 0 支付成功 1 请求参数无效 2 签名错误 |
订单金额 | ovalue | 是 | 提交订单金额,单位(元) |
付款金额 | ovaluesuc | 是 | 订单实际支付金额,单位(元) |
充值比例 | scale | 否 | 原样返回 |
平台订单号 | sysorderid | 否 | 宝龙支付平台的订单号 |
充值账号 | account | 否 | 用户提交的充值账号 |
商品说明 | subject | 否 | 原样返回 |
附件参数 | param | 否 | 原样返回 |
支付产品 | type | 否 | 支付产品编号 |
联系方式 | contact | 否 | 用户填写的联系方式比如QQ、微信、手机号码 |
分区ID | quid | 否 | 商户可以判断指定分区 |
分区名称 | quname | 否 | 原样返回 |
游戏币 | alias | 否 | 如元宝、钻石、点券、金币等 |
数据库名称 | dbname | 否 | 原样返回 |
VIP会员等级 | vip | 否 | 启用充值送会员功能时,此参数为商户设定的VIP等级 |
订单时间 | systime | 否 | 订单完成时间:格式 2014/02/15 18:42:28 |
备注信息 | attach | 否 | 提交支付的attach原样返回 |
MD5签名 | sign | 否 | 验证订单是否为合法 |
注意: 订单回调参数如有中文,PHP语言请用 $url = urlencode('参数名') 解码,其他语言写法不同。
拼接顺序:"orderid="+orderid+"&opstate="+opstate+"&ovalue="+ovalue+key |
$signStr="orderid={$orderid}&opstate={$opstate}&ovalue={$ovalue}$key"; |
$mysign=md5(urlencode($signStr)); |
上行为PHP语言拼接,其他语言自行拼接,key 为宝龙支付商户签名密钥。 |
商户收到通知参数,在校验通过后需要给宝龙支付接口返回一个字符串 success 的结果,如通知失败,会重复通知5次。 |
URL网关订单查询地址:http://(隐藏)/Query.do 登录商户后台查看
请求方式:GET/POST
注意:Order 为宝龙支付平台的订单号
字段名 | 变量名 |
---|---|
订单号 | Order |
参数 | 描述 |
---|---|
{"status": "error"} | 订单号为空! |
{"status": "not_exist"} | 订单不存在! |
{"status": "new"} | 新订单,未支付! |
{"status": "success"} | 订单已支付! |
支付产品名称 | 银行编码 |
---|---|
支付宝-免签 | alipaymq |
支付宝-电脑网站支付 | alipaypc |
支付宝-手机网站支付 | alipaywap |
支付宝-当面付 | alipayface |
支付宝-当面付H5 | alipayapp |
微信支付-免签 | wechatmq |
微信支付 | wechatpc |
微信支付H5 | wechatapp |
银行卡转账-免签 | bankmq |