无线产品部scm试点项目 - 腾讯.docVIP

腾讯移动支付插件Midas白皮书 目 录 1. 系统简介 5 1.1. 简介 5 1.2. 文档适用对象 5 2. 系统集成 5 2.1. 系统结构 5 2.2. 道具直购流程 6 2.3. 游戏币购买流程 7 2.4. 集成说明 7 3. 支付SDK接口API 8 3.1. 系统初始化 8 3.1.1. 绑定支付服务 8 3.1.2. 去绑定支付服务 8 3.1.3. offerId参数设置 8 3.1.4. 环境参数设置 9 3.1.5. log参数设置 9 3.1.6. 游戏币道具购买数量是否显示设置 9 3.1.7. 游戏币道具购买结果页单位 9 3.2. 购买游戏币道具接口 10 3.2.1. 充值游戏币（支付插件提供默认充值数额） 10 3.2.2. 充值游戏币（应用传递充值数额） 11 3.2.3. 充值游戏币（支付插件提供默认充值数额带营销活动号） 12 3.2.4. 充值游戏币（应用传递充值数额） 14 3.2.5. 购买道具 15 3.3. 购买包月接口 16 3.3.1. 开通包月接口（支付插件提供默认包月数） 16 3.3.2. 开通包月接口（应用传递默认包月数） 17 3.3.3. 开通包月接口（支付插件提供默认包月数,兼容2.3.5接口） 18 3.3.4. 开通包月接口（应用传递默认包月数，兼容2.3.5接口） 18 3.3.5. 开通包月接口（带自动续费） 19 3.4. 订阅接口 20 3.5. 微商店接口 22 3.6. 团购接口 23 3.7. 回调接口 25 3.7.1. 回调注册 25 3.7.2. 回调响应接口 26 4. 支付后台接口API 28 4.1. 道具后台接口API 28 4.1.1. 购买道具下订单接口 28 4.1.2. 购买道具扣款成功回调应用发货 30 4.2. 游戏币后台接口API 32 4.2.1查询余额接口 32 4.2.2. 扣除游戏币接口 33 4.2.3. 取消支付接口 36 4.2.4. 直接赠送接口 38 4.2.5. 应用消耗游戏买道具一般流程 40 4.3. OpenAPI V3.0签名SDK下载 40 4.4. OpenAPI V3.0 签名校验工具 40 5. FAQ 41 5.1. Q：android版本要求？ 41 5.2. Q：SDK支付完成后，能否通知应用充值数量及是否充值成功？ 41 5.3. Q：调用SDK时pf和pfkey如何确定？ 41 5.4. Q：什么是基础货币和安全货币？ 41 5.5. Q：支付时为什么会登录态过期？ 42 5.6. Q：道具直购和购买游戏币有什么区别 42 6. 附录 42 6.1. SDK弹框错误错误码 42 系统简介 简介 腾讯移动支付插件是一款提供为应用提供购买二级货币和道具入口的插件APP。提供了个帐、财付通、网银、Q卡、手机充值卡、手机话费、微信支付、元宝（无线平台使用）等购买渠道。该SDK也可以在使用个帐购买二级货币余额不足时进行充值个帐操作，支持财付通、网银、Q卡、手机充值卡、手机话费、微信支付渠道充值个帐。 文档适用对象 该文档适用于接入支付应用的android开发及后台开发，第二、三章主要是android集成及接口说明。第四章主要是介绍应用需要调用或者开发的后台接口。 系统集成 系统结构 应用APP集成支付TencentUnipaySDK，该sdk负责和腾讯移动支付MidasAPP的Service进行通信， 应用APP只需要绑定支付Service，调用SDK相应的支付api完成支付即可。 道具直购流程 道具直购流程 应用侧接入道具直购时需要调用腾讯支付的后台接口下订单(buy_goods_m接口)，然后应用使用该订单号跳转到支付SDK，后续的整个支付逻辑由支付SDK完成，支付完成后腾讯支付服务端会回调应用的后台发货回调接口（在的支付结算模块的分区配置中配置，和pc端使用相同的发货服务器）进行发货。下单接口及发货回调接口参见第4章。其中步骤2、5、8需要应用侧处理，其它逻辑支付SDK中已经完成。 游戏币购买流程 购买游戏币流程 购买游戏币采用货币托管模式，腾讯支付服务端负责发货，因此应用侧只需要调用支付SDK的API唤起支付页面，用户在支付完成后，支付SDK会回调应用。第4步中的回调接口由应用开发。 集成说明 移动支付sdk采用jar包形式提供。包括TencentUnipaySDK.jar和TencentUnipay.apk。 应用集成时需要将TencentUnipay.apk植入应用项目的assets目录下打包一起发布，或者不打包，在支付时，会从网络下载最新版的该插件。 导入TencentUnipaySDK.jar到应用项目的libs目录下。 支付SDK接口API 系统