AppStore内购 | 思索者

内购简介

App 内购买 (In‑App Purchase)，简称：IAP内购。

通过 App 内购买项目，直接在 App 里为顾客提供额外的内容和功能，包括特级内容、数字商品和订阅项目。您更可以直接在 AppStore 上推广和提供 App 内购买项目。

官方文档：https://developer.apple.com/cn/in-app-purchase/

商品类型

消耗型产品(Consumable)

定义：消耗型项目只可使用一次，使用之后即失效，必须再次购买。
特点：购买的商品可消耗，可重复购买。每次购买的值一般都会叠加。如果买了后，用户不消耗，则一直存在用户相关的账号中。
举例：《皇室战争》中，购买宝石。

非消耗型产品(Non‑Consumable)

定义：非消耗品只能购买一次且不会过期。
特点：这种类型的商品的特点就是当用户购买后，这个商品就一直生效，不需要重复购买。
举例：《旅行青蛙》中，解锁游戏中的特定道具。

非续期产品(Non‑Renewing Subscriptions)

定义：用户购买有时限性的服务或内容。
特点：此类订阅到期后不会自动续订，用户需要逐次续订。
举例：《腾讯视频》中，VIP会员包月。

自动续期产品(Auto‑Renewable Subscriptions)

定义：用户购买有时限性的服务或内容，到期后自动续订。
特点：到期前24小时，苹果会主动扣费从而为用户自动续订，直用户取消自动订阅。
举例：《腾讯视频》中，VIP会员连续包月。

商品定价

内购商品定价为固定的金额，分为非自动订阅商品定价与自动订阅商品定价两类。

注意⚠️：定价并非全部都是整数，自动订阅的定价包含类似 ¥1.99 的定价。

疑问🤔️：苹果的定价是固定的，如何满足产品业务灵活的定价？

按照最接近商品价格的苹果定价执行扣费，计算苹果定价与商品实际定价的差额，这部分差额转换为虚拟货币发放到用户的余额中；

疑问🤔️：什么是苹果抽成？

由于在使用苹果内购时，根据商品类型的不同，苹果会按商品定价抽成约30%左右的手续费，附带不同类型商品的税费，实际的中间费用在30%～33%之间。

因此，在应用内购买虚拟币时，如果在安卓端的兑换比例为：1元 = 100宝石；那么在苹果端兑换比例为：1元 = 66宝石；

定价等级表

非自动订阅商品定价列表

level	CNY	USD
等级 1	6	0.99
等级 2	12	1.99
等级 3	18	2.99
…	…	…
等级 87	6498	999.99
备用等级 A	1	0.99
备用等级 B	3	0.99
备用等级 1	8	0.99
备用等级 2	12	1.99
备用等级 3	18	2.99
备用等级 4	28	3.99
备用等级 5	30	4.99

自动订阅商品定价列表

price	level
¥1.00	¥1.00
¥1.99	¥1.99
¥3.00	¥3.00
¥3.99	¥3.99
…	…
¥6,498.00	¥6,498.00

定价机制

自 2023 年 5 月 9 日起，App Store 各店面的现有 App 和一次性 App 内购买项目的价格都将以产品当前在美国店面的价格为基础进行更新，除非你在 2023 年 3 月 8 日后进行了相关更新。你随时可以使用 App Store Connect 或 App Store Connect API 更新基准店面的国家或地区。如果你选择进行更新，在 App Store 根据外汇变化或新的税费生成全球均衡价格时，你所选基准店面的价格将不会受到调整。你还可以选择手动调整多个所选店面中的价格，而不使用均衡的价格。

1、定价点调整

App及App内购的可选价格点数量增加了近9倍，现在可以从最多900个价格点中选择定价，同时价格点按价格区间逐渐递增（如RMB 10 以下每档相差 RMB 0.5；RMB 10 到 RMB 200 之间每档相差 RMB 1 等）。比如RMB支持1.0元、1.5元、1.8元、2.0元等。

2、增强的全球定价机制

在此之前，App Store采用的是“等级定价方式”，也就是说开发者根据产品定价等级表设置一个定价等级后，系统会自动按等级生成其它国家或地区对应的价格，而不能单独设置某个国家或地区的价格。比如，将产品定价设置为等级1的 USD 0.99 美元价格，那CNY(人民币)只能是表中对应的6元。

