返回顶部

fusion2.dialog.buy

特别声明

本接口仅开放给已提交支付接入申请并通过的应用。使用前请确保你的应用具有该接口的访问权限。

目录

What's New?

2012年10月26日,新增参数“disturb”,支持游戏币快捷支付功能,仅接入“道具寄售”模式且具有功能性支付场景的应用可使用该功能。

2012年10月25日,支付免打扰功能下线,不再支持申请开通该功能。

2012年9月27日,支持仅游戏币支付弹框,用于支付接入的寄售模式。

1 功能说明

“道具购买”前端JS接口,弹框模式。

本前端接口用于支付接入以下场景的功能开发:

一:Q点直购模式/ 道具寄售模式-直购应用道具 / 道具寄售模式-游戏币快捷支付
1. Q点直购模式
(1)用户在应用中点击“道具购买”按钮后,即弹出道具购买弹框。
(2)在弹框中,支持Q点或财付通2种支付方式,用户选择支付方式后,弹框中显示具体的购买物品的数量以及应付的Q点或人民币金额,让用户完成购买操作。
(注:在购买道具的页面中,财付通支付方式指的是财付通微支付,财付通跟财付通微支付属于两种不同的支付方式,如果选择财付通支付,需要先将财付通帐号金额转换为财付通微支付金额,然后才能完成购买。

财付通微支付充值入口:https://www.tenpay.com/v2.0/main/gameaccount/charge.shtml 。)
(3)购买成功后回调接口中指定的函数刷新用户的仓库列表。

2. 道具寄售模式-直购应用道具
在应用道具商城中通过游戏币/Q点/财付通直接购买应用的道具。
“直购应用道具”功能的开发说明与“Q点直购道具”功能开发说明相同,只是道具购买弹框支持游戏币/Q点/财付通3种支付方式。

3. 道具寄售模式-游戏币快捷支付
在应用中通过秒杀的方式抢到道具后,通过游戏币快捷支付方式购买道具。
“游戏币快捷支付”功能的开发与“Q点直购道具”功能开发的处理流程相同,但调用本接口时需输入参数“disturb”,标识为游戏币快捷支付方式,不弹出支付弹框。

本接口属于以下流程中的第5步:
unipay_4.png

二:道具寄售模式-道具寄售
在寄售系统中用游戏币购买其他用户的道具。
(1)用户在应用的寄售系统中选择要购买的道具后,点击“购买”按钮,即弹出道具购买弹框。
(2)在弹框中,只支持游戏币支付方式。弹框中显示购买物品应付的游戏币金额,让用户完成购买操作。

(3)购买成功后回调接口中指定的函数刷新用户的仓库列表。
本接口属于道具寄售流程中的第5步:
exchange_goods.png

2 接口调用说明

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

接口说明如下:

fusion2.dialog.buy

({

// 可选。仅当接入“道具寄售”模式的应用使用游戏币快捷支付功能时,必须传该参数。取值固定为“true”。

// 其他支付场景不需要传入该参数。

disturb : true,


// 必须。 表示购买物品的url参数,url_params是调用Q点直购接口v3/pay/buy_goods或道具寄售接口v3/pay/exchange_goods接口返回的参数。

param : "url_param",


// 必须。表示是否使用沙箱测试环境。应用发布前,请务必注释掉该行。

// sandbox值为布尔型。true:使用; false或不指定:不使用。(沙箱必须传sandbox : true,现网传sandbox : false或者注释)

sandbox : true,


//可选。前台使用的上下文变量,用于回调时识别来源。

context : "context",


//可选。用户购买成功时的回调方法,其中opt.context为上述context参数。如果用户购买成功,则立即回调JS中的onSuccess,当用户关闭对话框时再回调onClose。

onSuccess : function (opt) { },


//可选。用户取消购买时的回调方法,其中opt.context为上述context参数。如果用户购买失败或没有购买,关闭对话框时将先回调onCancel再回调onClose。

onCancel : function (opt) { },


//可选。如果在实现Q点直购功能时调用了发货通知接口,即需要实现本方法,其中opt.context为上述context参数。如果发货超时,则立即回调onSend。

onSend : function(opt) { },


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

onClose : function (opt) { }


});

3 效果展示

一:Q点直购模式 / 道具寄售模式-直购应用道具 / 道具寄售模式-游戏币快捷支付

1. Q点直购模式
(1)在应用中点击“购买”按钮:
buy_2.png
(2)弹出支付窗口
① 用户可选择Q点支付方式,如下图所示:
buy_1.png
②用户也可以选择财付通游戏子账户支付方式,如下图所示:
buy_3.png

2. 道具寄售模式-直购应用道具
在应用道具商城中通过游戏币/Q点/财付通直接购买应用的道具。
(1)在应用道具商城选择要购买的道具,点击“购买”按钮。
(2)弹出支付弹框,支持游戏币/Q点/财付通3种支付方式,如下图所示:
buy_7.png

3. 道具寄售模式-游戏币快捷支付
通过游戏币快捷支付方式购买秒杀到的道具。
(1)在应用的秒杀活动中抢购道具。
(2)抢购成功后,用户点击“支付”或“购买”,不弹出支付弹框,直接返回支付结果。

二:道具寄售模式-道具寄售
在寄售系统中用游戏币购买其他用户的道具。
(1)在接入道具寄售系统的应用中选择要购买的道具,点击“购买”按钮:
buy_5.png
(2)弹出支付窗口,仅支持游戏币支付,如下图所示:
buy_6.png

相关文档

一:Q点直购模式 / 道具寄售模式-直购应用道具 / 道具寄售模式-游戏币快捷支付,请使用本上下步导航:
上一步:v3/pay/buy_goods
下一步: 回调发货URL的协议说明_V3

二:道具寄售模式-道具寄售,请使用本上下步导航:
上一步:v3/pay/exchange_goods
下一步: 回调道具交换URL的协议说明


其他相关文档:支付接入#支付接入文档索引 | 支付测试环境说明 | 支付错误码说明 | 支付功能开发相关FAQ

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

Copyright © 1998 - 2014 Tencent. All Rights Reserved.

腾讯公司 版权所有