游戏支付接口文档

初级模式(新手小白)

本文档以雷霆传奇H5为例子,其他游戏也是大同小异。

第一步,下载SDK网关示例

第二步,将下载的接口示例文件解压,放到游戏网站目录下

第三步,创建分组和分区

注意:分区的回调地址,假如你的游戏网站域名是www.123.com,那么通知地址就是: http://www.123.com/pay/notify.php

第四步,用Notepad++工具,修改config.php配置文件里的商户ID、商户密钥、分区链接、数据库

第五步,区配置完成后,先模拟充值,测试配置是否正确,模拟充值成功后,分区充值才真正的实现并对外开放。

提示:

对接完成后,将分组充值链接或者分区充值链接,添加到游戏网站的充值位置上即可。

高级模式(开发人员)

请求方式:GET/POST

创建分组和分区,然后获取分区充值链接,这个充值链接可以作为请求提交地址,提交参数如下表:

假设分区充值链接为:https://(隐藏)/fenqu.do?token=2080080940816819971068721

请求参数说明:

字段名 变量名 是否必填 加入签名 描述
商户ID parter 宝龙支付所创建的商户ID
商户订单号 orderid 商户订单号,该值需在商户网站内唯一
充值账号 account 用于游戏充值时,可传入玩家账号
订单金额 value 精确到小数点后两位,例如10.28
支付方式 type 查看API支付产品编码
商品名称 subject 第三方支付平台,付款界面展示的商品名称
联系方式 contact 用于游戏充值时,可传入玩家联系方式
md5签名 sign 32位小写md5签名值,请参考签名算法
提交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 为宝龙支付商户签名密钥。
API回调通知接口

通知类型:服务器异步通知(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('参数名') 解码,其他语言写法不同。

回调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://(隐藏)/api.php 登录商户后台查看

请求方式:GET/POST

请求参数说明:

字段名 变量名 是否必填 示例值 描述
操作类型 act order 此API固定值
商户订单号 out_trade_no 20160806151343349
商户ID pid 800800001

返回结果:

字段名 变量名 示例值 描述
返回状态码 code 1 1为成功,其它值为失败
返回信息 msg 查询成功
支付状态 status 1 1为支付成功,0为未支付,2为订单号不存在
API支付产品编码

支付产品名称 银行编码
支付宝-免签 alipaymq
支付宝-电脑网站支付 alipaypc
支付宝-手机网站支付 alipaywap
支付宝-当面付 alipayface
支付宝-当面付H5 alipayapp
微信支付-免签 wechatmq
微信支付 wechatpc
微信支付H5 wechatapp
银行卡转账-免签 bankmq