联通手机游戏平台三网融合短信支付SDK接入规范(Andriod版.docVIP

中国联通手机游戏平台三网融合短信支付SDK接入规范 （Android版） 文件状态： [ √ ]草稿 [ ]正式发布 [ ]正在修改 文件标识： LINKTECH-WOGAME-NORM-006 当前版本： 1.0 作 者： 完成日期： 2013-07-23 目录 1. 联通手机游戏平台三网融合SDK接入规范说明 4 2.相关术语和缩略语 4 3.数据类型 4 3.1其他类型 4 4.接口交互流程 4 4.1接口交互说明 4 4.2编码 5 4.3内容商提交的资料 5 4.4联通手机游戏平台向内容商提供的内容 6 4.5接口详细说明 6 4.6 SDK接入说明： 7 修改记录 编号 版本号 修改人 修改日期 修改内容 涉及的章节 1 V1.0 2013-07-23 初稿 1. 联通手机游戏平台三网融合SDK接入规范说明 本规范的目的是为方便软件和游戏厂商接入中国联通手机游戏平台短信代收费，为用户提供方便快捷安全的手机支付而制定的标准化的接口规范文档。本规范规定了手机软件游戏客户端可调用SDK的方法。 本规范将随着联通手机游戏平台的发展升级而进行修订及修改。 本规范的解释权归联通手机游戏支付平台所有。 2.相关术语和缩略语 术语及缩略语 解释 SMS SMS 是一种存储和转发服务。也就是说，短消息并不是直接从发送人发送到接收人，而始终通过 SMS 中心进行转发。JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式 String? 字符串 Int? 整型? 4.接口交互流程 4.1接口交互说明 游戏厂商需要先行提交游戏和商品内容，得到反馈的游戏id等息后，在游戏中集成短信代收费SDK，当用户在手机软件中点击购买商品时，手机游戏客户端发出调用SDK的请求，将软件和商品的参数传入，用户在支付SDK界面中完成支付操作后，平台后台服务器将处理后的结果反馈给该手机游戏后台，如果支付成功，游戏后台更新信息，显示商品购买成功，失败则向用户提示返回的失败信息。 4.2编码 发送和接受的数据均采用UTF-8格式 发送数据使用android Bundle函数，将参数绑定至调用的支付SDK 的Intent。 例： Intent intent = new Intent(XXXActivity.this, LinkSMSMainActivity.class); Bundle goodBundle = new Bundle(); goodBundle.putCharSequence(softcode, softcode); 4.3内容商提交的资料 内容商在使用SDK前需要向联通手机平台提交如下资料： 游戏名称，用于分配置唯一的编号， android游戏包名，通常为com.xxx.xxx 内容商名称 商品名称和价格的列表 客户服务电话 传入渠道的id,默认提供本渠道的id为U001,有其它渠道需要提前申请。 在SDK集成完成后，需要提供如下资料： 游戏的apk文件。 游戏的图标，截图，介绍信息 4.4联通手机游戏平台向内容商提供的内容 1，联通手机游戏平台会分配给内容商游戏的softcode,softkey游戏内容商要在集成SDK调用中加入此内容。 2，各商品的分配id，10位数字。 3，提供SDK的接入用例，方便接入。 4，将申请渠道代码返回给内容商。 5，提供配置assets目录下的文件给内容商用于植入。 4.5接口详细说明 1，支付SDK调用接口。 接口名称 支付接口调用函数 通信协议 HTTP协议 编码方式 UTF-8 请求方式 POST 数据返回格式 Intent.getExtra 接口描述 客户端实时接口， Android SDK进行支付操作的接口。 请求参数 参数 类型 长度 定义 softcode String UTF（6位数字） 为每款手机软件指定的唯一编号（不能为空） company String UTF（限制24个字符，12汉字） 公司名称（不能为空） goodname String UTF（限制24个英文字符，12汉字） 商品名（不能为空） goodsubid String UTF（10位字符） 分配的商品id（不能为空） gamename String UTF（12