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