苹果应用内购买(IAP)深度指南

面向使用 Flutter 的个人开发者,系统讲透 Apple In-App Purchase:规则边界、四种商品类型、2026 最新分成、App Store Connect 配置、in_app_purchase 实战、服务端校验、沙盒/TestFlight 测试、订阅运营与审核避坑。

StoreKit 2 自动续期订阅 App Store Server API Server Notifications V2 Sandbox / TestFlight
4 种
内购商品类型
15%/12%
小企业/中国区费率
3 层
测试体系
14 章
深度内容

一、IAP 是什么、什么必须走 IAP

1.1 定义

IAP(In-App Purchase,应用内购买)是苹果官方的数字商品收款系统:用户用 Apple ID 绑定的支付方式(余额、银行卡、运营商代收费等)在 App 内付款,苹果代收后按月与开发者结算。技术上对应 iOS 的 StoreKit 框架。

StoreKit 1

老 API,基于 SKPaymentQueue + 本地 Receipt(PKCS#7 票据)。

StoreKit 2(iOS 15+)

Swift async/await,基于 JWS 签名交易,官方插件已默认使用。

Flutter 插件

in_app_purchase 从 3.3.0 起 iOS 默认走 StoreKit 2;需要旧版可显式 InAppPurchaseStoreKitPlatform.enableStoreKit1()。

1.2 什么「必须」用 IAP(Guideline 3.1.1)

场景支付方式
解锁会员 / 去广告 / 高级功能必须 IAP
虚拟货币、金币、道具、皮肤、游戏关卡必须 IAP
自动续期订阅(月度会员、年度 Pro)必须 IAP
App 内消费的数字内容(电子书、课程、云存储空间)必须 IAP
实物商品(电商、外卖、快递)必须第三方支付,禁止 IAP
线下服务(打车、理发、餐饮到店)必须第三方支付,禁止 IAP
P2P 转账、合规公益捐款、实体商品抽奖不走 IAP

一句话:在 App 内「使用/消费」的数字内容 → IAP;在现实世界交付的东西 → 第三方支付。

1.3 「反引导」(Anti-Steering) 规则的变化(截至 2026-10)

美国

Epic v. Apple 后续诉讼中,第九巡回法院 2025 年 12 月裁定苹果旧规则构成藐视法庭;美区 App 已允许放置外部购买链接(可跳 Stripe/Paddle),动态深链也被允许,不得设置"恐吓页"。链接抽成仍在司法进程(苹果申请最高约 15%),2026 年 6 月最高法院仅就"藐视法庭裁量标准"窄问题调卷,实体规则暂维持。

欧盟(DMA)

2026-10-01 起新费率体系生效,允许替代支付处理(Alternative Payment Processing)和站外引导,但需弹披露页(disclosure sheet),苹果仍抽取较低比例佣金。

中国大陆

仍执行严格反引导——App 内不得出现数字商品的外部支付入口、二维码、网址、"去官网开通会员"等引导。个人开发者不要在国区版本打擦边球。

个人开发者建议:除非明确只做美区/EU 且愿意承担合规与税务复杂度,否则数字内容一律老老实实走 IAP,这是过审与持续运营成本最低的方案。

二、四种内购类型与选型

类型英文典型用途可重复购买恢复机制StoreKit 2 交付
消耗型Consumable金币、积分、直播打赏、单次点数是(用完再买)苹果不提供恢复,需自行账号体系记账交易确认后即失效
非消耗型Non-Consumable去广告、永久解锁皮肤/功能、买断版否,一次购买终身必须提供「恢复购买」Transaction 永久在票据中
自动续期订阅Auto-Renewable Subscription月度/年度会员、Pro 订阅到期自动扣款续期必须可恢复;跨设备登录恢复订阅状态机实时查询
非续期订阅Non-Renewing Subscription固定期限通行证(赛季卡、30 天会员)到期后用户手动再买苹果不自动恢复,需自建账号体系同步限期权益

选型决策

1
永久买断功能 → 非消耗型
最简单,无服务器也能做。
2
持续运营、追求 LTV → 自动续期订阅
收入天花板高,但合规要求最多。
3
游戏经济 → 消耗型
必须有服务端记账,否则卸载重装金币丢失必投诉。
4
尽量避免非续期订阅
"到期管理 + 跨设备同步"全甩给开发者,用户易忘续费,审核也更关注。

三、2026 年最新分成费率(重点)

3.1 全球基准费率

计划普通抽成订阅满 1 年后
标准计划(App Store 标准费率)30%(多数地区)15%(同一订阅组内累计付费满 12 个月)
小企业计划 Small Business Program15%(含订阅从第一笔起)15%

3.2 中国大陆费率(2026-03-15 起调整)

苹果 2026 年 3 月 15 日下调了中国内地 App Store 数字商品/服务佣金,并作出"中国最低费率承诺"(不高于其他市场整体费率水平)。

计划调整前现行(中国内地)
标准开发者30%25%
小企业计划15%12%
小程序合作计划 Mini Apps Partner Program—12%

3.3 欧盟费率(2026-10-01 起新体系)

方式标准小企业/小程序/视频计划、订阅满 1 年
App 内使用 Apple IAP26%15%
替代支付处理(Alternative Payment Processing)20% + 核心技术佣金(另算)10%
仅对欧盟分发版本生效;替代支付意味着你要自己处理支付、退款、税务、客户支持,对个人开发者并不划算。

3.4 实际到手收入怎么算

开发者收入(Proceeds)= 税后售价 − 苹果佣金。各地区售价多为含税价(中国区、欧盟、日本),苹果代缴间接税,佣金按税前金额计算。举例:

定价建议:按 proceeds 倒推,而不是按竞品毛价拍脑袋。

四、前置条件:协议、税务、银行

没有完成以下配置时,内购商品在代码里拉不到(invalidProductIdentifiers),也无法提交审核。

1
付费 App 协议(Paid Apps Schedule)
App Store Connect →「业务 / Business」→「协议、税务和银行业务」→ 同意 Paid Apps Schedule。仅做免费 App 不需要;只要有 IAP(哪怕只卖 ¥1)就必须签。个人账号由 Account Holder(你本人)签署。
2
银行账户
填写可接收外汇的境内银行卡(提前与银行确认能接收"苹果电脑贸易(上海)有限公司"或 Apple Inc. 的美元/人民币结算款)。苹果按月结算,达到起付额才打款。
3
税务表单
中国个人开发者主要影响美区销售:填写 W-8BEN(非美国税务居民个人),按线上问卷完成;中国区销售由苹果按中国法规处理增值税,无需额外向美国报税;加/澳/日等区税务表按后台提示填,不确定就用默认。
4
协议变为「有效 / Active」
通常几分钟 ~ 1 个工作日,状态生效后再建商品。

五、App Store Connect 配置商品

路径:App Store Connect → 你的 App → 左侧「获利(Monetization)」区域。

5.1 消耗型 / 非消耗型

1
新建商品
「App 内购买项目」→ + → 选择类型。
2
填写核心信息
  • 产品 ID(Product ID):唯一字符串,建议反域名风格 com.yourname.myapp.coins100 / .pro_lifetime;创建后不可改、不可复用(删除后 ID 也不能再用)。
  • 参考名称:后台管理用,用户不可见。
  • 价格层级:从价格表中选择。
  • 本地化信息:显示名称、描述(显示在系统购买弹窗中,必须如实)。
  • App Store 审核截图:商品在 App 内的售卖界面截图(审核员看不到购买入口时的依据)。
  • 非消耗型还需在「审核说明」写清恢复购买入口位置。
3
随版本提交审核
状态变为「准备提交」后,必须在版本提交页的「App 内购买项目」区域添加,随 App 版本一起过审。

5.2 商品状态流转

缺少元数据 Missing Metadata→ 准备提交 Ready to Submit→ 等待审核 Waiting→ 正在审核 In Review→ 已批准 Approved(在售)/ 被拒 Rejected

5.3 本地化与价格

六、自动续期订阅深度专题

订阅是规则最多、运营空间最大的类型,个人开发者最常踩坑的也在这里。

6.1 订阅组(Subscription Group)

6.2 订阅周期与状态机

周期可选:1 周 / 1 个月 / 2 个月 / 3 个月 / 6 个月 / 1 年。StoreKit 2 / App Store Server API 中的订阅状态:

状态含义是否给权益
subscribed(active)正常有效✅ 给
inGracePeriod扣款失败但在宽限期内✅ 官方建议继续给
inBillingRetryPeriod扣款失败、苹果重试中(最多约 60 天),未开宽限期时看策略,通常给
expired已过期❌ 不给
revoked被苹果退款或家人共享被撤销❌ 应立即收回

6.3 三种优惠

优惠对象形式备注
介绍优惠
Introductory Offer
从未订阅过该订阅组的新用户 免费试用(3 天~1 年)/ 限期折扣 / 提前支付 每个账号只能享受一次,资格由 StoreKit 自动判定;试用结束自动按标准价续费
促销优惠
Promotional Offer
老用户(已订阅/曾订阅),用于召回、补偿 免费/折扣,需开发者服务端生成签名(StoreKit 2 中为 JWS Offer Signature) 需要付费 App 协议有效;在 App 内或邮件发放
优惠码
Offer Codes
可线下/线上分发的兑换码 唯一码或批量码,URL 一键兑换 适合 KOL 推广、客服补偿;用户可在 App Store「兑换礼品卡或代码」或通过链接使用

6.4 账单重试与宽限期(Billing Grace Period)

6.5 家人共享(Family Sharing)

6.6 提价(Price Increase)

6.7 订阅必须的合规素材

使用条款(EULA)

订阅规则、价格、续费、取消方式。可用苹果标准 EULA 或自建链接。

隐私政策链接

必须可公开访问。

付费墙(Paywall)信息

订阅时长、每期价格、试用转正式说明、自动续费说明、隐私政策与使用条款链接,缺一不可。

系统入口

App 内提供「管理订阅」入口(打开 https://apps.apple.com/account/subscriptions);必须提供「恢复购买」按钮。

七、Flutter in_app_purchase 实战(StoreKit 2)

插件:in_app_purchase(官方,pub.dev/packages/in_app_purchase,3.3.x 起 iOS 默认 StoreKit 2)。以下是最小可上线骨架;生产环境请配合服务端交付(见第八章)。

7.1 初始化与监听购买流

核心原则:购买结果通过全局 purchaseStream 异步回调,不能只依赖 buyXxx() 返回值。要在 App 启动早期订阅,处理中断的交易队列(StoreKit 会把未完成交易持续排队下发)。

import 'package:in_app_purchase/in_app_purchase.dart';

class IapService {
  final _iap = InAppPurchase.instance;
  StreamSubscription<List<PurchaseDetails>>? _sub;

  Future<void> init() async {
    final available = await _iap.isAvailable();
    if (!available) return; // 商店不可用(家长控制/设备受限)

    _sub = _iap.purchaseStream.listen(
      _onPurchases,
      onError: (Object e) => debugPrint('IAP error: $e'),
    );
  }

  Future<void> _onPurchases(List<PurchaseDetails> purchases) async {
    for (final p in purchases) {
      switch (p.status) {
        case PurchaseStatus.pending:
          // 正在等待用户操作(弹窗/家长批准),显示 loading
          break;
        case PurchaseStatus.purchased:
        case PurchaseStatus.restored:
          await _verifyAndDeliver(p);   // 校验 + 发货
          await _iap.completePurchase(p); // 关键:结束交易
          break;
        case PurchaseStatus.error:
          // 用户取消或支付失败
          await _iap.completePurchase(p);
          break;
        case PurchaseStatus.canceled: // 新版插件状态
          await _iap.completePurchase(p);
          break;
      }
    }
  }
}
completePurchase 必须调用:不结束交易,StoreKit 每次启动都会重复弹窗/重复下发队列,是经典"重复扣款弹窗"Bug 来源。消耗型在发货成功后 complete,非消耗型校验通过后 complete。

7.2 拉取商品

const _kIds = <String>{
  'com.yourname.myapp.pro_monthly',
  'com.yourname.myapp.pro_yearly',
  'com.yourname.myapp.pro_lifetime',
};

List<ProductDetails> products = [];

Future<void> loadProducts() async {
  final resp = await _iap.queryProductDetails(_kIds);
  if (resp.notFoundIDs.isNotEmpty) {
    // 拉不到?排查顺序:协议未生效 → 商品未 Cleared for Sale
    // → Product ID 拼错 → 设备商店账号地区不匹配 → 商品还没随版本过审
  }
  products = resp.productDetails;
}

展示价格时必须用 product.price(已本地化含货币符号),不要自己写死"¥68"。

7.3 发起购买

Future<void> buy(ProductDetails product, {bool isConsumable = false}) async {
  // StoreKit 2:applicationUserName 必须是合法 UUID,
  // 会映射为 appAccountToken(UUID),用于把交易绑定到你的用户 ID
  final userUuid = _uuidForAccount(myBackendUserId);

  final param = product is AppStoreProductDetails
      ? AppStorePurchaseParam(
          productDetails: product,
          applicationUserName: userUuid,
        )
      : PurchaseParam(productDetails: product);

  if (isConsumable) {
    await _iap.buyConsumable(purchaseParam: param);
  } else {
    // 非消耗型 & 自动续期订阅都走这个
    await _iap.buyNonConsumable(purchaseParam: param);
  }
}
常见坑 appAccountToken == null:StoreKit 2 要求 applicationUserName 必须是 UUID 格式字符串(如 123e4567-e89b-...),传自增数字 ID 会被置空。正确做法:用户注册时分配 UUID,或建立内部用户 ID ↔ UUID 映射表。

7.4 恢复购买(审核必查)

Future<void> restore() async {
  // StoreKit 2 下会把当前 Apple ID 的非消耗型/订阅交易重新推入 purchaseStream
  await _iap.restorePurchases();
}

在设置页放「恢复购买」按钮。restorePurchases() 对消耗型无效(不进可恢复列表),这也是消耗型必须服务端记账的原因。

7.5 判断订阅是否有效

通用层 PurchaseDetails 信息偏薄(verificationData.localVerificationData 即 StoreKit 2 的 JWS Transaction 签名串,另有 transactionDate、productID、originalTransactionID)。

订阅期、试用、宽限期等精确状态不要只凭客户端 transactionDate + 周期时长 本地推算(跨时区、退款、家庭共享、改价都会出错)。请走第八章的服务端方案:拿 JWS 后交给服务器用 App Store Server API 查实时状态,或直接采用 RevenueCat 等封装。

7.6 iOS 原生侧补充配置

7.7 付费墙(Paywall)合规布局

系统 StoreKit 确认弹窗之前,付费墙必须清晰展示:

八、服务端校验与 App Store Server API

8.1 为什么不能只信客户端

越狱设备、抓包重放、伪造票据都能让纯客户端校验失效。涉及以下任一情况必须有服务端:

极简无服务器场景:一个非消耗型解锁、无账号体系时,可仅靠 StoreKit 2 的 JWS 客户端基本校验 + currentEntitlements 判定,能过审但防护弱。

8.2 技术演进

StoreKit 1:本地 Receipt(PKCS#7) → POST /verifyReceipt
           (2023 起 deprecated,仍可用但不推荐新项目)
StoreKit 2:每笔交易返回 JWS 签名串 → 服务端验证 x5c 证书链
           → 调 App Store Server API 查状态
事件推送:App Store Server Notifications V2
         (JWS 签名 POST 到你的回调 URL)

8.3 服务端要做的事

① 验证 JWS:用苹果根证书(AppleRootCA)校验 x5c 证书链与签名,解析 payload 中的 transactionId、productId、expiresDate、offerType、appAccountToken 等。

② 绑定用户:用 appAccountToken(下单时传入的 UUID)把交易关联到你系统的用户。

③ 实时查询(REST + JWT Bearer 鉴权):

Endpoint用途
GET /inApps/v2/history/{originalTransactionId}全部历史交易(V2 不再按类型/状态过滤)
GET /inApps/v1/transactions/{transactionId}单笔交易详情(发货前二次确认)
GET /inApps/v1/subscriptions/{originalTransactionId}订阅当前状态(active/宽限/过期/重试)
POST /inApps/v1/refund/lookup/{originalTransactionId}查询退款
POST /inApps/v1/consumption/{originalTransactionId}苹果退款征询时上报消耗情况(可带 refundPreference 表达倾向)
POST /inApps/v1/notifications/test测试 V2 通知

④ 接收 V2 通知(关键事件):

notificationType处理
SUBSCRIBED(含 INITIAL_BUY/RESUBSCRIBE 等 subtype)开通/重新订阅 → 发货
DID_RENEW续费成功 → 延长权益(以 JWS 中 expiresDate 为准)
OFFER_REDEEMED优惠/优惠码兑换
DID_CHANGE_RENEWAL_STATUS用户在系统设置关/开自动续费(关闭不立即失效,到期才停)
DID_FAIL_TO_RENEW扣款失败(可能 in grace / retry)
GRACE_PERIOD_EXPIRED宽限期结束仍未扣款 → 准备收权
EXPIRED订阅到期 → 收权
REFUND苹果批准退款 → 立即收回权益;消耗型记录并扣减
REVOKED家人共享被撤销 → 收权
PRICE_INCREASE涨价待用户确认
CONSUMPTION_REQUEST退款征询,12~24 小时内回传 consumption 数据
ONE_TIME_CHARGE非订阅购买相关更新(含退款,2024 后扩展)
通知要求服务端对 Apple 服务器快速返回 200(先 ACK 再异步处理),处理要幂等(同一事件可能重推)。

8.4 密钥配置(个人开发者)

App Store Connect → 用户与访问 → 集成 → App Store Connect API:

8.5 极简服务端架构建议

两个接口

POST /api/iap/apple/verify(收 JWS → 验签 → 查 API → 写权益表);POST /api/iap/apple/webhook(V2 通知,幂等处理)。

一张订阅表

user_id, original_transaction_id(PK), product_id, status, expires_at, auto_renew, app_account_token, updated_at

定时对账兜底

每天对临近过期/重试中的订阅主动调 subscriptions 接口对账——通知可能丢失。

零成本起步

没有后端经验可用 Cloudflare Workers / Vercel Serverless + Supabase/D1。

九、三层测试体系:本地 / 沙盒 / TestFlight

层级环境账号能测什么速度
StoreKit Configuration(本地)Xcode 本地文件,断网可跑不需要购买/取消/退款/试用/升降级/家庭共享的 UI 与逻辑秒级
Sandbox 沙盒苹果测试服务器沙盒专用测试账号(ASC 手动创建)真实商品、续订/宽限/重试、服务端联调、V2 沙盒通知快
TestFlight沙盒后端测试者真实 Apple ID最接近生产;中断交易、Ask to Buy、促销优惠码最真实,购买记录不可清除

9.1 StoreKit Configuration 本地测试

  1. Xcode → File → New → File → StoreKit Configuration File,文件内点 "+" 同步 App Store Connect 商品或手动建商品(可配试用期、周期、本地化价格)。
  2. Scheme → Run → Options → StoreKit Configuration 选择该文件。
  3. Editor 菜单可模拟:中断购买(Ask to Buy)、退款、批准、清除历史、加快订阅、家庭共享变更。
  4. Flutter 代码零改动,模拟器即可跑通全流程,适合开发期 90% 的逻辑调试。

9.2 沙盒账号与加速续订

加速续订(沙盒特有,测续费/过期/重试):

实际周期沙盒单次续订时长最多续订
1 周3 分钟6 次/天
1 个月5 分钟6 次/天
2 个月10 分钟6 次/天
3 个月15 分钟6 次/天
6 个月30 分钟6 次/天
1 年1 小时6 次/天

沙盒中可在设置里手动「管理订阅」取消、触发退款测试等。

9.3 TestFlight 注意(2024-12 后变化)

9.4 服务端测试

十、审核高频被拒点(3.1.1 系列)

条款被拒原因解决方案
3.1.1 数字内容未走 IAP会员页出现微信/支付宝/Stripe、官网价格、二维码、"去网页开通"国区删除一切外部引导;美区外部链接需符合最新反引导裁决并披露
3.1.1 缺少恢复购买找不到 Restore 按钮设置页/付费墙放「恢复购买」,restorePurchases() 真实可用
3.1.2 订阅信息不透明付费墙没写价格、周期、试用转正、续费规则补齐全部法定要素 + EULA + 隐私政策链接
3.1.1 实物误用 IAP实物商品/线下服务放进了 IAP数字内容才用 IAP,实物走三方支付
3.1.3 「阅读器」规则外部购买的内容(如自己网站买的课程)在 App 内消费纯"阅读器/播放器"允许外部内容流入,但 App 内不得引导购买外部内容
3.1.4 多平台内容用户在网页/安卓买了会员,iOS 不让用允许外部已购权益在 iOS 内可用(不得在 App 内引导购买即可)
沙盒无法购买审核员环境拉不到商品商品随版本提交、状态 Approved、协议有效、价格档位覆盖审核地区
无有效订阅测试路径审核员不知如何验证付费功能备注写明沙盒可直接购买;或提供已开通会员的测试账号(服务端后台开通)
诱导/误导定价"永久免费试用"、虚假倒计时、虚假评论文案真实;试用明确日期;促销倒计时真实
IAP 商品元数据问题商品名/截图与 App 内不符、描述空泛写清用途("100 金币,可用于解锁 XX 章节"),上传真实售卖页截图

审核备注(Review Notes)模板

本 App 含自动续期订阅 IAP:
- 月度商品 ID:xxx,年度商品 ID:xxx;
- 审核环境可直接使用沙盒 Apple ID 完成购买,无需真实付款;
- 「恢复购买」位于:我的 → 设置 → 恢复购买;
- 使用条款:https://xxx/terms,隐私政策:https://xxx/privacy;
- 付费入口:首页右上角「Pro」按钮。

十一、收入结算、退款与报表

11.1 结算周期

11.2 退款(Refund)

11.3 税务要点(个人)

十二、自建 vs RevenueCat:个人开发者怎么选

方案优点代价适合
官方 in_app_purchase + 自建后端 零三方费用、数据自有、可控 要写并维护服务端、订阅状态机;以后上安卓还要再做 Google Play Billing 一套 有后端能力、用户量较大、想长期做
RevenueCat(purchases_flutter) 一套 API 同时封装 StoreKit + Google Play;托管票据校验、V2/RTDN 通知、订阅状态、付费墙实验、客服工具;免费额度(月收入 $2.5k 以内)对个人友好 超免费额度抽成/订阅费;核心数据经第三方 无后端或不想碰支付后端、想快速双端上线
其他:Adapty、Qonversion、Superwall 各有付费墙/实验优势 同样是第三方依赖与费用 有增长实验需求后再评估

推荐路径

1
第一个 App、只有 iOS、商品简单
1~2 个订阅 + 一个买断:RevenueCat 起步最快,精力放在产品上。
2
有后端能力或商品逻辑复杂
虚拟货币账本、跨平台权益:官方插件 + 自建校验服务。
3
认清官方插件是薄封装
购买触发之外的校验、状态追踪、Webhook、分析全要自建——选型时把这部分工作量算进去。

十三、上线前 IAP Checklist

十四、参考资料

Apple 官方

Flutter

费率与政策动态(2026)

免责声明:本文基于 2026 年 10 月可获取的官方文档、政策公告与公开报道整理,苹果费率、审核口径与各地区法规仍在快速变化(尤其美区外部支付诉讼、EU DMA 执行细则、中国区费率与备案)。正式定价、提审与结算前,请以 App Store Connect 后台实时显示及 Apple 官方英文条款为准,必要时咨询专业税务/法律顾问。