# 苹果小程序合作计划接入指南

更新时间：2026-08-03 17:54:05

目前为灰度阶段，有意愿接入的开发者请联系平台运营

# 一、什么是苹果小程序合作计划

苹果于 2025 年推出 Mini Apps Partner Program（小程序合作计划），参与该计划的小程序，符合条件的订单可享受更优惠的抽佣费率（具体费率以 Apple 官方政策为准）。

苹果官方公告：https://developer.apple.com/cn/news/?id=xcz1s7cz (opens new window)

快手小程序平台为此提供新链路支持，原 IAP 链路保留作为兜底。

# 二、新老链路说明

开发者接入方案：

开发者类型	接入工作
新增开发者（尚未接入 IAP）	新增开发者须通过合作计划接入苹果支付能力，不再单独开放原 IAP 链路
存量开发者（已接入 IAP）	完成退款消费信息回传能力的对接后，发起合作计划申请

新老链路对比如下：

	老链路（原 Apple IAP）	新链路（小程序合作计划）
价格档位	必须命中苹果价格档位，否则报错	不再要求；但支持降级时仍须命中
退款消费信息回传	不涉及	必须接入并返回消费信息建议（详见第三部分说明）
准入方式	开通 Apple IAP 即可	申请制，平台验收通过后可用
适用订单	全部 iOS IAP 订单	申请通过且满足用户APP 版本、iOS 系统版本、币种等条件的订单

新老链路路由规则：

新链路开通后，每一笔订单的实际链路由平台自动判断，开发者无需在下单接口中指定。路由判定逻辑如下：

申请阶段

路由规则

新链路申请通过之前

存量开发者，正常走老链路

新增开发者，不支持下单

新链路申请通过之后

优先走新链路，无法走新链路的情况下，根据开通时选择的方案决定是否降级到老链路

"无法走新链路"指订单存在以下情况之一：用户快手 APP 版本过低、用户 iOS 系统版本过低、订单币种非人民币等。

用户版本要求：客户端版本 14.5.30以上，iOS 版本 15.0 以上

最终订单走的是新链路还是老链路，平台通过支付回调及订单查询接口中的链路标识字段告知开发者，开发者据此进行对账与收入核算。

新链路申请入口：

示意图说明

申请入口：快手开放平台-交易-支付管理

降级选项：

默认：不满足新链路条件的订单，自动路由到旧链路，这种情况需要支付价格在价格档位中，否则仍会报错

只走新链路：不满足新链路条件的订单，直接报错，不做自动路由

申请要求

申请时会发送请求退款消费信息回调，内容为

{
    "data": {
        "app_id": "ksdemo",
        "out_order_no": "IAP_ADVANCED_OPEN_SERVICE", // 固定
        "ks_order_no": "IAP_ADVANCED_OPEN_SERVICE",  // 固定
        "biz_scene":"IAP_OPEN_SERVICE"
    },
    "biz_type": "REFUND",
    "message_id": "522c4733-99c1-4209-b4d2-c469bd9c376e",
    "app_id": "ks669628973557796916",
    "timestamp": 1722480483488
}

开发者需要在12个小时内退款消费信息回传接口进行上报，上报完成后会自动开通

# 三、开发者改造点

在原有IAP链路之外，开发者需要适配以下改造

改造点	接入要求	接入说明
退款消费信息回传	必须	苹果小程序合作计划申请的前置条件，需要完成对接后申请才会通过
价格档位适配	按需	新链路本身不再要求支付金额必须命中苹果价格档位。但需注意：开发者若选择「默认模式」（条件不满足自动回退老链路），降级的情况下必须命中苹果价格档位才能老链路下单成功
支付回调新增字段	按需	考虑到新老链路存在费率差异，因此在支付回调中新增了字段用于区分本单是走新链路还是老链路，开发者如有对账需求，可以根据该字段进行区分
账单新增字段	按需	考虑到新老链路存在费率差异，因此在账单查询结果中新增了字段用于区分本单是走新链路还是老链路，开发者如有对账需求，可以根据该字段进行区分

