直接赠送接口
目录 |
1. 功能说明
直接赠接口,可以用于赠送游戏币。应用可以自助申请赠送游戏币营销活动,获取到活动号和礼包ID后调用本接口赠送。赠送的游戏币不参与结算分成。
移动端的应用,按照游戏币的充值数量进行结算,每月结算时依据当月玩家游戏币的充值总量进行分成。
2. 调用说明
2.1 URL地址
【现网】https://openapi.tencentyun.com/mpay/present_m
【沙箱】http://119.147.19.43/mpay/present_m
2.2 请求参数
Cookie里面需要包含的参数: |
---|
参数名 | 参数说明 |
---|---|
session_id | 用户账户类型,session_id =“openid”(固定传“openid”,不是传openid值) |
session_type | session类型,session_type = “kp_actoken”(固定传”kp_actoken”,不是传kp_actoken值) |
org_loc | 需要填写: /mpay/present_m |
appip | (可选)来源的第三方应用的服务IP |
注意:cookie里面参数的值,需要进行urlencode
请求参数: |
---|
参数名 | 参数说明 |
---|---|
openid | 从手Q登录态中获取的openid的值 |
openkey | 从手Q登录态中获取的access_token 的值 |
pay_token | 从手Q登录态中获取的pay_token的值 |
appid | 应用的唯一ID。可以通过appid查找APP基本信息。这个appid在数值上和支付ID也就是客户端设置的offerid是相同的 |
ts | UNIX时间戳(从格林威治时间1970年01月01日00时00分00秒起至现在的总秒数)。 |
sig | 请求串的签名(可以参考下面具体示例,或者到wiki下载SDK)。 |
pf | 平台来源,平台-注册渠道-系统运行平台-安装渠道-业务自定义。 例如: qq_m_qq-10000144-android-10000144-xxxx |
zoneid | 账户分区ID_角色。和PC接入时保持一致,分区可以在open.qq.com上自助配置。如过应用选择支持角色,则角色接在分区ID号后用"_"连接,角色需要进行urlencode。 注意:如果游戏PC端和移动端是游戏币互通模式,zoneid 的数值保持和PC侧接入支付时传递的一致。例如,游戏A在PC上运行是接入过支付,PC上有分区0和分区1,再接入移动支付是要求移动端账户和PC端账户互通,那么接入移动支付时,zoneid根据需要由业务自己传递PC上配置的分区ID,对0分区操作就传0,对1分区操作就传1 |
pfkey | 跳转到应用首页后,URL后会带该参数。由平台直接传给应用,应用原样传给平台即可。 |
discountid | 赠送营销活动ID。(营销平台申请) |
giftid | 礼品ID。(营销平台申请) |
presenttimes | 赠送礼品的次数。如果配置的礼包ID对应1个游戏币,那么本字段表示要赠送游戏币的个数。 |
userip | (可选)用户的外网IP |
format | (可选)json、jsonp_$func。默认json。如果jsonp,前缀为:$func 例如:format=jsonp_sample_pay,返回格式前缀为:sample_pay() |
2.3 请求示例
示例:(仅演示sig生成使用)
appkey: Lf6AtMEB1QlE8BYS&
method:GET
url_path: /mpay/present_m
[openid] : [F11669C63D76BAB0BC2F6CC869B19E53]
[openkey] : [3968DD5F3F14427EF103A05E00AB59B4]
[pf] : [desktop_m_qq-10000144-android-2002-]
[pfkey] : [65477be802975260ef0ccdc715e57757]
[pay_token] : [CA07B1855260AC01660D3EC75365C499]
[ts] : [1396523200]
[zoneid] : [1]
[format] : [json]
[presenttimes] : [1]
[appid] : [1101255891]
构造源串。得到的源串为:
GET&%2Fmpay%2Fpresent_m&appid%3D1101255891%26format%3Djson%26openid%3DF11669C63D76BAB0BC2F6CC
869B19E53%26openkey%3D3968DD5F3F14427EF103A05E00AB59B4%26pay_token%3DCA07B1855260AC01660D3EC7
5365C499%26pf%3Ddesktop_m_qq-10000144-android-2002-%26pfkey%3D65477be802975260ef0ccdc715e5775
7%26presenttimes%3D1%26ts%3D1396523200%26zoneid%3D1
请求的源串:
http://119.147.19.43/mpay/present_m?openid=F11669C63D76BAB0BC2F6CC869B19E53&
openkey=3968DD5F3F14427EF103A05E00AB59B4&pf=desktop_m_qq-10000144-android-2002-&pfkey=65477be
802975260ef0ccdc715e57757&pay_token=CA07B1855260AC01660D3EC75365C499&ts=1396523200&zoneid=1&f
ormat=json&presenttimes=1&appid=1101255891&sig=VXSVrEH3QlxQnUO2a27Rpkc9GEQ%3D
2.4 返回参数说明
示例:
ret | 返回码 |
---|---|
0 | 成功 |
非0 | 失败 |
1018 | 登陆校验失败 |
2.5 返回示例
正确返回示例
Content-type: text/html; charset=utf-8
{ret:0,msg:}
错误返回示例
Content-type: text/html; charset=utf-8
{"ret":1018,"msg":"请先登录"}
以上信息是否解决您的问题?