增强的全球定价机制采用了“全球均衡价格”，即我们可以指定某个国家/地区的App及App内购价格作为基准店面，苹果系统会根据全球汇率变动，自动调整App及App内购在其他国家和地区的价格。

除此之外，还可以根据基准国家和地区的店面自动生成价格外，开发者也可以手动调整某个国家和地区的App及App内购价格。

3、可为上架产品提供地区性定价方案

在此之前App内购项目与App上线国家和地区是绑定的，也就是说App内购项目不能单独选择销售地区。

升级后的定价机制支持单独为App内购选择上线的国家和地区，从而为不同市场分发定制的内容和服务。

商品促销

推介促销优惠是针对自动续期订阅类商品的优惠促销活动，包含免费试用和特价优惠，分别通过收据的 is_trial_period 和 is_in_intro_offer_period 字段体现；

注意⚠️：如果用户参与过推介促销优惠，则无法再享受该商品所属订阅分组的推介促销优惠。即推介促销的优惠针对每个订阅分组，苹果只允许用户享受一次；

内购模式

两种模式主要的不同之处在于对 AppStore 返回的付款凭证（receipt）的验证方式。

客户端验证模式：在客户端验证付款凭证（receipt），简单快捷，但容易被破解。主要适用于非联网APP应用内购，比如，《旅行青蛙》中游戏道具购买。
服务器验证模式：在服务端验证付款凭证（receipt），流程相对复杂，但相对安全性更高，主要适用于联网APP应用的内购，比如，直播APP中虚拟货币的充值购买。

客户端模式

APP 从服务器获取产品标识列表
APP 从 AppStore 获取产品信息
用户选择需要购买的产品
APP 发送支付请求到 AppStore
AppStore 处理支付请求，用户完成支付后，AppStore 返回付款收据 (receipt) 给APP
APP 验证返回的付款收据(receipt)，判定用户是否付款成功并提供对应的服务

服务器模式

sequenceDiagram participant StoreKit as StoreKit participant App as iPhone participant Server participant AppStore App->>+Server: 1.获取业务订单号 Server-->>-App: 2.返回业务订单号 rect rgba(0, 0, 255, .1) Note over App,StoreKit: 苹果支付 App->>+StoreKit: 3.请求商品信息（productId) StoreKit-->>App: 4.返回商品信息 App->>StoreKit: 5.加入交易队列 StoreKit-->>App: 6.弹出交易弹窗 App->>StoreKit: 7.用户支付 StoreKit-->>-App: 8.交易成功，返回付款收据 end App->>+Server: 9.验证订单状态（付费收据、业务订单号） Server->>AppStore: 10.验证收据有效性 AppStore-->>Server: 11.返回收据有效性 Server-->>-App: 12.返回处理结果 App->>StoreKit: 13.关闭交易 AppStore-->>Server: 13.通知消息（App Store Server Notifications）

内购收据

内购收据是用户付款后，苹果服务器返回给iOS客户端的一个付款凭证，通过在客户端/服务端验证苹果的收据验证付款凭证的真实性，从而为用户提供收据买对应的服务。

收据风格

iOS 6-style transaction receipts
iOS 7-style transaction receipts

收据验证

沙箱环境验证付款收据(receipt): https://sandbox.itunes.apple.com/verifyReceipt 生产环境验证付款收据(receipt): https://buy.itunes.apple.com/verifyReceipt

最佳实践

根据收据中的 bid 反查对应配置的 app_item_id，校验是否与收据内的 app_item_id 是否一致；
根据收据中的 product_id 反查对应配置的 item_id，校验是否与收据内的 item_id 是否一致；

收据结构

1、非自动续期产品收据结构

针对非自动续期产品收据，original_transaction_id 和 transaction_id 是相同的；