# 退款消费信息回传

苹果支付不支持线上主动退款，用户须通过苹果客服申请退款。在合作计划新链路下，苹果在做出退款决策前，会向平台索取该笔订单的消费信息，用于判断退款是否合理。该能力涉及两个动作：

退款消费信息请求回调：苹果将请求下发给平台，平台透传给开发者所配置的回调地址
退款消费信息回传接口：开发者收到回调后，将消费信息回传给平台，由平台代为提交苹果

具体接口字段及协议格式，以平台后续提供的研发对接文档为准。开发者侧需完成以下工作：

（1）在 12 小时内完成回传

收到退款消费信息请求回调后，开发者须在 12 小时内将消费信息回传至平台。逾期未回传或回传失败的，苹果将按其默认逻辑作出退款决策，并可能影响开发者后续在合作计划下的退款建议采纳率。如在 12 小时窗口内订单消费状态发生变化（例如由部分消费变为完全消费），建议主动重新回传更新后的消费信息。

（2）回传内容须真实

回传的消费信息须如实反映订单及用户的真实状态，包括但不限于商品消费进度、交付情况、是否提供过免费样本或试用，以及开发者对该笔退款的处理建议等。请勿虚假填报或误导性填写。

（3）获取用户授权

按苹果合规要求，开发者须在用户购买流程或退款流程中，明确告知用户并征得其同意，方可在回传内容中标识为已获得用户授权将消费信息共享给苹果。未获得授权的订单不得标识为已授权。授权交互的文案与位置须符合苹果官方文档要求，由开发者自行实现并承担相应合规责任。

Apple参考文档：

ConsumptionRequest：https://developer.apple.com/documentation/appstoreserverapi/consumptionrequest (opens new window)
Send Consumption Information：https://developer.apple.com/documentation/appstoreserverapi/send-consumption-information (opens new window)

注意事项

退款消费信息回传能力是合作计划的准入硬性条件。未接入、接入不完整或长期无法稳定回传的小程序，平台验收不通过，无法开通新链路；已开通后若长期未回传、超时回传或存在虚假填报，平台有权将其从合作计划中移除，相关订单回退至原 IAP 链路。

# 价格档位策略

新链路本身不再要求支付金额必须命中苹果价格档位。但需注意：

开发者若选择「默认模式」（条件不满足自动回退老链路），下单时传入的 user_pay_amount 仍必须命中苹果价格档位，否则一旦发生降级，老链路下单会失败报错。

两种模式对应的下单策略如下：

所选模式	下单时 user_pay_amount 传值要求
默认模式（支持降级）	建议仍按老链路规则传入：命中苹果价格档位
只走新链路模式	任意整数（单位：分），无需对齐档位

为兼容低版本用户、保障支付成功率，平台推荐开发者选择默认模式，并沿用老链路的价格档位下单逻辑。

# 支付回调字段适配

平台在原有支付回调及订单查询接口中新增链路标识字段，用于区分订单走新链路还是老链路。

开发者可以根据自身对账需求存储并使用对应信息

# 账单字段适配

下列各处均新增「本单是否为小程序合作计划」标识：

订单查询接口
账单查询接口
开发者后台账单导出

开发者可以根据自身对账需求存储并使用对应信息

# 四、结算规则说明

iOS 端走苹果支付渠道的小程序订单，开发者实收金额按以下方式计算：

开发者实收 = 用户支付金额 − 苹果服务费 − 平台技术服务费

项目

说明

用户支付金额

用户在小程序内实际支付的金额

苹果服务费

苹果公司按其官方政策收取的服务费，具体收取规则以苹果官方政策为准

订单类型	订单币种	费率
已加入小程序合作计划	人民币（CNY）	12%
未加入小程序合作计划	人民币（CNY）	25%
未加入小程序合作计划	其他币种	30%

币种判定以苹果 App Store 为准

平台技术服务费

(用户支付金额 − 苹果服务费) × 费率