PDF《中国移动应用商场》

中国移动应用商场 应用内计费 IAP-SDK 返回码速查手册 V 2.

0 2012-11 目录 1. 前言

3 2. 开发调试基本方法

3 3. 返回码表

4 1. 前言 本手册适用于已经掌握 Android 应用开发方法,正在开发调试 IAP 应用的开发人员. 阅读本手册前应首先详读《MM 应用内计费-开发指南》 ,了解清楚相关知识方可正式开 始开发应用. 2. 开发调试基本方法 SDK 对自测试和商用状态作了区分,自测试状态下支付对话框中有 自测试 的字样. 在自测试状态时,只有配置在测试号码列表中的移动手机号码才能测试,否则会报错. 在自测试过程中碰到错误返回码时,首先可以把申请到的 appid/appkey/paycode 填到 DEMO 里面进行测试: ? 如果 DEMO 没问题而自己的应用返回错误,则可以确定是应用代码或配置文件有 错误,可以参考返回码检查代码和配置文件. ? 如果 DEMO 也出现报错,则可能是网络环境/终端环境/业务规则方面的原因,可以 在这些方面着手排错. 如果错误码没有出现在下面表格中, 则说明可能是系统问题, 需要联系技术支撑人员解 决. 3. 返回码表 返回码错误来源 错误处理方法

100 操作成功标志(初始化成功) 继续应用逻辑

101 操作成功标志(查询成功) 继续应用逻辑

102 操作成功标志(购买成功) 继续应用逻辑

104 操作成功标志(已经购买过) 继续应用逻辑

110 网络环境(没有网络) 检查终端设备网络环境

111 终端设备(手机卡不是移动卡) 1. 换卡或换设备再试 2. 确认使用的手机是装有移动卡的设备 注意:双卡双待设备需当移动卡位于主卡槽 时,即可以使用移动话费支付.双卡双待机 的两个卡槽中哪一个是主卡槽由手机操作系 统决定,由于安卓系统的开放性,不同厂商 定义的主卡槽位置可能不一样,部分双卡双 待手机也可以由用户自定义卡槽的主从位 置.

112 应用(调用参数错误) 检查代码

113 应用(未正确完成初始化) 检查代码

114 终端环境(不是 GSM 设备) 换设备再试

115 平台/网络环境(网络连接超时) 1. 尝试其他网络,例如 WIFICMNET 2. 用已经上线的应用测试下, 看是否平台 侧问题 3. 联系技术支撑人员

116 应用(重复初始化) 检查代码

120 应用(调用请求冲突) 检查代码

200 应用(渠道加载失败) 解开 apk 包,查看下 CopyrightDeclaration.xml 和mmiap.xml 这两个文件是否存在

210 终端设备 换设备再试

211 终端设备 换设备再试

212 终端设备 换设备再试

213 终端设备 换设备再试

214 应用(权限未配置) 检查应用的 AndroidManifest.xml 中的权 限配置是否和 demo 一样

218 终端设备(非标准 ROM) 换卡或换设备再试

219 网络环境/平台(初始化网络连接 失败) 1. 尝试其他网络,例如 WIFICMNET 2. 用已经上线的应用测试下,看是否平 台侧问题 3. 联系技术支撑人员

220 手机设备/GSM 网络环境/平台 (初 始化短信未送达) 1. 检查手机卡是否能正常发送短信 2. 检查手机是否安装安全软件拦截短信 发送 3. 检查应用的 AndroidManifest.xml 中 的权限配置是否和 demo 一样 4. 确保所处环境手机信号覆盖正常 5. 用已经上线的应用测试下,看是否平 台侧问题 6. 联系技术支撑人员

221 应用/平台(初始化失败) 1. 检查应用的 AndroidManifest.xml 中 的权限配置是否和 demo 一样 2. 联系技术支撑人员

231 应用(版权文件不存在) 解开 apk 包,查看下 CopyrightDeclaration.xml 和mmiap.xml 这两个文件是否存在

245 业务规则(不允许购买) 1. 查询用户状态和计费点状态 2. 联系业务支撑人员

246 业务规则(用户已购买,但订购 关系暂停) 1. 查询用户状态 2. 联系业务支撑人员

247 应用(计费点代码错误) 1. 检查代码中 appid/paycode 2. 检查是否已经添加测试号码且测试号 码未过期 (测试号码不能同时存在于两 个AP 账号中) 3. 确认是否正在发布该应用, 如果正在发 布,请执行完发布流程即可恢复正常