{
    "receipt": {
        "unique_identifier": "...",                     //苹果分配设备唯一标识符
        "original_transaction_id": "...",               //原交易号
        "transaction_id": "...",                        //交易号
        "unique_vendor_identifier": "...",              //唯一供应商标识
        "product_id": "...",                            //产品名称标识（product_id）
        "quantity": "1",                                //交易产品数量
        "bid": "...",                                   //应用名称标识（bundle_id)
        "is_in_intro_offer_period": "false",            //是否特价优惠（详见推介促销）
        "is_trial_period": "false",                     //是否免费试用（详见推介促销）
        "purchase_date_ms": "1531643137200",            //购买付款时间戳
        "original_purchase_date_ms": "1531643137200",   //原交易付款时间
        "bvrs": "3.96.3.0",
        "app_item_id": "...",                           //应用唯一标识
        "item_id": "...",                               //产品唯一标识
        "version_external_identifier": "827233954",
        "purchase_date": "2018-07-15 08:25:37 Etc/GMT",
        "purchase_date_pst": "2018-07-15 01:25:37 America/Los_Angeles",
        "original_purchase_date": "2018-07-15 08:25:37 Etc/GMT",
        "original_purchase_date_pst": "2018-07-15 01:25:37 America/Los_Angeles",
    },
    "status": 0
}

2、自动续期订阅产品收据结构

{
  "auto_renew_status": 0,
  "latest_expired_receipt_info": {
    "original_purchase_date_pst": "2018-01-19 16:03:00 America/Los_Angeles",
    "unique_identifier": "9d89432f1fae59f25c05d44553fe40438a865b9f",
    "original_transaction_id": "1000000368245564",
    "expires_date": "1517368991000",
    "transaction_id": "1000000371718901",
    "quantity": "1",
    "product_id": "abc",
    "bvrs": "721180.450460032",
    "bid": "ab.bc",
    "unique_vendor_identifier": "9982B084-BE66-4622-ACCB-6C5B3D9C4CD4",
    "web_order_line_item_id": "1000000037662245",
    "original_purchase_date_ms": "1516406580000",
    "expires_date_formatted": "2018-01-31 03:23:11 Etc/GMT",
    "purchase_date": "2018-01-31 02:53:11 Etc/GMT",
    "is_in_intro_offer_period": "false",
    "purchase_date_ms": "1517367191000",
    "expires_date_formatted_pst": "2018-01-30 19:23:11 America/Los_Angeles",
    "is_trial_period": "false",
    "purchase_date_pst": "2018-01-30 18:53:11 America/Los_Angeles",
    "original_purchase_date": "2018-01-20 00:03:00 Etc/GMT",
    "item_id": "1326212778"
  },
  "status": 21006,
  "auto_renew_product_id": "...",
  "receipt": {
    "original_purchase_date_pst": "2018-01-19 16:03:00 America/Los_Angeles",
    "unique_identifier": "9d89432f1fae59f25c05d44553fe40438a865b9f",
    "original_transaction_id": "1000000368245564",
    "expires_date": "1517359990000",
    "transaction_id": "1000000371686472",
    "quantity": "1",
    "product_id": "...",
    "bvrs": "721180.450460032",
    "bid": "...",
    "unique_vendor_identifier": "9982B084-BE66-4622-ACCB-6C5B3D9C4CD4",
    "web_order_line_item_id": "1000000037544589",
    "original_purchase_date_ms": "1516406580000",
    "expires_date_formatted": "2018-01-31 00:53:10 Etc/GMT",
    "purchase_date": "2018-01-31 00:23:10 Etc/GMT",
    "is_in_intro_offer_period": "false",
    "purchase_date_ms": "1517358190000",
    "expires_date_formatted_pst": "2018-01-30 16:53:10 America/Los_Angeles",
    "is_trial_period": "false",
    "purchase_date_pst": "2018-01-30 16:23:10 America/Los_Angeles",
    "original_purchase_date": "2018-01-20 00:03:00 Etc/GMT",
    "item_id": "1326212778"
  },
  "expiration_intent": "1",
  "is_in_billing_retry_period": "0"
}

收据解析

详见官方解释：https://developer.apple.com/documentation/appstorereceipts/status

Status	Description
21000	The request to the AppStore was not made using the HTTP POST request method.
21001	This status code is no longer sent by the AppStore.
21002	The data in the receipt-data property was malformed or the service experienced a temporary issue. Try again.
21003	The receipt could not be authenticated.
21004	The shared secret you provided does not match the shared secret on file for your account.
21005	The receipt server was temporarily unable to provide the receipt. Try again.
21006	This receipt is valid but the subscription has expired. When this status code is returned to your server, the receipt data is also decoded and returned as part of the response. `Only returned for iOS 6-style transaction receipts for auto-renewable subscriptions.`
21007	This receipt is from the test environment, but it was sent to the production environment for verification.
21008	This receipt is from the production environment, but it was sent to the test environment for verification.
21009	Internal data access error. Try again later.
21010	The user account cannot be found or has been deleted.
21100	Internal data access error. Try again later.
…	Internal data access error. Try again later.
21199	Internal data access error. Try again later.

