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) | 涨价状态 | 用户是否同意了订阅涨价并自动订阅 |
校验状态码 Validating Receipts Status codes
| 状态码 | 说明 |
|---|---|
| 0 | 成功 |
| 21000 | 无法解析JSON请求 |
| 21002 | 数据类型错误或丢失数据 |
| 21003 | 收据无法验证 |
| 21004 | 提供的共享密码与帐户的文件共享密码不匹配 |
| 21005 | 验证服务器当前不可用 |
| 21007 | 此收据来自测试环境，但已发送到生产环境进行验证。将其发送到测试环境 |
| 21008 | 此收据来自生产环境，但已发送到测试环境进行验证。将其发送到生产环境 |
| 21010 | 收据不合法 |
| 21100-21199 | 内部数据访问错误 |
校验协议 Request and Response
Method: HTTP / POST
Type: JSON
Request:
| 字段 | 类型 | 说明 |
|---|---|---|
| receipt-data | string | base64编码后的收据 |
Response:
| 字段 | 类型 | 说明 |
|---|---|---|
| status | string(int) | 状态码 |
| receipt | string(json) | json格式的收据 |
| is-retryable | string | 需要重试，21100-21199错误码 |
