fusion2.dialog.openVipGift

特别声明
1.本接口仅针对已经接入支付的应用。
2.请在开发者管理系统“支付结算”tab下的“营销接入”提交活动申请(活动类型为“开通包月送礼包”),审核通过的应用将获得接口权限及活动批号信息。
3.本接口属于下面的流程图所示第二个环节(总体开发说明详见开通包月送礼包)。

marketing_21.png


目录

What's New?

2013年1月8日,新增参数“pf”,支持开发者传入黄钻类型(普通黄钻或豪华黄钻)。
2012年10月31日,新增参数“ch”,标识VIP开通的对象为自己还是好友。
2012年8月8日起,新增三个参数:version,paytime,defaultMonth。

1 功能说明

“开通黄钻”前端JS接口,弹框模式。
本接口适用场景:开通黄钻送礼包活动。

接入黄钻的应用,可以提示用户开通黄钻或续费黄钻即可获赠应用礼包,方便引导用户开通黄钻, 在用户成功开通黄钻后,即赠送用户应用中的礼包,提升黄钻用户付费群。

2 接口调用说明

调用本前端接口前,应用中应该部署Fusion2的跨域文件以及引用脚本,请参阅:Fusion2文档

接口说明如下:

fusion2.dialog.openVipGift

({

// 必须。 领取道具的token,通过调用v3/pay/get_token接口获取。

token : 'xxx',


// 必须。开通包月送礼包的营销活动ID。

// 在管理中心“支付结算”tab下的“营销接入”提交活动申请后,将获取该营销活动ID。

actid : 'xxx',


// 必须。在管理中心“支付结算”tab的“营销接入”下,在“发货配置”中配置好的分区ID。
注:2013年后接入的寄售应用,此参数将作为分区发货的重要参数,如果因为参数传错或为空造成的收入损失,由开发商自行承担。
// 该接口传的zoneid参数必须与v3/pay/get_token接口传的保持一致。
zoneid : 'xxx',


// 必须。根据APPID以及用户QQ号码生成用户ID。

openid : 'xxx',


// 可选。表示使用的OpenAPI版本。v3:使用OpenAPI V3.0,v2或不指定:使用OpenAPI V2.0。
// 如果您的应用中,回调的赠送道具发货URL使用的是OpenAPI V3.0协议,则这里必须传值"v3"。

version : 'v3',


// 可选。用付费模式。
// month表示按月支付,year表示按年支付。
// 传入此参数后用户将无法选择付费模式。为空或不传则允许用户选择付费模式。
paytime : 'month',


// 可选。VIP的开通时长,单位为月。
// 若上面的paytime参数值为month,则这里需传入1-24的整数;
// 若上面的paytime参数值为year,则这里需传入12或24。
// 传入此参数后用户将无法选择开通时长。为空或不传则允许用户选择开通时长。
defaultMonth : '24',


// 可选。标识VIP开通的对象为自己还是好友。
// self:给自己开通; send:给好友开通。不传或传入其他值,则默认为给自己开通。
ch : 'self',


// 可选。标识开通的黄钻类型。
// 不传此参数或参数值为空:开通普通黄钻; XXJZGHH:开通豪华黄钻。
pf : ' ',


// 可选。透传参数,用于onSuccess回调,以识别请求。
// 透传方式:调用本接口时传入该参数,onSuccess回调时,在JS中使用opt.context即可获取该透传参数。
// opt为本接口的回调函数形参。
contex: 'openVipGift',


// 可选。用户开通黄钻包月业务成功时的回调方法。
// 如果用户开通成功,则立即回调onSuccess,当用户关闭对话框时再回调onClose。
// 同时可用该回调方法记录通过营销活动开通包月业务的用户信息。

onSuccess : function (opt) { alert(opt.context);},


// 可选。用户开通黄钻包月业务失败时的回调方法。
// 如果用户开通失败,则立即回调onError,当用户关闭对话框时再回调onClose。

onError : function (opt) { },


// 可选。对话框关闭时的回调方法。
// 主要用于对话框关闭后进行UI方面的调整,onSuccess则用于应用逻辑的处理,避免过度耦合。

onClose : function (opt) { }

});

3 效果展示

在应用中放置开通黄钻送礼包营销活动入口,用户点击活动链接,应用调用前台接口弹出“开通黄钻”弹框,弹框样式如下所示。
marketing_22.png

相关文档

上一步:v3/pay/get_token

下一步:回调赠送道具发货URL的协议说明_V3.0

其他相关文档:开通包月送礼包

以上信息是否解决您的问题?

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部