沙盒环境

在开发过程中，需要测试应用是否能够正常的进行支付，但是又不可能每一次测试都进行实际的支付，因此需要使用苹果提供的 Sandbox Store 测试。苹果提供了沙盒账号的方式，这个沙箱账号其实是虚拟的AppleID，在开发者账号后台的iTune Connect上配置了之后就能使用沙盒账号测试内购。StoreKit不能在iOS模拟器中使用，因此，测试StoreKit必须在真机上进行。

Sandbox环境验证付款收据(receipt): https://sandbox.itunes.apple.com/verifyReceipt
Product环境验证付款收据(receipt): https://buy.itunes.apple.com/verifyReceipt

沙盒账号

在iPhone上安装测试包
退出iPhone的AppStore账号，设置 iTunes Store 与 AppStore -> 选中AppleID -> 退出登录。注意⚠️：退出之后，不需要在 AppStore 登录沙盒账号，因为沙盒账号是一个虚拟的AppleID，因此不能直接登录。只能使用在支付时使用。
在测试包中点击购买商品，系统会提示你进行登录，这里点击”使用现有的AppleID”后输入沙盒测试账号进行登录。
点击确认购买，购买成功。

沙盒测试

沙盒环境下自动续费订阅时，时限会缩短。

生产自动续费周期	沙盒自动续费周期
1周	3分钟
1个月	5分钟
2个月	10分钟
3个月	15分钟
6个月	30分钟
1年	1小时

沙盒识别

解析付款收据(receipt)中的 environment 字段，判断 environment=Sandbox。
根据生产环境收据验证接口返回的状态码。如果 status=21007，则表示当前的收据为沙盒环境收据。

苹果审核

苹果审核APP是在沙盒环境下验证充值相关功能的。因此，当APP提交苹果审核时，服务端需换成沙盒环境，否则就无法通过苹果审核。

疑问🤔️：生产和沙盒环境的收据需要切换不同的验证接口，如何简化？

最佳实践：首先使用 production URL 验证收据，如果收到了21007的状态码，那么继续使用sandbox URL进行验证。遵循这种方法可以确保你的应用程序在测试、App审核以及AppStore中运行时，不需要在url之间切换。

内购退款

退款政策

针对退款，不同国家或地区会有不同的“无条件退款期限”。 AppStore 商店退款政策：

欧盟区： 14天无条件退款。
中国台湾：7天无条件退款。
中国/美国/韩国等其它大多数国家：90天有条件退款。

注：中国区 AppStore 的具体退款政策：一个 AppleId 有一次无条件退款机会，一年2次有条件退款，第3次退款会非常难。至于退款到账时间快为36小时内，也有7-15个工作日退还。

退款方式

用户可以通过那些方式申请退款：

联系Apple客户支持并要求退款
登录并使用Apple的自助服务工具 reportaproblem.apple.com 要求退款
要求他们的付款方式发行人退款（比如要求银行取消扣费，或者黑卡无法扣费等）

退款通知

在 Apple 全球开发者大会( WWDC2020 )上，Apple宣布从2020年06月24日开始，针对 AppStore 内购项目的退款通知现已可用。AppStore 服务器通知现在包含所有类型的 AppStore 内购项目的退款通知 (包括消耗型项目、非消耗型项目和非续期订阅)，详见：https://developer.apple.com/videos/play/wwdc2020/10661/。

2020年06月24日开始，新的退款流程：

sequenceDiagram participant Customer participant Apple participant Developer Customer->>Developer: Purchases 100 gems(购买100宝石) Customer->>Developer: Consumes 100 gems(消费100宝石) Customer->>Apple: Contacts Apple for support(顾客联系苹果申请退款) Apple->>Apple: Issues refund(苹果发起退款) Apple->>Developer: Send refund notification(发送退款通知) Apple->>Customer: Contacts you for game compensation(通知用户退款成功) Developer->>Developer: Check for refunded payment(开发者检查退款订单)

在 AppStore 服务端通知中，针对消耗型项目、非消耗型项目和非续期订阅三类商品的退款，增添了新的通知类型：退款（REFUND）。

