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错误码 |
