iOS内购 服务器文档 摘要

iOS内购 服务器文档 摘要

修改时间:2017-09-14 10:17:33

名词简写:

App Store - AS
iTunes Connect - IC
storekit - SK

客户端:

步骤 说明
获取商品信息 nil
1.第一步先向AS请求合法的物品列表 物品都需要在IC中配置上架,一切物品需以IC为主,所以在展示购买UI之前,需要先获得最新的合法物品
tips:苹果推荐将该请求返回的非法物品通知到服务器以做进一步处理
2.将合法物品展示在商店UI中 此商店UI就是游戏的充值页面
提交付款请求 nil
3.使用购买的物品创建一个付款请求 tips:在提交付款请求时,可以附加一些反作弊信息,以便使苹果的反作弊系统分析
等待回调完成支付 nil
4.创建付款请求,并放进SK队列 nil
5.等待SK的回调 tips:SK会管理所有的交易。每个被提交的交易,直到被观察者标记为已完成,否则会一直在启动时回调
tips:SK处理队列中的交易并回调时,不一定是按照队列添加顺序的,所以,回调函数应能处理这点(Map)
tips:把收据存储于服务器上,收据中会包含最近一次购买的消耗品信息,以及全部的非消耗品信息
tips:最后一步再将交易标记为已完成
tips:在测试环境中,也要及时完成交易队列中的所有交易,否则下次启动时SK依旧会将未完成的交易回调给观察者
将收据发送给服务器校验 nil
6.从appStoreReceiptURL方法中读取收据,并发送给服务器 tips:这个收据里的消耗性购买项目。。貌似会被最新的覆盖,所以要求!在获取到本笔订单的收据前!不能进行下一笔支付!

服务器:

步骤 说明
验证 nil
1.发送收据到苹果服务器 tips:收据验证时,为了避免被发多个相同收据,每当验证完成一个收据后,都要存下唯一交易标识符
2.成功发货/失败通知/超时重试 nil

收据字段 App Receipt Fields

字段 类型 名称 说明
bundle_id string 应用标识符 包名,App唯一识别符 (需判断)
application_version string 应用版本号 客户端版本号
in_app string 内购信息 内购信息,主要分析对象 (需判断)
original_application_version string 原应用版本号 原始客户端版本号,沙箱下为"1.0"
creation_date string(date) 收据更新日期 最近更新日期
expiration_date string(date) 失效日期 失效日期

内购收据字段 In-App Purchase Receipt Fields

字段 类型 名称 说明
quantity string(int) 数量 客户端提交付款申请时填写的数量
product_id string 产品标识符 客户端提交付款申请时填写的产品标识符,用来唯一区分物品,发货凭证
transaction_id string 交易标识符 交易生成的标识符
original_transaction_id string 原始交易标识符 与交易标识符一致,若是恢复购买则不一致
purchase_date string(date) 购买日期 RFC3339标准时间
original_purchase_date string(date) 原始购买日期 恢复购买
expires_date string(date) 订阅到期 Unix标准时间戳
expiration_intent string(int) 订阅到期原因 过期的订阅的到期原因枚举值
is_in_billing_retry_period string(int) 是否尝试续订 过期的订阅,苹果是否尝试自动续订
is_trial_period string 是否处于免费试用期 是否处于订阅试用期
cancellation_date string(date) 取消日期 苹果客户支持取消日期
cancellation_reason string(int) 取消原因 被取消的原因枚举值
app_item_id string App唯一标识符 生产环境下分配的App唯一id,测试环境没有
version_external_identifier string 外部版本标识符 识别购买时使用的App版本,为任意数字
web_order_line_item_id string 网络订单标识符 用于标识跨设备的购买事件
auto_renew_status string(int) 自动订阅状态 是否打开了自动订阅
auto_renew_product_id string 自动续订偏好 自动续订产品的标识符
price_consent_status string(int) 涨价状态 用户是否同意了订阅涨价并自动订阅

https://developer.apple.com/library/content/releasenotes/General/ValidateAppStoreReceipt/Chapters/ReceiptFields.html#//apple_ref/doc/uid/TP40010573-CH106-SW12


校验状态码 Validating Receipts Status codes

状态码 说明
0 成功
21000 无法解析JSON请求
21002 数据类型错误或丢失数据
21003 收据无法验证
21004 提供的共享密码与帐户的文件共享密码不匹配
21005 验证服务器当前不可用
21006 iOS6自动订阅
21007 此收据来自测试环境,但已发送到生产环境进行验证。将其发送到测试环境
21008 此收据来自生产环境,但已发送到测试环境进行验证。将其发送到生产环境
21010 收据不合法
21100-21199 内部数据访问错误

校验协议 Request and Response

Method: HTTP / POST
Type: JSON
Request:
字段 类型 说明
receipt-data string base64编码后的收据
password string 自动订阅
exclude-old-transactions string iOS7中包含订阅
Response:
字段 类型 说明
status string(int) 状态码
receipt string(json) json格式的收据
latest_receipt string iOS6自动订阅收据
latest_receipt_info string iOS6自动订阅收据
latest_expired_receipt_info string iOS6自动订阅收据
pending_renewal_info string iOS7自动订阅收据
is-retryable string 需要重试,21100-21199错误码

推荐阅读更多精彩内容