注意⚠️，不同于取消（CANCEL）通知类型，取消通知类型针对的是自动续期订阅类型商品，用户通过 AppleCare 支持取消订阅并退还购买款项时触发。

在 unified_receipt.latest_receipt_info 是一个数组，其中包含的最近的100次应用内购买交易，包括正常和退款的交易。如果是退款的交易，交易的收据信息中会包含退款时间（cancellation_date_ms）和退款原因（cancellation_reason）。

服务器应发送HTTP状态代码，以表示服务器到服务器的通知接收是否成功：

如果回调接收成功，则发送 HTTP 200。您的服务器不需要返回数据。
如果回调接收不成功，请发送 HTTP 50x 或 40x 让 AppStore 重试该通知。AppStore在一段时间内尝试重试该通知，但在连续失败尝试后最终停止（3次）；

注意事项：

当您使用包含退款交易的收据 transaction_data 向苹果服务器校验 verifyReceipt 时，JSON响应中不存在退款交易，自动续订订阅除外。
收到 REFUND 通知时，您有责任为每笔退款交易存储，监控并采取适当的措施。（因为苹果只通知一次，暂时无法在苹果后台查询退款的订单。也不能由开发者主动去苹果服务器查询。）

退款（REFUND）通知类型通知的结构如下：

{
    "notification_type":"REFUND",
    "password":"...",
    "environment":"PROD",
    "latest_receipt":"...",
    "latest_receipt_info":{
        "cancellation_reason":"0",
        "is_trial_period":"false",
        "is_in_intro_offer_period":"false",
        "unique_identifier":"00008020-0004482A3628002E",
        "unique_vendor_identifier":"0C4C3E40-21D8-4BC4-992F-1CB9A6CAEA4C",
        "cancellation_date":"2020-07-28 06:00:53 Etc/GMT",
        "cancellation_date_ms":"1595916053000",
        "cancellation_date_pst":"2020-07-27 23:00:53 America/Los_Angeles",
        "purchase_date":"2020-07-27 07:58:43 Etc/GMT",
        "purchase_date_ms":"1595836723000",
        "purchase_date_pst":"2020-07-27 00:58:43 America/Los_Angeles",
        "original_purchase_date":"2020-07-27 07:58:43 Etc/GMT",
        "original_purchase_date_ms":"1595836723000",
        "original_purchase_date_pst":"2020-07-27 00:58:43 America/Los_Angeles",
        "item_id":"1146327846",
        "app_item_id":"774384491",
        "version_external_identifier":"836917695",
        "bid":"...",
        "product_id":"...",
        "transaction_id":"...",
        "original_transaction_id":"...",
        "quantity":"1",
        "bvrs":"4.98.00.1"
    },
    "unified_receipt":{
        "status":0,
        "environment":"Production",
        "latest_receipt_info":[
            {
                "quantity":"1",
                "product_id":"...",
                "transaction_id":"...",
                "purchase_date":"2020-07-27 07:58:43 Etc/GMT",
                "purchase_date_ms":"1595836723000",
                "purchase_date_pst":"2020-07-27 00:58:43 America/Los_Angeles",
                "original_purchase_date":"2020-07-27 07:58:43 Etc/GMT",
                "original_purchase_date_ms":"1595836723000",
                "original_purchase_date_pst":"2020-07-27 00:58:43 America/Los_Angeles",
                "is_trial_period":"false",
                "original_transaction_id":"...",
                "cancellation_date":"2020-07-28 06:00:53 Etc/GMT",
                "cancellation_date_ms":"1595916053000",
                "cancellation_date_pst":"2020-07-27 23:00:53 America/Los_Angeles",
                "cancellation_reason":"0"
            }
        ],
        "latest_receipt":"..."
    },
    "bid":"...",
    "bvrs":"4.98.00.1"
}

退款处理

potential-actions

服务器通知

使用来自 AppStore 的服务器通知来监视和响应用户的订阅状态更改。启用 AppStore 服务器通知功能是可选的，但建议这样做，特别是在跨多个平台提供订阅服务且需要保持订阅记录更新的情况下。设置服务器后，您可以随时通过在 App Store Connect 中添加服务器URL来开始接收通知。将通知与收据验证结合使用可以验证用户的当前订阅状态，并根据该状态为用户提供服务或促销优惠。详见：https://developer.apple.com/documentation/storekit/in-app_purchase/subscriptions_and_offers/enabling_server-to-server_notifications

