引言
在移动应用开发中，虚拟商品支付是核心功能之一，而针对iOS平台，苹果App Store强制要求虚拟商品必须通过其官方内购渠道完成交易，这使得Uniapp项目集成苹果内购成为iOS端开发的必备技能。本文将全面复盘Uniapp苹果内购支付的完整流程，涵盖Uniapp项目代码集成、苹果开发者后台App ID创建、App Store Connect内购项目配置及最终打包提交全环节，并提供可直接参考的实战代码示例，助力开发者快速攻克内购集成难题。
一、前期准备：明确核心前提与工具
在正式开始内购集成前，需确保完成以下基础准备工作，避免后续流程出现阻塞：
苹果开发者账号：必须拥有有效的苹果开发者账号（个人账号、公司账号均可，但个人账号无法使用某些企业级功能，推荐使用公司账号），且账号状态正常，已完成付费订阅。内购功能仅对已付费的开发者账号开放。
Uniapp项目基础：确保Uniapp项目已完成基础开发，明确需要接入内购的虚拟商品（如会员、积分、道具等），并规划好商品的唯一标识（将用于内购项目配置与代码关联）。
开发工具：准备好HBuilderX（用于Uniapp项目开发与打包）、Xcode（可选，用于iOS端调试），以及苹果开发者后台、App Store Connect后台的访问权限。
视频教程：
二、核心步骤一：Uniapp项目集成苹果内购代码
Uniapp封装了苹果内购的相关API，开发者无需深入原生开发即可快速集成。核心流程包括：获取支付渠道、请求商品信息、发起支付请求、处理支付结果。以下是完整的代码示例及详细解析。
2.1 完整集成代码示例
在Uniapp项目的页面组件中，可通过以下代码实现内购支付的核心逻辑，需根据实际业务场景修改商品标识、支付结果处理逻辑等内容：
// 触发苹果内购支付的入口函数 payFun() { let that = this; // 1. 获取当前设备支持的支付渠道 uni.getProvider({ service: 'payment', // 指定服务类型为支付 success: (paymentRes) => { // 筛选出苹果内购渠道（渠道ID为appleiap） const iapChannel = paymentRes.providers.find((channel) => { return channel.id === 'appleiap'; }); // 若未找到苹果内购渠道，提示不支持 if (!iapChannel) { uni.showToast({ title: '暂不支持苹果支付', icon: 'none', duration: 2000 }); return; } // 2. 请求商品信息（key为内购项目的产品ID，需与App Store Connect配置一致） let productId = 'newOceanOneYear'; // 示例：年度会员商品ID，多商品时可动态替换 iapChannel.requestProduct([productId], // 商品请求成功回调 function(orderList) { console.log('获取商品信息成功：', orderList); // 校验商品列表有效性，发起支付 if (orderList && orderList.length > 0) { that.applePay(orderList[0]); // 传入商品信息，执行支付 } else { uni.showToast({ title: '未获取到商品信息', icon: 'none' }); } }, // 商品请求失败回调 function(error) { console.error('获取商品信息失败：', error); uni.showToast({ title: '商品信息加载失败，请重试', icon: 'none' }); } ); }, // 获取支付渠道失败回调 fail(err) { console.error('获取支付渠道失败：', err); uni.showToast({ title: '支付功能初始化失败', icon: 'none' }); } }); }, // 发起苹果内购支付的具体实现 applePay(product) { const that = this; // 显示加载提示，防止用户重复操作 uni.showLoading({ title: '充值中请勿离开', mask: true// 遮罩，防止背景点击 }); // 3. 调用Uniapp支付API发起内购请求 uni.requestPayment({ provider: 'appleiap', // 固定为苹果内购渠道 orderInfo: { productId: product.productId, // 商品ID（与请求的商品信息一致） // 注意：苹果内购的orderInfo无需传入订单号等信息，由苹果后台生成交易凭证 }, // 支付成功回调 success: (payRes) => { uni.hideLoading(); console.log('支付请求成功：', payRes); // 苹果内购交易状态说明：transactionState为1表示交易成功 if (payRes.transactionState === 1) { uni.showToast({ title: '支付成功', icon: 'success' }); // 关键：此处需调用后端接口，传入支付凭证（payRes.transactionReceipt）进行验证 that.verifyPayment(payRes.transactionReceipt); } else { // 处理其他交易状态（如交易待确认、已取消等） uni.showToast({ title: '支付状态异常，请核实', icon: 'none' }); } }, // 支付失败回调 fail: (payErr) => { uni.hideLoading(); console.error('支付失败：', payErr); // 区分用户主动取消与其他错误 if (payErr.errMsg.includes('cancel')) { uni.showToast({ title: '您已取消支付', icon: 'none' }); } else { uni.showToast({ title: '支付失败，请重试', icon: 'none' }); } }, // 支付完成回调（无论成功失败都会执行） complete: () => { uni.hideLoading(); } }); }, // 支付凭证验证（核心：苹果内购必须通过后端与苹果服务器验证，防止本地伪造） verifyPayment(receipt) { // 调用后端接口，将凭证传给服务器进行验证 uni.request({ url: that.$api.verifyApplePay, // 后端验证接口地址 method: 'POST', data: { receipt: receipt, // 苹果返回的交易凭证 productId: 'newOceanOneYear', // 对应的商品ID userId: that.userId // 当前用户ID，用于关联订单 }, success: (res) => { if (res.data.code === 200 && res.data.data.isValid) { console.log('凭证验证成功，订单已确认'); // 执行后续业务逻辑（如更新会员状态、发放道具等） that.updateMemberStatus(); } else { console.error('凭证验证失败：', res.data.msg); uni.showToast({ title: '订单验证失败，请联系客服', icon: 'none' }); } }, fail: (err) => { console.error('验证接口请求失败：', err); uni.showToast({ title: '网络异常，订单验证中', icon: 'none' }); } }); }2.2 代码关键说明
支付渠道获取：通过
uni.getProvider获取设备支持的支付方式，筛选出苹果内购（appleiap），确保仅在支持的设备上触发内购。商品信息请求：
requestProduct方法传入商品ID，从苹果服务器获取商品的名称、价格等信息，避免本地硬编码价格导致与App Store不一致。支付结果处理：
transactionState为1是苹果内购成功的核心标识，但必须通过后端验证凭证，不能仅依赖前端状态——前端状态可被篡改，苹果服务器的凭证验证才是唯一可靠的依据。凭证验证：后端需将前端传入的
transactionReceipt提交至苹果的验证服务器（沙盒环境：https://sandbox.itunes.apple.com/verifyReceipt；正式环境：https://buy.itunes.apple.com/verifyReceipt），根据返回结果确认支付有效性。
三、核心步骤二：苹果开发者后台创建App ID并配置内购权限
App ID是应用的唯一标识，也是启用内购功能的基础。需在苹果开发者后台创建并配置对应的权限，具体步骤如下：
3.1 登录苹果开发者后台
访问苹果开发者官网（https://developer.apple.com/account/），使用已付费的开发者账号登录，进入“Certificates, Identifiers & Profiles”（证书、标识和配置文件）页面。
3.2 创建App ID
点击左侧“Identifiers”，然后点击右上角“+”号，选择“App IDs”，点击“Continue”。
选择“App”类型（适用于iOS、macOS等平台的应用），点击“Continue”。
填写App ID信息：Description：应用描述（如“XX会员服务App”），将显示在开发者后台。
Bundle ID：应用的唯一标识符，格式为反向域名（如“com.company.appname”），必须与Uniapp项目的“manifest.json”中配置的iOS Bundle ID完全一致，后续打包、上架均依赖此ID。
启用内购权限：在“Capabilities”列表中，找到“App内购买项目”（In-App Purchase）并勾选，确保该权限处于启用状态。其他权限根据应用需求选择，完成后点击“Continue”。
确认信息无误后，点击“Register”完成App ID创建。
3.3 关键注意事项
App ID创建后不可修改Bundle ID，因此需提前规划好格式；内购权限一旦勾选，无需额外申请，但需确保开发者账号状态正常，否则权限可能无法生效。
四、核心步骤三：App Store Connect配置内购项目
App Store Connect是管理应用上架、内购项目的平台，需在此处创建内购商品，并与Uniapp项目中的商品ID关联。核心目标是将虚拟商品信息录入苹果系统，使其能被App请求并完成交易。
4.1 登录App Store Connect并关联App
访问App Store Connect（https://appstoreconnect.apple.com/），使用与开发者账号关联的Apple ID登录。
若未创建应用，点击“我的App”→“+”号→“新建App”，填写应用名称、Primary Language、Bundle ID（选择步骤二中创建的App ID对应的Bundle ID）等信息，完成应用创建。若已创建应用，直接进入应用管理页面。
4.2 创建内购项目
进入应用管理页面，点击左侧“功能”→“App内购买项目”，然后点击右上角“+”号，选择内购项目类型。苹果内购项目分为以下几类，需根据商品类型选择：消耗型项目：如游戏道具、一次性积分，购买后可重复购买，消耗后需再次购买。
非消耗型项目：如永久解锁的功能，购买一次即可永久使用，支持恢复购买。
自动续期订阅：如月度/年度会员，到期自动扣费续期，支持免费试用。
非续期订阅：如季度会员，到期后需手动续期，不自动扣费。
以“自动续期订阅”（如年度会员）为例，选择对应类型后，点击“创建”。
填写内购项目基本信息：参考名称：仅用于开发者后台识别，如“年度会员-12个月”。
产品ID：核心标识，需与Uniapp代码中
productId完全一致（如示例中的“newOceanOneYear”），建议格式为“com.company.appname.productname”，便于管理。清理级别：根据商品内容选择，一般选择“4+”即可。
设置价格与地区：选择商品的价格等级（苹果提供固定的价格档位，不同地区货币自动转换），设置是否允许在特定地区销售，完成后点击“存储”。
填写商品描述与元数据：上传商品图标（尺寸为1024x1024，无圆角，PNG格式）、填写商品名称（将显示在App内购界面）、描述（介绍商品权益），完成后点击“存储”。
4.3 设置内购项目状态为“准备提交”
内购项目创建完成后，状态默认为“等待审核”，需手动将其设置为“准备提交”：在“App内购买项目”列表中，找到创建的项目，点击进入详情页，确认所有信息填写完整后，点击“状态”下拉框，选择“准备提交”。关键提醒：此时仅需将内购项目设置为“准备提交”，无需单独提交审核，后续与App一起提交审核即可，避免提前提交导致审核驳回。
五、核心步骤四：HBuilderX打包IPA并提交审核
Uniapp项目代码集成与苹果后台配置完成后，需通过HBuilderX打包生成iOS安装包（IPA），并提交至App Store Connect进行审核，审核通过后内购功能方可正式生效。
5.1 HBuilderX配置与打包
打开Uniapp项目，进入“manifest.json”配置页面，选择“App原生配置”→“iOS配置”：Bundle ID：填写与苹果开发者后台创建的App ID一致的Bundle ID（如“com.company.appname”）。
启用内购：在“模块配置”中，找到“Payment(支付)”模块，勾选“Apple In-App Purchase（苹果内购）”，确保该模块被启用。
点击“发行”→“原生App-云打包”，选择“iOS打包”：打包类型：若用于提交审核，选择“正式打包”；若用于测试，选择“测试打包”（需配置测试证书）。
证书配置：上传苹果开发者后台生成的发布证书（p12文件）与描述文件（mobileprovision），确保证书与Bundle ID匹配，且包含内购权限。
其他配置：根据需求设置应用名称、版本号等，点击“开始打包”，等待打包完成后下载IPA文件。
5.2 提交IPA至App Store Connect并关联内购项目
通过Xcode或Transporter工具将IPA文件上传至App Store Connect： Transporter工具：登录后点击“添加App”，选择下载的IPA文件，验证通过后点击“交付”，完成上传。
Xcode：连接iOS设备，选择“Window”→“Organizer”，找到打包的应用归档文件，点击“Distribute App”，选择“App Store Connect”，按提示完成上传。
关联内购项目：在App Store Connect的应用管理页面，进入“App信息”→“App内购买项目”，确保创建的内购项目已被关联至当前应用。
提交审核：进入“提交审核”页面，填写审核信息（如联系人、测试账号等），确认应用与内购项目均处于“准备提交”状态后，点击“提交审核”。苹果审核周期一般为1-3个工作日，审核通过后应用与内购功能将同步上线。
六、常见问题与避坑指南
商品请求失败：检查商品ID与App Store Connect配置的一致；确认App ID已勾选内购权限；测试时需使用沙盒测试账号，且设备未登录正式Apple ID。
支付成功后凭证验证失败：区分沙盒与正式环境——测试时后端需调用苹果沙盒验证接口，正式上线后切换至正式接口；确保凭证未被篡改，且与当前用户、商品ID关联正确。
审核驳回：内购项目未配置完整：检查内购项目的图标、描述、价格等信息是否填写完整；确保内购项目状态为“准备提交”，且与应用关联正确。
恢复购买功能缺失：对于非消耗型项目与订阅项目，需实现恢复购买功能（调用
iapChannel.restoreCompletedTransactions方法），否则可能被审核驳回。
七、总结
Uniapp苹果内购支付的核心在于“代码集成-后台配置-凭证验证-审核上线”的全流程闭环，其中商品ID的一致性、凭证的后端验证、内购项目的状态配置是关键节点。开发者需严格遵循苹果的规则，确保每一步操作符合规范，同时做好测试工作（使用沙盒测试账号模拟支付场景），避免上线后出现功能异常。通过本文的流程梳理与代码示例，希望能帮助开发者高效完成内购集成，为iOS用户提供流畅的支付体验。