248 应用(没有授权调用能力) 1. 检查代码中 appid/paycode 2. 检查是否已经添加测试号码且测试号 码未过期 (测试号码不能同时存在于两 个AP 账号中)

252 终端设备/应用 (应用与发布到 MM 上的不符或非标准 ROM) 1. 使用在 MM 上发布过的应用 2. 换成官方 ROM 的android 手机

254 业务规则(用户身份变更) 因用户更换 SIM 卡而导致的错误,一般只 要注意在应用启动时正确初始化即可避免

255 应用 (应用与发布到 MM 上的不符) 1. 使用在 MM 上发布过的应用 2. 检查代码中 appid/appkey 填写是否正 确259 应用(请求能力不存在) 1. 检查代码中 appid/paycode 2. 检查是否已经添加测试号码且测试号 码未过期(测试号码不能同时存在于两个 AP 账号中)

260 应用/平台(应用不存在) 1. 检查代码中 appid/paycode 2. 检查是否已经添加测试号码且测试号 码未过期(测试号码不能同时存在于两个 AP 账号中 3. 检查应用状态是否已创建(自测试状 态)或已发布(商用状态)

261 业务规则(订购太频繁) 注意订购操作间隔时间即可.

264 业务规则(业务不存在) 商品已下架.联系业务支撑人员

266 业务规则(订购数量超出限制) 目前限制一笔交易只能购买十件商品

267 应用(调用请求冲突) 检查代码

268 业务规则(用户关闭了支付功能) 需要用户自行打开限制

269 业务规则(应用下载来源不可靠) 需要从合法的来源下载

270 业务规则(消费的费用已累计超 过今日限额) 下一个自然日再订购

202 业务规则(消费的费用已累计超 过本月限额) 下一个自然月再订购

500 业务规则(查询结果:用户已购 买,但订购关系暂停) 1. 查询用户状态 2. 联系业务支撑人员

501 业务规则(用户未购买,允许购 买) 继续应用逻辑

502 业务规则/应用(计费点代码错 误) 1. 检查代码中 appid/paycode 2. 检查是否已经添加测试号码且测试号 码未过期 (测试号码不能同时存在于两 个AP 账号中)

503 业务规则(没有授权调用该能力) 1. 检查代码中 appid/paycode 2. 检查是否已经添加测试号码且测试号 码未过期 (测试号码不能同时存在于两 个AP 账号中)

506 业务规则(用户身份变更) 因用户更换 SIM 卡而导致的错误,一般只 要注意在应用启动时正确初始化即可避免

507 应用 (应用与发布到 MM 上的不符) 1. 使用在 MM 上发布过的应用 2. 检查代码中 appid/appkey 填写是否正 确511 业务规则(请求能力不存在) 1. 检查代码中 appid/paycode 2. 检查是否已经添加测试号码且测试号 码未过期(测试号码不能同时存在于两个 AP 账号中)

512 应用/平台(应用不存在) 1. 检查代码中 appid/paycode 2. 检查是否已经添加测试号码且测试号 码未过期(测试号码不能同时存在于两个 AP 账号中 3. 检查应用状态是否已创建(自测试状 态)或已发布(商用状态)

401 操作成功标志(用户取消支付) 继续应用逻辑

402 应用(无法显示订购对话框) 检查代码,由于 activity 被回收,导致 dialog 无法显示

403 业务规则(验证码输入错误) 重新输入

404 业务规则(支付密码错误) 重新输入

405 业务规则(会话过期) 重新订购

408 业务规则(用户身份变更) 因用户更换 SIM 卡而导致的错误,一般只 要注意在应用启动时正确初始化即可避免

409 应用 (应用与发布到 MM 上的不符) 1. 使用在 MM 上发布过的应用 2. 检查代码中 appid/appkey 填写是否正 确411 手机终端/应用(应用校验失败) 应用不合法,需要从合法渠道重新下载安 装414 业务规则(请求能力不存在) 1. 检查代码中 appid/paycode 2. 检查是否已经添加测试号码且测试号 码未过期(测试号码不能同时存在于两个 AP 账号中)

415 应用/平台(应用不存在) 1. 检查代码中 appid/paycode 2. 检查是否已经添加测试号码且测试号 码未过期(测试号码不能同时存在于两个 AP 账号中 3. 检查应用状态是否已创建(自测试状 态)或已发布(商用状态)

417 业务规则(订购数量超出限制) 目前限制一笔交易只能购买十件商品

419 业务规则(业务不存在) 商品已下架.联系业务支撑人员

420 业务规则(短信验证码输入错误) 重新获取短信验证码并重新输入 ........