配置服务器通知

在服务器上支持 App Transport Security（ATS）。在发送通知之前，AppStore必须使用ATS协议与您的服务器建立安全的网络连接。
确定应用服务器提供的URL可用于订阅状态更新。
在AppStore Connect中为您的应用配置订阅状态URL。请参阅：https://help.apple.com/app-store-connect/#/dev0067a330b

App Store Server Notifications V1

服务器通知类型

https://developer.apple.com/documentation/appstoreservernotifications/notification_type

AppStore 通过HTTP协议的POST请求，将JSON格式的通知消息传递给业务的应用服务器，以处理的订阅事件。

详见：https://developer.apple.com/documentation/appstoreservernotifications/notification_type

INITIAL_BUY

Occurs at the user’s initial purchase of the subscription. Store latest_receipt on your server as a token to verify the user’s subscription status at any time by validating it with the App Store.

INITIAL_BUY

存储消息中的latest_receipt字段，作为通过AppStore查询用户订阅状态的凭证。

触发条件：

在用户首次购买订阅产品时触发；

CANCEL

Indicates that Apple Support canceled the auto-renewable subscription and the customer received a refund as of the timestamp in cancellation_date_ms.

CANCEL

表示苹果支持已经取消了自动续期订阅并且用户在cancellation_date_ms时间收到了退款信息。注意⚠️：通过iOS设置取消订阅时，不会发送CANCEL通知，而是发送DID_CHANGE_RENEWAL_STATUS通知。

触发条件：

用户通过AppleCare支持取消订阅并退还购买款项；
用户升级订阅产品；

DID_CHANGE_RENEWAL_STATUS

Indicates a change in the subscription renewal status. Check auto_renew_status_change_date_ms and auto_renew_status in the JSON response to know the date and time of the last status update and the current renewal status.

DID_CHANGE_RENEWAL_STATUS

用于获取订阅状态变更，通过的auto_renew_status和auto_renew_status_change_date_ms获取当前的订阅状态以及上次状态更新的时间。注意：此事件与CANCEL事件容易混淆，CANCEL事件通过AppleCare支持取消订阅并退还购买款项时触发。

触发条件：

当订阅状态发生的更改时触发，包括已订阅状态时取消订阅或未订阅状态时重新订阅；

订阅状态变更：取消订阅（订阅服务未过期）判定条件：auto_renew_status == 0 && status = 0 过期处理：续费订阅状态（renewStatus）： 1 ➡️ 0 最后续费时间（LastRenewalTime）：latest_receipt_info.purchase_date_ms 下次续费时间（nextRenewalTime）：latest_receipt_info.expires_date
订阅状态变更：取消订阅（订阅服务已过期）判定条件：auto_renew_status == 0 && status = 0 过期处理：续费订阅状态（renewStatus）： 1 ➡️ 0 最后续费时间（LastRenewalTime）：latest_expired_receipt_info.purchase_date_ms 下次续费时间（nextRenewalTime）：latest_expired_receipt_info.expires_date
订阅状态变更：恢复订阅（订阅服务未过期）判定条件：auto_renew_status == 1 && status = 0 过期处理：续费订阅状态（renewStatus）： 0 ➡️ 1 最后续费时间（LastRenewalTime）：latest_receipt_info.purchase_date_ms 下次续费时间（nextRenewalTime）：latest_receipt_info.expires_date

RENEWAL (DEPRECATED)

Indicates successful automatic renewal of an expired subscription that failed to renew in the past. Check expires_date to determine the next renewal date and time. As of March 10, 2021 this notification is no longer sent in production and sandbox environments. Update your existing code to rely on the DID_RECOVER notification type instead.

RENEWAL

表示成功自动续订过去无法续订的过期订阅。检查expires_date，以确定下一个续订日期和时间。

注意⚠️：RENEWAL事件的命名容易让人混淆，让人误以为是每次自动续订的时候触发该事件。相反，应该在订阅周期的过期时间expiration_date前后，通过苹果提供的收据校验接口/VerifyReceipt来检查订阅状态，获取下一个订阅周期的信息。

触发条件：

由于无法从用户账户成功扣款，订阅被自动取消一段事件后，用户重新续订时，会触发RENEWAL事件；

