最新开服
6/30
15:00 七十二变1465区
6/30
10:00 屠神165区
6/30
10:00 剑道仙语畅玩版33区
6/30
10:00 逐日战神329区
6/29
10:00 晨曦恋歌18区
6/29
0:10 梦道704区
6/28
10:00 冠军中超OL16区
6/28
10:00 仙域争霸-满V版97区
6/28
10:00 剑道仙语畅玩版32区
6/28
10:00 逐日战神328区
6/28
0:10 梦道703区
6/27
10:00 屠神164区
6/27
0:10 梦道702区
6/26
10:00 修仙霸业46区
6/26
10:00 逐日战神327区
6/26
0:10 梦道701区
6/25
10:00 仙域争霸-满V版96区
6/25
0:10 梦道700区
6/24
10:00 屠神163区
6/24
10:00 冠军中超OL15区
每天轻松一刻
更多
平台服务
平台服务
三唐平台H5游戏接入文档V1.7
作者：三唐技术开发团队 来源：三唐 时间：2018-07-13 17:04:28
一、三唐html5游戏技术对接文档
1.1签名、名词解释、双方技术对接概要
1、CP:游戏开发商
2、CP技术需提供部分
游戏货币名称、游戏充值比例、登录连接（cp_login_url）、游戏发货地址（callback_url）
3、签名使用md5方式（小写）
4、数据格式说明
格式为md5(parm1&parm2...&key),使用参数sign传递，APPKEY三唐平台会发给CP，&是变量连接符
5、支持速易sdk，速易里面logkey和paykey以及sendkey都等同APPKEY
1.2登录接口
三唐按照CP提供的login_url携带下方登录接口参数登录传参，CP验证签名成功后直接进入游戏，用户未登录三唐平台会自动弹出登录框,不调用cp_login_url.
完整登录链接示例：cp_login_url?pf=3tang&sid=2&openid=0b3fbed413aaa66a743eb28f2bbbf87e&userid=jack&isAdult=1&logintime=&sign=&iconurl=
参数名 | 备注 | 说明 |
pf | 平台名 | 固定值3tang |
sid | 游戏区服 | 玩家真实所在区服，没有区服区服则sid=1 |
openid | 三唐开放平台ID | 玩家唯一标志 |
userid | 三唐用户名 | 平台玩家昵称 |
isAdult | 是否成年人 | 0未成年，1成年人 根据国家法规如果是未成年CP需要提示防成谜经验减半，三唐验证防成谜连接：http://www.3tang.com/my/safe.asp |
logintime | 登录时间(UnixTime) | |
sign | 签名（md5加密） | md5(openid&userid&logintime&sid&isAdult& APPKEY) 注意：&是变量连接符 APPKEY由三唐平台分配或者双方协定 |
iconurl | 三唐平台玩家头像地址 | URLEncode编码 |
1.3充值调起接口（游戏直购模式）
H5游戏使用window.parent.postMessage(payparm,'*');发送参数调起三唐支付接口。
Payparm 传值参数
参数名 | 是否必须 | 备注 | 说明 |
userid | 是 | 三唐用户名 | 三唐开发平台分配的 |
gid | 是 | 游戏APPID | |
sid | 是 | 游戏区服 | 不分区服默认1 |
money | 是 | 用户充值金额 | Money单位是元，比如6元则传值6 |
gamename | 是 | 游戏名字 | 中文需要URLEncode编码 |
cp_trade_no | 否 | CP方订单编号，没有则为空 | |
openid | 是 | 三唐开放平台openid | |
method | 是 | 固定值pay | 注意本参数不参与签名 |
item | 是 | 购买物品 | 例：购买60元宝 中文需要URLEncode编码 |
gamerate | 否 | 游戏兑换比例 | 例如如果兑换比例是1元10元宝，则gamerate=10 |
ybcn | 否 | 游戏虚拟货币名称 | 例：元宝、龙晶 中文需要URLEncode编码 |
rolename | 是 | 玩家游戏角色名 | 中文需要URLEncode编码 |
sign | 是 | md5(gid&sid&openid&userid&money& APPKEY)
注：&是变量连接符 APPKEY由三唐平台分配
|
payparm={ 'userid':'3tang7',
'gid':'426735',
'sid':'2740',
'money':'6', 'gamename':'%E4%BC%A0%E5%A5%87%E4%B8%96%E7%95%8C-%E4%BB%97%E5%89%91%E5%A4%A9%E6%B6%AFH5',
'cp_trade_no':'20171120193253ddcfcff52754100943',
'openid':'63a67dee3e51888078108fbbbc02cce6',
'method':'pay',
'item':'购买60元宝',
'gamerate':'10',
'ybcn':'元宝',
'rolename':'迷失大陆',
'sign':'e7ab00cd1664a2e2b155892249cb4264e456f056'
};
范例：
<!DOCTYPE html>
<html>
<head>
<title>三唐H5游戏支付范例</title>
</head>
<body style="height:100%;">
<div id="container" onclick="pay();" style="widht:980px; height:300px; background-color:rgb(254, 142, 87);">
click to pay
</div>
<script type="text/javascript">
var container=document.getElementById('container');
function pay () {
var payparm={
'userid':'3tang7',
'gid':'426735',
'sid':'2740',
'money':'6', 'gamename':'%E4%BC%A0%E5%A5%87%E4%B8%96%E7%95%8C-%E4%BB%97%E5%89%91%E5%A4%A9%E6%B6%AFH5',
'cp_trade_no':'20171120193253ddcfcff52754100943',
'openid':'63a67dee3e51888078108fbbbc02cce6',
'method':'pay',
'item':'购买60元宝',
'gamerate':'10',
'ybcn':'元宝',
'rolename':'迷失大陆',
'sign':'e7ab00cd1664a2e2b155892249cb4264e456f056'
};
window.parent.postMessage(payparm,'*');
}
</script>
</body>
</html>
玩家支付成功之后，前端会回调返回游戏
1.4充值回调发货接口
三唐平台将以约定的格式将数据以http get/post方式提交至CP方指定的发货接callback_url
完整发货接口连接示例：
callback_url?pf=3tang&sid=6&openid=30B249A8769C967DFF6A03FE3B964F8B&billdate=&st_trade_no=&cp_trade_no=&cash=&sign=
1、接口地址: callback_url(CP提供)
2、请求参数
参数名 | 备注 | 说明 |
pf | 平台名 | 固定值:3tang |
sid | 游戏区服 | 根据玩家所在区服传值 |
openid | 玩家唯一标志三唐openid | |
billDate | 玩家下单时间 | Unixtime格式标准时间 |
st_trade_no | 三唐平台订单号 | |
cp_trade_no | CP方订单号 | 跟调起充值接口传入的CP方订单号是一致的 |
cash | 玩家充值金额 | 单位是元 |
sign | 签名（md5加密 小写） | md5(pf&sid&openid&billDate&st_trade_no&cp_trade_no&cash& APPKEY ) 注意&是变量连接符 APPKEY 由三唐平台分配或双方协定 |
3、请求方式:GET/POST
4、应答返回结果
数据格式说明：（json格式）
参数 | 类型 | 参数说明 |
result | Int | 1成功，0失败 |
返回JSON格式示例：{“result”:1}
注意：
(1)、玩家使用唐币支付，是先发送支付回调，回调成功之后再扣唐币
(2)、玩家使用支付宝微信网银支付成功之后回调支付接口
(3)、三唐平台可能对某个订单重复通知，请勿重复处理；对于已经成功处理的订单返回{"result":1}避免重复通知。
(4)、CP在接收到三唐方的通知后，在验证前面的基础上还需要对cash参数进行确认，支付金额是否对应订单的实际金额，防止以较少的金额购买游戏货币。
(5)、cp_trade_no订单编号是CP提供的订单号，最大长度是255位，且不能带有&“‘&空格以及其他会被url转义的字符。
(6)、已经给用户发放过的游戏币订单也请返回成功，但是不要重复给用户发放游戏币。
（平台会对成功的订单校验是否成功，可能出现重复回调的情况）
1.5 分享接口
用户点微信右上角分享按钮之后，平台会给游戏发送消息shareSuccess，游戏里侦听到该消息之后就给玩家发可以领取的礼包
function shareCallbackSend() {
document.getElementById('h5_ifream').contentWindow.postMessage('shareSuccess','*')
}
1.6 更多游戏网址
更多游戏请连接：http://www.3tang.com/h/ 或者http://m.3tang.com
1.7 游戏素材
对接时，所有需要的素材以压缩包的形式发送
命名规范：合作方简称-游戏名称-日期.zip/rar
1、图片资源（px）
颜色建议：颜色选择天蓝色（三唐游戏平台 系统色基本值为#019CF6天蓝色）
游戏的icon，尺寸：16*16
首页轮播图标，尺寸：135*80
游戏首页图标，尺寸：206*114
热门游戏图标，尺寸：170x209
游戏H5页面banner图片，尺寸：550*220
游戏首页banner图片，尺寸：640*170
游戏截图，尺寸：320px × 480px，（3～5张图片）
游戏微端，尺寸ICON：1024px × 1024px，（1张图片png）
2、游戏说明（文字描述）
游戏名称：2～16个字之间
游戏类型：角色／益智／休闲／玄幻／*****（根据自己游戏分类）
游戏宣传语：8～30个字之间
游戏描述或简介：500个字以内
3、游戏攻略、活动、合服公告
内容请发送至：kaifu@3tang.com.cn
1.8开服计划
1、联运模式
三唐平台每周五上午会发送下周的开服计划，对接邮箱：kaifu@3tang.com.cn
2、混服模式由CP把每周开服计划发送至kaifu@3tang.com.cn
