天翼空间应用中计费业务操作手册.doc

中国电信天翼空间应用中计费业务操作手册本文档主要描述了中国电信应用商城(天翼空间)的应用中计费的基本机制，以及指导开发者如何在应用中使用应用中计费业务功能。文档中提供了开发者需要做哪些准备、如何获取所需资源及如何使用 SDK 等的指引，同时也提供了相关的范例供开发者学习使用。V 1.0.12013-4-1目 录1应用中计费介绍21.1 背景21.2 应用中计费的基本流程31.3 应用中计费的计费模式31.4 应用中计费支持的平台情况42如何使用应用中计费42.1 使用应用中计费产品的接入流程42.2 申请流程42.2.1申请开发者帐号42.2.2申请合作52.2.3申请计费能力72.2.4 申请计费点82.2.5计费点变更流程112.3 开发122.4 应用上传133结算154 FAQ164.1 业务类164.2 技术类16前言：为提升天翼空间对开发者的吸引力，同时满足用户的使用需求，天翼空间整合渠道资源，为开发者开放更丰富的计费能力，实现应用中计费（即过程中计费，以下略）这种新的计费模式。1 应用中计费介绍1.1 背景应用中计费旨在为开发者提供灵活的计费方法，允许开发者在应用内灵活设置计费点，以便销售受限制的功能、道具、关卡及音乐或电子书等电子商品。本期应用中计费提供支持 android 平台的 SDK 包，开发者可基于此开发包开发出适合的计费应用来。1.2 应用中计费的基本流程天翼空间应用中计费 SDK 是运行于手机上的基础服务，为手机上的应用提供支付相关服务。天翼空间开发者只需要根据应用中计费的接入流程规范开发自己的应用，增加计费点并内置应用中计费 SDK，再发布到天翼空间平台，通过审核和应用签名后，即可实现天翼空间应用中计费的支付服务。天翼空间用户下载天翼空间应用后，可在应用内通过应用中计费 SDK 完成天翼空间应用的购买及其他相关付费服务。1.3 应用中计费的计费模式l 目前应用中计费支持按次计费模式和包月计费模式；按次计费是指用户一次性支付购买，按次计费一般用于购买游戏道具，虚拟货币等场景。包月计费是指用户一次性订购后，每月自动从用户话费中扣费，直至用户退订，包月计费模式一般用于阅读类应用订购（订购后可享受信息服务，每月自动扣费），专业性信息服务的正式版（财经、咨询等产品）订购等。 l 单个应用中支持一个或多个计费点，计费点不超过10个，且单个计费点金额不超过20元；l 计费点价格规定如下：按次计费价格（元/次）：0.99元，1.00 元,1.50元,1.99 元,2.00元,2.50元, 2.99元 3.00 元,3.50元, 4.00元, 4.50元,4.99元, 5.00元, 5.99元, 6.00元, 7.00元, 7.99元, 8.00元, 9.00元, 9.99元, 10.00元, 10.99元,12.00元, 14.99元, 15.00元, 15.99元, 18.00元, 19.99元, 20.00元。包月计费价格（元/月）：0.99元，1.00 元,1.50元,1.99 元,2.00元,2.50元, 2.99元 3.00 元,3.50元, 4.00元, 4.50元,4.99元, 5.00元, 5.99元, 6.00元, 7.00元, 7.99元, 8.00元, 9.00元, 9.99元, 10.00元, 10.99元,12.00元, 14.99元, 15.00元, 15.99元, 18.00元, 19.99元, 20.00元。1.4 应用中计费支持的平台情况运行环境：目前应用中计费SDK支持 Android2.1平台以上。目标用户：支持中国电信C网手机用户通过话费进行支付。 2 如何使用应用中计费在自有应用代码中嵌入应用中计费的SDK，并进行自测； AP申请计费资质，并获得通过；申请应用中计费点并获得通过；2.1 使用应用中计费产品的接入流程在天翼空间AP管理后台进行应用发布 【关键提示】* 基础前提 ：需成为天翼空间的“商用 ”状态开发者（即至少有一款应用在天翼空间上线）。* 流程中涉及各资源在后文有相应说明。* SDK 可以进入能力开放平台的能力介绍页面进行下载。2.2 申请流程2.2.1申请开发者帐号登录天翼空间eStore首页（即），先申请成为开发者即天翼工厂用户，您可点击“我还没有注册卖家账号”，进入开发者注册流程。注册成功后，即成为普通开发者，您可手动选择进入的站点，或等待系统几秒后自动跳转至AP和店铺申请流程界面。2.2.2申请合作您成为普通开发者之后，如果想进一步成为天翼空间eStore的卖家，则需要申请合作，即申请成为AP并开店。您的AP资质与开店申请经审核通过后，则可在天翼空间eStore上传应用、出售应用、管理应用/店铺以及与买家互动。通过【2.2.1申请开发者账号】中提到的申请成功后，点击“申请成为AP”或等待系统自动跳转，即可进入天翼空间AP申请页面，开始AP与开店申请流程。出现提醒阅读商城规范的界面，勾选“我已仔细阅读并接收以下规范”，点击“继续申请”。以个人开发者为例，选择“申请成为个人AP”，则点击进入个人AP申请流程。第一步，登记个人AP基本信息第二步，选择和管理者签约。第三步，登记店铺信息。提交后，需等待天翼空间合作管理员对合作资料进行初审，通过后可执行下述步骤。第四步，若要申请计费能力，请先上传一款产品，已发起电子签约；若不申请计费能力，可以直接上传发布的产品。以下状态是不影响免费应用和下载付费应用产品上传和上架的。2.2.3申请计费能力1）在“签约信息”中，同意应用中计费合作承诺书并点击“提交”按钮。2）可单选或复选申请的计费类型：应用中计费按次，应用中计费包月，包月，包时，包次。3）申请成功后即可获得 APSECRET码，用于开发应用程序。AP申请计费能力界面：管理员审核计费资质界面：2.2.4 申请计费点1）点击“计费申请”2）点击“申请”3） 填写应用名称，勾选“应用中计费”，并填写计费点相关说明，通过“增加计费点”可新增计费点，计费点总数不得超过10个。备注：价格只能在可选价格中选择。计费名称和计费描述是必填项，均不可超过30字符。填写的内容在该应用的产品界面将展现给用户，请按实填写，我们将进行严格的审核。4）提交申请后显示5）申请返回页面，显示为审核中。6）管理员审核通过。2.2.5计费点变更流程1）管理员审核计费不通过。2）AP查询到计费点审核不通过。3）编辑/新增计费点。4）查看计费点审核记录2.3 开发开发详见文档应用使用中计费SDK开发分册. ，在开发使用计费SDK时所需的几个重要参数均可在AP应用发布后台进行查看。其中：APSECRET在签约信息中可进行查看，计费代码和应用ID在计费申请中可进行查看，均须打包到应用中。重要提示：1、 在集成SDK进行计费开发之前，请先完成计费点申请，并在通过计费点审核后，再进行调试2、 在集成SDK进行计费开发时，将使用应用中计费的SDK调用的参数TESTFLAG设置为TRUE，就可以在本地开发联调测试（在本地开发联调时，能展现整体计费流程，但不会进行真实的扣费操作）。3、在联调开发时，需要使用C网手机进行测试。2.4 应用上传重要提示：在完成开发测试，准备正式发布应用之前，请将使用应用中计费的SDK调用的参数TESTFLAG设置为FLASE，再进行打包上传，否则不能完成计费流程。1）AP选择Android应用上传，出现右边界面，填写相关内容和上传附件。在应用名称处的可选框中，选择已通过审核的计费点的应用名称：超级熊猫。2）出现应用中计费信息3）选择暂存，结果显示：4）自动跳转到如下页面：5）点击应用名称进入提交界面，点击“提交”，如下提示，三秒后跳转至应用列表界面：6）在应用列表界面查看操作记录：7）查看附件列表操作记录：3 结算 1） 信息费收入按70%的比例结算给AP。2) 结算数据暂不单独展示给AP，包含在每月总结算数据中。4 FAQ4.1 业务类1）天翼空间应用中计费目前支持哪些运营商用户？答：暂仅支持中国电信C网用户。2）天翼空间应用中计费目前支持哪些平台？答：目前SDK支持Android（2.1版以上）。3） 应用中计费目前提供哪几种计费模式？答：按次。4） 应用可设置多少个计费点？答：从用户