INTERACTIVE_RENEWAL

Indicates the customer renewed a subscription interactively, either by using your app’s interface, or on the App Store in the account’s Subscriptions settings. Make service available immediately.

INTERACTIVE_RENEWAL

表示客户使用您的应用程序界面或在该帐户的“订阅”设置中的App Store上以交互方式续订了订阅。需要立即提供服务。

触发条件

用户取消了订阅，一段时间后用户通过AppStore交互页面重新订阅产品，会触发INTERACTIVE_RENEWAL事件。

A new subscription (which is listed in clause 2) may differ from the subscription from clause 1, but they both must belong to the same shopping group. For example, a user may cancel a subscription to the Bronze tariff plan and after a while resume the subscription by selecting the Gold plan. In this case, Apple will send the INTERACTIVE_RENEWAL event to your server (provided that the Bronze and Gold subscriptions belong to the same shopping group). You can read more about subscription groups here .

新的订阅（在第2节中列出）可能与第1条中的订阅不同，但它们都必须属于同一购物组。例如，用户可以取消对青铜费率计划的订阅，并在一段时间后通过选择黄金计划恢复订阅。在这种情况下，Apple会将INTERACTIVE_RENEWAL事件发送到您的服务器（假设Bronze和Gold订阅属于同一购物组）。

DID_CHANGE_RENEWAL_PREF

Indicates the customer made a change in their subscription plan that takes effect at the next renewal. The currently active plan is not affected.

DID_CHANGE_RENEWAL_PREF

表示客户对其订阅计划进行了更改，该更改会在下一次续订时生效。当前活动的计划不受影响；

触发条件：

当用户在同一订阅分组中，从一个订阅商品切换到另一个订阅商品时，会触发DID_CHANGE_RENEWAL_PREF事件；

DID_FAIL_TO_RENEW

Indicates a subscription that failed to renew due to a billing issue. Check is_in_billing_retry_period to know the current retry status of the subscription, and grace_period_expires_date to know the new service expiration date if the subscription is in a billing grace period.

表示由于计费问题而无法续订的订阅。如果订阅处于计费宽限期内，请检查is_in_billing_retry_period以了解订阅的当前重试状态，并检查grace_period_expires_date以了解新服务的到期日期。

DID_RECOVER

Indicates a successful automatic renewal of an expired subscription that failed to renew in the past. Check expires_date to determine the next renewal date and time.

表示成功自动续订一个过去续订失败的过期订阅。检查expires_date以确定下一次续费的日期和时间。

CONSUMPTION_REQUEST

Indicates that the customer initiated a refund request for a consumable in-app purchase, and the App Store is requesting that you provide consumption data. For more information, see Send Consumption Information.

表示用户发起了一个消耗型内购商品的退款请求，并且App Store请求商家提供消费数据。

作为新退款流程的一部分，引入了一个新的CONSUMPTION_REQUEST通知，该通知要求将响应发送回Apple服务器。

触发条件：当客户针对消耗型 App 内购买项目发起退款请求时，App Store 会通过 App Store 服务器通知 V2 端点向你的服务器发送退款 CONSUMPTION_REQUEST notificationType 请求。如果客户同意，则通过调用此 API 并将 App Store 中的 ConsumptionRequest 消费数据发送到 App Store 进行响应。如果没有，请不要回复通知 CONSUMPTION_REQUEST 。

App Store Server Notifications V2

Apple is adding both new events and a new field called substate. The combination of a single server notification and its substate is now supposed to have a 1:1 mapping to an actual customer lifecycle event.

苹果增加了新的事件和一个名为substate的新字段。这样通过单个通知类型结合substate字段，就可以完整的对应上客户购买流程中的每一个事件（在此之前为了表述购买过程中某个特定的生命周期事件，苹果必须要推送多个通知时间）

The notification payload will include the Signed Transaction so that a separate call to Apple is not needed to interpret the notification.

通过在通知消息的有效载荷中包含Signed Transaction，从而不需要额外请求 Apple 服务器来解释通知。

服务器通知类型

Alt text

内购监控

业务监控

商品列表监控（失败率与时延）
购买下单监控（失败率与时延）
收据上报监控（失败率与时延）
内购退款监控
沙盒充值监控
到账延迟监控

链路监控

访问苹果收据服务器网络链路监控，监控可访问性与时延

内购账单

