苹果应用内购买(IAP)深度指南
面向使用 Flutter 的个人开发者,系统讲透 Apple In-App Purchase:规则边界、四种商品类型、2026 最新分成、App Store Connect 配置、in_app_purchase 实战、服务端校验、沙盒/TestFlight 测试、订阅运营与审核避坑。
一、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 内不得出现数字商品的外部支付入口、二维码、网址、"去官网开通会员"等引导。个人开发者不要在国区版本打擦边球。
二、四种内购类型与选型
| 类型 | 英文 | 典型用途 | 可重复购买 | 恢复机制 | StoreKit 2 交付 |
|---|---|---|---|---|---|
| 消耗型 | Consumable | 金币、积分、直播打赏、单次点数 | 是(用完再买) | 苹果不提供恢复,需自行账号体系记账 | 交易确认后即失效 |
| 非消耗型 | Non-Consumable | 去广告、永久解锁皮肤/功能、买断版 | 否,一次购买终身 | 必须提供「恢复购买」 | Transaction 永久在票据中 |
| 自动续期订阅 | Auto-Renewable Subscription | 月度/年度会员、Pro 订阅 | 到期自动扣款续期 | 必须可恢复;跨设备登录恢复 | 订阅状态机实时查询 |
| 非续期订阅 | Non-Renewing Subscription | 固定期限通行证(赛季卡、30 天会员) | 到期后用户手动再买 | 苹果不自动恢复,需自建账号体系同步 | 限期权益 |
选型决策
三、2026 年最新分成费率(重点)
3.1 全球基准费率
| 计划 | 普通抽成 | 订阅满 1 年后 |
|---|---|---|
| 标准计划(App Store 标准费率) | 30%(多数地区) | 15%(同一订阅组内累计付费满 12 个月) |
| 小企业计划 Small Business Program | 15%(含订阅从第一笔起) | 15% |
- 门槛:上一日历年通过 App Store 的净收入(proceeds,扣佣后口径)低于 100 万美元;当年一旦超过则恢复标准费率,次年重新判定。需在 App Store Connect 主动申请加入,不是自动生效。
- 个人开发者基本都符合,上架第一个付费 App 前就应申请。
- "订阅第二年 15%"按订阅组内累计付费时长计算;用户取消后 60 天内恢复可累计,超过 60 天重新计算。
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 IAP | 26% | 15% |
| 替代支付处理(Alternative Payment Processing) | 20% + 核心技术佣金(另算) | 10% |
3.4 实际到手收入怎么算
开发者收入(Proceeds)= 税后售价 − 苹果佣金。各地区售价多为含税价(中国区、欧盟、日本),苹果代缴间接税,佣金按税前金额计算。举例:
- 中国区订阅定价 ¥68/月(含税),增值税等扣除后税前假设约 ¥60.2;
- 小企业计划抽 12%:苹果抽约 ¥7.2,开发者 proceeds 约 ¥60.8(以「收入与 proceeds」报表为准);
- 定价档位是苹果固定价格层级(¥1、¥3、¥6、¥8、¥12、¥18、¥25、¥30、¥40、¥45、¥50、¥68、¥73、¥78、¥88、¥98、¥108、¥128、¥148、¥163、¥198、¥218、¥248、¥253、¥298、¥328、¥348、¥398、¥448、¥498……),不能填任意金额;2023 年后部分地区支持 900+ 更细价格点,但仍需在档位中选择。
四、前置条件:协议、税务、银行
没有完成以下配置时,内购商品在代码里拉不到(invalidProductIdentifiers),也无法提交审核。
五、App Store Connect 配置商品
路径:App Store Connect → 你的 App → 左侧「获利(Monetization)」区域。
5.1 消耗型 / 非消耗型
- 产品 ID(Product ID):唯一字符串,建议反域名风格
com.yourname.myapp.coins100/.pro_lifetime;创建后不可改、不可复用(删除后 ID 也不能再用)。 - 参考名称:后台管理用,用户不可见。
- 价格层级:从价格表中选择。
- 本地化信息:显示名称、描述(显示在系统购买弹窗中,必须如实)。
- App Store 审核截图:商品在 App 内的售卖界面截图(审核员看不到购买入口时的依据)。
- 非消耗型还需在「审核说明」写清恢复购买入口位置。
5.2 商品状态流转
- 商品被拒可单独修改重提,不必动 App 二进制。
- 已上线商品不能删除(只能下架)、不能改 ID,可以改价、改名、增加本地化。
5.3 本地化与价格
- 商品名称/描述支持按语言本地化,与 App 本地化语言对应。
- 价格可「按地区分别定价」,也可跟随统一基准价自动换算;做中国区建议手动核对中国区档位。
- 订阅支持「保留价格(grandfather)」老用户:提价时可选择不向现有订阅者涨价。
六、自动续期订阅深度专题
订阅是规则最多、运营空间最大的类型,个人开发者最常踩坑的也在这里。
6.1 订阅组(Subscription Group)
- 一个订阅组内放多个互斥的订阅商品(如月度 Pro、年度 Pro;终身不属于订阅)。
- 用户同一时间在一个组内只能有一个有效订阅;组内升级立即生效、降级到期生效,苹果自动计算退款/补差(proration)。
- 不同权益线应建不同组(如"视频会员"与"音乐会员"),用户可同时订阅多个组。
- 同组内累计付费满 12 个月费率降为 15%;换组重新计时。
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)
- 银行卡余额不足导致续费失败时,苹果不会立刻停订,而是进入账单重试期(最长约 60 天)。
- 可按订阅组开启宽限期,可选 3 / 16 / 28 天(2026 年可选档位);宽限期内继续给权益可显著降低非自愿流失。
- 对应通知:
GRACE_PERIOD_EXPIRED、DID_FAIL_TO_RENEW。
6.5 家人共享(Family Sharing)
- 自动续期订阅和非消耗型可开启家人共享,一个订阅最多共享给 5 名家庭成员。
- 开启后不可撤销;新购买自动支持共享,历史订阅可选择是否回溯生效。
- 家人退出家庭组触发
REVOKED通知,需要收权。
6.6 提价(Price Increase)
- 涨价需苹果审批;现有订阅者通常需在系统弹窗中同意新价格才按新价续费,不同意则到期失效(部分地区/小额涨价苹果可自动确认并发邮件通知)。
- 对应通知:
PRICE_INCREASE;想留住价格敏感用户可对老用户维持旧价(grandfather)。
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 原生侧补充配置
- StoreKit 2 最低 iOS 15;插件在 iOS 15+ 自动用 StoreKit 2,低版本回退 StoreKit 1。
- Capabilities 不需要额外开关 IAP(默认能力)。
- 需直接读取 StoreKit 2 字段可用
methodChannel写少量 Swift(Transaction.currentEntitlements、Product.subscription?.status),或用store_kit_wrappers。
7.7 付费墙(Paywall)合规布局
系统 StoreKit 确认弹窗之前,付费墙必须清晰展示:
- 订阅标题(如"Pro 年度会员");
- 订阅时长 + 每期价格(最好同时显示折算月均/日均);
- 试用说明:"免费试用 7 天,到期前 24 小时自动续订,¥xxx/年";
- 自动续费说明文字;
- 「使用条款(EULA)」与「隐私政策」可点链接;
- 恢复购买入口(可放在付费墙/设置页)。
八、服务端校验与 App Store Server API
8.1 为什么不能只信客户端
越狱设备、抓包重放、伪造票据都能让纯客户端校验失效。涉及以下任一情况必须有服务端:
- 消耗型商品(需要余额账本);
- 订阅(需要实时状态、续费/退款事件);
- 多端登录(iPhone / Android / Web 权益打通);
- 防止盗版。
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 后扩展) |
8.4 密钥配置(个人开发者)
App Store Connect → 用户与访问 → 集成 → App Store Connect API:
- 生成 API Key(Key ID + Issuer ID +
AuthKey_XXXXXX.p8),权限选「App 管理」或至少内购相关; .p8私钥只能下载一次,存服务端密钥管理,不要进 Git;- 服务端用 ES256 自签 JWT(有效期 ≤ 1 小时)调用 API;
- 通知 V2 URL 在 App 级「App 信息 → App Store 服务器通知」配置,生产/沙盒各一个。
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 本地测试
- Xcode → File → New → File → StoreKit Configuration File,文件内点 "+" 同步 App Store Connect 商品或手动建商品(可配试用期、周期、本地化价格)。
- Scheme → Run → Options → StoreKit Configuration 选择该文件。
- Editor 菜单可模拟:中断购买(Ask to Buy)、退款、批准、清除历史、加快订阅、家庭共享变更。
- Flutter 代码零改动,模拟器即可跑通全流程,适合开发期 90% 的逻辑调试。
9.2 沙盒账号与加速续订
- 创建:App Store Connect → 用户与访问 → 沙盒 → 测试员(邮箱不要与真实 Apple ID 重复)。
- 登录:iOS 设置中「开发者」菜单 / StoreKit 调试入口 → Sandbox Account;iOS 13+ 不需要退出主账号。
加速续订(沙盒特有,测续费/过期/重试):
| 实际周期 | 沙盒单次续订时长 | 最多续订 |
|---|---|---|
| 1 周 | 3 分钟 | 6 次/天 |
| 1 个月 | 5 分钟 | 6 次/天 |
| 2 个月 | 10 分钟 | 6 次/天 |
| 3 个月 | 15 分钟 | 6 次/天 |
| 6 个月 | 30 分钟 | 6 次/天 |
| 1 年 | 1 小时 | 6 次/天 |
沙盒中可在设置里手动「管理订阅」取消、触发退款测试等。
9.3 TestFlight 注意(2024-12 后变化)
- TestFlight 订阅续订改为每 24 小时一次,不再是几分钟一轮(苹果文档更新,未正式公告);想快速测多周期仍用沙盒账号。
- TestFlight 用真实 Apple ID 走沙盒付款,不会真实扣费,但购买历史不能清除;同一 Apple ID 的试用资格只能测一次。
- TestFlight 才能测:优惠码兑换链接、StoreKit 弹窗在生产签名下的真实表现、promoted IAP(商店页直接发起购买)。
9.4 服务端测试
- 在 App Store Connect 配置沙盒 V2 通知 URL,本地联调用 ngrok / Cloudflare Tunnel 暴露本地服务。
- API 沙盒基地址:
https://api.storekit-sandbox.itunes.apple.com;生产:https://api.storekit.itunes.apple.com。 - 服务端需根据 JWS 中的
environment(Sandbox/Production)自动切换回查地址——拿沙盒票据查生产或反之是经典线上 Bug。
十、审核高频被拒点(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 结算周期
- 按自然月结算,通常次月(约第 5 周)出账并打款;收入未达起付门槛(各币种不同,美元约 $10、人民币约 ¥20 量级,以后台为准)累计到下月。
- 销售和趋势(Sales and Trends):销售/订阅事件,T+1;付款和财务报告(Payments & Financial Reports):实际打款、按地区币种。
- 订阅关键指标:订阅者留存、转化、试用转正率、退款率、宽限挽回率,均在「订阅」报告中。
11.2 退款(Refund)
- 退款由苹果单方面裁决(用户在 reportaproblem.apple.com 申请);
- 收到
REFUND通知后必须收回权益:订阅立即失效、消耗型扣除对应虚拟物品(拿不回可记坏账,不能让用户继续使用退款商品); - 苹果决定退款前可能发
CONSUMPTION_REQUEST,服务端应回传消耗数据(商品是否已消耗、用户是否还能受益、refundPreference倾向),有助于降低恶意退款; - 退款金额从下期收入中冲抵(proceeds 被扣回)。
11.3 税务要点(个人)
- W-8BEN 每 3 年或信息变更时更新;
- 中国区收入由苹果按中国规则处理;美区 proceeds 对个人按协定预扣(税率以表格审核结果为准);
- 年度收入若达到中国境内个人所得税申报标准,自行依法申报经营所得/劳务报酬(咨询当地税务)。
十二、自建 vs RevenueCat:个人开发者怎么选
| 方案 | 优点 | 代价 | 适合 |
|---|---|---|---|
官方 in_app_purchase + 自建后端 |
零三方费用、数据自有、可控 | 要写并维护服务端、订阅状态机;以后上安卓还要再做 Google Play Billing 一套 | 有后端能力、用户量较大、想长期做 |
RevenueCat(purchases_flutter) |
一套 API 同时封装 StoreKit + Google Play;托管票据校验、V2/RTDN 通知、订阅状态、付费墙实验、客服工具;免费额度(月收入 $2.5k 以内)对个人友好 | 超免费额度抽成/订阅费;核心数据经第三方 | 无后端或不想碰支付后端、想快速双端上线 |
| 其他:Adapty、Qonversion、Superwall | 各有付费墙/实验优势 | 同样是第三方依赖与费用 | 有增长实验需求后再评估 |
推荐路径
十三、上线前 IAP Checklist
配置
- Paid Apps Schedule 协议 Active;银行账户、W-8BEN 已完成
- 已加入小企业计划(15%/12% 费率)
- 所有 Product ID 命名规范且与代码常量一致
- 商品本地化名称、描述、价格档位、审核截图齐全
- 订阅组结构合理;宽限期已开启;试用周期确定
- EULA / 隐私政策 URL 可访问;订阅管理入口、恢复购买按钮就位
- V2 通知 URL(生产 + 沙盒)已配置;API Key(.p8) 妥善保管
- 首版 IAP 商品已添加到版本提审页,随版本提交
客户端
- App 启动早期即监听
purchaseStream,所有路径都会completePurchase - 拉不到商品有降级 UI 与日志(pending/商店不可用处理)
- 价格一律显示
product.price,不写死 appAccountToken传合法 UUID- 消耗型发货成功后才 complete;有服务端幂等订单
- 付费墙信息完整(周期、价格、试用、续费、条款、隐私)
- 恢复购买在无购买时也有明确提示
- 支持 iPad?检查支付弹窗与付费墙适配
服务端(有后端时)
- JWS 证书链校验(生产/沙盒环境识别与基地址切换)
- 订阅状态表 + 每日对账兜底任务
- V2 通知幂等处理;REFUND/REVOKED/EXPIRED 收权
- CONSUMPTION_REQUEST 按时回传
- 接口鉴权(防止伪造用户 ID 领取权益)
测试
- StoreKit Configuration 跑通:购买、取消、Ask to Buy、退款、清除购买
- 沙盒账号:试用→续费→取消→过期全周期;升降级(同组 proration)
- 服务端沙盒通知联调(可用内网穿透)
- TestFlight 至少 2 人真实账号验证恢复购买与订阅管理跳转
- 断网/杀进程后重进:未完成交易队列正常补发、无重复弹窗
审核
- Review Notes 写明商品 ID、沙盒购买路径、恢复购买入口、条款链接
- 国区版本无任何外部支付/官网开通引导
十四、参考资料
Apple 官方
- In-App Purchase 概览
- 自动续期订阅介绍
- App Store Server API(verify / history / subscriptions)
- App Store Server Notifications V2
- StoreKit 2 Transactions 文档
- App Store 审核指南 3.1.1 App 内购买项目
- 沙盒测试与续订时长说明
- 配置优惠码 Offer Codes
- 小企业计划 Small Business Program
Flutter
费率与政策动态(2026)
- Apple Newsroom:Apple announces changes for apps in the European Union(EU 26%/20% 新体系,2026-10-01 生效)
- Apple 中国:App Store 生态助力开发者成功(中国区 25%/12% 费率)
- RevenueCat:How App Store fees work
- 外部支付链接美国诉讼进展(第九巡回法院 2025-12 裁定 / 最高法院 2026-06 调卷)