内购账单的出账周期是T-2，账单的统计时间口径不透明，无法通过日账单进行精准的对账；

除了苹果官方30%的手续费抽成以外，每个国家都有其税费；

https://developer.apple.com/help/app-store-connect/reference/summary-sales-report

[
  {
    "provider": "APPLE",
    "provider_country": "US",
    "apple_identifier": "...",                  // 产品item-id
    "sku": "...",                               // 产品sku
    "developer": "",
    "title": "...",                             // 产品描述
    "version": "11.4.7",
    "product_type_identifier": "IA1",           // 产品类型（详见：https://rdrr.io/cran/RTConnect/man/kProductTypeIdentifier.html）
    "units": 2,                                 // 产品件数
    "developer_proceeds": 20.63,                // 开发者收入
    "currency_of_proceeds": "CNY",              // 开发者收入币种
    "begin_date": "06/19/2023",
    "end_date": "06/19/2023",
    "customer_price": 30.00,                    // 顾客购买价格
    "customer_currency": "CNY",                 // 顾客购买币种
    "country_code": "CN",                       // 顾客商店国家
    "promo_code": "",
    "parent_identifier": "...",
    "subscription": "",
    "period": "",
    "category": "Music",
    "cmb": "",
    "device": "iPhone",
    "supported_platforms": "iOS and watchOS",
    "proceeds_reason": "",
    "preserved_pricing": "",
    "client": "",
    "order_type": ""
  }
]

StoreKit

StoreKit 1

存在的问题：

苹果后台不能查看到退款的订单详情。只能苹果处理退款后发通知给我们的服务器，告知发生了一笔退款。
消耗性、非消耗性、非续期订阅、自动续订能不能在沙盒环境测试退款，系统没提供这种测试方式。
不能够将用户反馈的苹果付费收据里的 orderID 与具体的业务订单进行关联。
研发过程中，无法直接关联苹果交易号 transactionId 与业务订单号 orderID 之间联系

https://juejin.cn/post/7096063372159877150

收据：https://developer.apple.com/documentation/appstoreserverapi/get_transaction_info https://developer.apple.com/documentation/appstoreserverapi/data_types 国家storefront

1.5收据appAccountToken

StoreKit 2

2021 年 WWDC，在 iOS 15 系统上推出了一个新的 StoreKit 2 库，该库采用了完全新的 API 来解决应用内购买问题。 StoreKit 2 主要的更新有这几个：

仅支持Swift语言

StoreKit 2 使用了 Swift 5.5 的新特性进行开发，因此支持Swift语言开发。

新增appAccountToken属性

提供的新购买商品接口增加了可选参数 PurchaseOption 结构体，该结构体里有新增的 appAccountToken 字段，类似 SKPayment.applicationUsername 字段，但是 appAccountToken 信息会永久保存在 Transaction 信息内。

appAccountToken 字段是由开发者创建的；关联到 App 里的用户账号；使用 UUID 格式；永久存储在 Transaction 信息里。这里的 appAccountToken 字段苹果的意思是用来存储用户账号信息的，但是应该也可以用来存储 orderID 相关的信息，需要将 orderID 转成 UUID 格式塞到 Transaction 信息内，方便处理补单、退款等操作。

applicationUsername是 Original StoreKit 创建苹果订单时，由开发者赋值的一个字段，原本这个字段是传入用户 UID 的 Hash 值，作用是给苹果验证应用购买以防止欺诈，比如代充和黑产恶意充值等。

appAccountToken是 WWDC21 推出 StoreKit 2 的一个字段，用于开发者将苹果交易与自己服务上的用户关联的 UUID 格式的字段。

当客户发起应用内购买时，你可以选择生成一个 appAccountToken 并将其发送到应用商店。如果你使用原始API进行应用内购买，你可以在applicationUsername属性中提供一个UUID。在客户完成购买后，App Store在交易信息中的 appAccountToken 中返回相同的UUID。

ConsumptionRequest响应体要求将appAccountToken值设置为UUID或空字符串。

Alt text

而现在，苹果打通了 applicationUsername 和 appAccountToken，当用 Original StoreKit 创建订单时，applicationUsername 字段赋值使用 UUID 格式内容时，则可以在服务端通知或者解析收据(Receipt) 时，可以获取这个 UUID 值，也就意味着通过收据的信息就能够关联订单。