更新记录

1.0.0（2026-10-30）

• 新增 iOS 15+ StoreKit 2 商品查询与消耗型、非消耗型、非自动续期订阅、自动续期订阅购买能力。
• 新增已验证交易 JWS、业务账户 UUID 关联、当前权益、最近交易、未完成交易查询和更新监听，供业务核验与补单。
• 新增交付声明校验与手动完成交易、用户主动恢复购买、订阅与续期信息验证及首购优惠资格查询。
• 新增系统订阅管理、退款申请与 iOS 16+ 优惠码兑换入口，并明确系统页回执和业务结果的区别。
• 新增原生交互互斥、请求期限、单次结果与完成回调、有界批量部分结果、迟到交易处理及监听释放能力。
• 新增 Native/UTS 构建身份核对、本地有界脱敏诊断、完整报告、固定快照分段复制及复制失败手动回退。
• 新增 uni-app（Vue2 / Vue3）与 uni-app x 的商品、交易、订阅、配置四类 Tabs 示例，覆盖全部 19 个公开 API。
• 新增 Apple 官方服务端库验签参考、证书根指纹核对与应用、商品、账户、环境策略校验，不代替业务幂等交付或实时权益核对。

平台兼容性

uni-app(5.33)

uni-app x(5.33)

lizhao-apple-iap 苹果内购 苹果应用内购买与交易管理 UTS插件

介绍

lizhao-apple-iap 为 uni-app 与 uni-app x 提供 iOS StoreKit 2 应用内购买、交易恢复和订阅管理源码，适合应用内数字内容与权益接入。本次整理首次发布配置；已有本地合同、宿主资源与生成物验证，匹配基座、Apple 原生编译和沙箱业务验收仍是独立门槛。

iOS 15+ 为目标运行范围，优惠码系统页需 iOS 16+。插件保留两个宿主的同一套 API；其他平台提供能力说明及明确拒绝，不能在 Android、Harmony、Web 或小程序完成 Apple 支付。

功能特色

14 个异步入口返回字符串请求编号，按 success 或 fail → complete 派发一次终态。金额和交易 ID 保持字符串；原生验证通过仍需业务服务端验签、核对归属并持久化交付。

适合哪些场景

下载与导入

从基础到进阶：按业务模块使用

基础功能配置示例

准备应用与商品

Apple 的商品配置和沙箱流程见 配置内购 与 沙箱测试。商品配置传播并非即时；缺失时先核对 Bundle ID、Product ID、环境与协议，不凭空生成商品 ID。Product ID 应符合 Apple 商品信息规则（最长 100 个字符）；插件本地通用校验上限为 255，并不扩大 Apple 后台限制。

将对应项合并到自己工程的 pages.json 的 pages 数组，保留原有页面。下面分别为两个宿主的真实路径，不需要同时注册：

{
  "path": "uni_modules/lizhao-apple-iap/example/uniappx/index",
  "style": { "navigationBarTitleText": "苹果内购" }
}

{
  "path": "uni_modules/lizhao-apple-iap/example/uniapp/index",
  "style": { "navigationBarTitleText": "苹果内购" }
}

以下为 uni-app x 的 UTS 函数，传入自己创建的真实商品 ID 后调用 loadIapProduct。先检测能力，初始化成功后再查询；空商品不会被替换为演示商品。

import { getIapCapabilitiesSync, initializeIap, getIapProducts } from '@/uni_modules/lizhao-apple-iap'

function loadIapProduct(productId: string): void {
  const capability = getIapCapabilitiesSync()
  if (!capability.available) {
    console.log('当前不可用：' + capability.reason)
    return
  }
  initializeIap({
    timeoutMs: 30000,
    success: () => {
      getIapProducts({
        productIds: [productId],
        timeoutMs: 30000,
        success: (result) => { console.log('商品=' + result.products.length + '；缺失=' + result.missingProductIds.length) },
        fail: (error) => { console.log(error.errSubject + ' ' + error.errCode + ' ' + error.errMsg) },
        complete: (result) => { console.log('查询结束：' + result.outcome) }
      })
    },
    fail: (error) => { console.log('初始化失败：' + error.errCode + ' ' + error.errMsg) },
    complete: (result) => { console.log('初始化调用结束：' + result.outcome) }
  })
}

没有真实商品时，可以检测能力、检查参数错误及查看报告；不能据此验收购买。上例只输出摘要，不打印交易、JWS 或账户 UUID。uni-app 的可直接使用 JavaScript 流程见下方“完整示例”。

高级示例

下列 UTS 函数在初始化成功后由相应业务操作调用。购买、恢复、退款、管理和兑换必须来自用户明确操作；所有商品/交易/账户参数使用自己的真实值。

商品查询与购买选项

查询时传入实际在 App Store Connect 配置的商品 ID。查询通过 StoreKit 获取真实商品；缺失ID列在 missingProductIds 中，网络或环境异常进入 fail。购买入口不能因为网络超时自动重复调用。

import { getIapProducts, purchaseIapProduct } from '@/uni_modules/lizhao-apple-iap'

function queryProducts(productId: string): void {
  getIapProducts({
    productIds: [productId],
    timeoutMs: null, // null 使用查询默认值 30000 毫秒
    success: (result) => { console.log('找到商品：' + result.products.length) },
    fail: (error) => { console.log('查询失败：' + error.errCode) },
    complete: (result) => { console.log('查询完成：' + result.outcome) }
  })
}

function requestPurchase(productId: string, accountToken: string | null): void {
  purchaseIapProduct({
    productId: productId,
    appAccountToken: accountToken,
    quantity: 1,
    timeoutMs: 120000, // 购买默认值；范围 1000–600000 毫秒
    success: (result) => {
      // 本地verified后仍需将JWS交给自己的服务端核对、验签和发货；不要打印。
      console.log('已收到已验证交易，仍需完成业务交付')
    },
    fail: (error) => {
      if (error.outcome == 'pending') console.log('待审批，等待后续交易更新')
      else if (error.outcome == 'unknown') console.log('结果未知，先核对交易，禁止自动重购')
      else if (error.outcome == 'cancelled') console.log('用户取消')
      else console.log('购买失败：' + error.errCode)
    },
    complete: (result) => { console.log('本次调用结束：' + result.outcome) }
  })
}

交付确认、恢复与监听生命周期

业务服务器验签并持久化发货后才允许确认交易；deliveryConfirmed 是调用者的明确声明，不能替代服务端证明。以下函数应只由业务确认流程调用，不能放在购买成功回调里无条件执行。

import { initializeIap, finishIapTransaction, restoreIapPurchases, onIapTransaction, offIapTransaction } from '@/uni_modules/lizhao-apple-iap'

let listenerId: string | null = null

function confirmDeliveredTransaction(transactionId: string, deliveryConfirmed: boolean): void {
  finishIapTransaction({
    transactionId: transactionId,
    deliveryConfirmed: deliveryConfirmed,
    timeoutMs: 30000,
    success: (result) => { console.log('交易确认完成') },
    fail: (error) => { console.log('确认失败：' + error.errCode) },
    complete: (result) => { console.log('确认结束：' + result.outcome) }
  })
}

function restoreFromUserAction(): void {
  restoreIapPurchases({
    success: (result) => { console.log('恢复查询完成，部分结果不完整：' + result.partial) },
    fail: (error) => { console.log('恢复失败：' + error.errCode) }
  })
}

initializeIap({
  success: () => {
    const listener = onIapTransaction((event) => { console.log('交易事件类型：' + event.kind) })
    if (listener.registered) listenerId = listener.subscriptionId
    if (listener.error != null) console.log('监听未注册：' + listener.error.errCode)
  },
  fail: (error) => { console.log('初始化失败：' + error.errCode) }
})
function removePageListener(): void {
  const id = listenerId
  if (id != null) {
    const removed = offIapTransaction(id)
    listenerId = null
    if (!removed.removed) console.log('未移除监听')
  }
}

恢复应来自用户主动操作。交易更新可能涉及撤销或续订，不能仅按交易 ID 忽略后续事件。disposeIap 释放观察与回调，不撤销Apple交易；真实请求仍未返回时返回9362019。完整页面的卸载处理与报告入口可分别在上述两种宿主示例中查看。

权益、订阅和系统页

初始化成功后查询权益；消耗型补单使用未完成交易查询。订阅状态中的 transaction 和 renewalInfo 都经过验证，无法验证的条目放入 issues；partial=true 时不能将其当成全部权益。当前权益不替代服务端账本，也不能用 willAutoRenew 单独判断当前已付费。

import { getIapCurrentEntitlements, getIapLatestTransaction, getIapSubscriptionStatus, isIapIntroOfferEligible, showIapManageSubscriptions, requestIapRefund, presentIapOfferCodeSheet, IapFail } from '@/uni_modules/lizhao-apple-iap'

function logFailure(error: IapFail): void { console.log(error.errSubject + ' ' + error.errCode + ' ' + error.errMsg) }
function inspectSubscription(productId: string): void {
  getIapCurrentEntitlements({
    success: (r) => { console.log('权益=' + r.transactions.length + '，问题=' + r.issues.length + '，partial=' + r.partial) }, fail: logFailure
  })
  getIapLatestTransaction({productId: productId, success: (r) => { console.log('有最近交易：' + r.found) }, fail: logFailure})
  getIapSubscriptionStatus({productId: productId, success: (r) => { console.log('订阅状态条数：' + r.statuses.length + '，partial=' + r.partial) }, fail: logFailure})
  isIapIntroOfferEligible({productId: productId, success: (r) => { console.log('已配置优惠：' + r.offerConfigured + '，资格：' + r.eligible) }, fail: logFailure})
}
function manageFromUserAction(): void {
  showIapManageSubscriptions({success: (r) => { console.log('系统管理页返回：' + r.state) }, fail: logFailure})
}
function refundFromUserAction(transactionId: string): void {
  requestIapRefund({transactionId: transactionId, success: (r) => { console.log('退款申请状态：' + r.state) }, fail: logFailure})
}
function redeemFromUserAction(): void {
  presentIapOfferCodeSheet({success: (r) => { console.log('兑换页返回：' + r.state) }, fail: logFailure})
}

退款返回 submitted 仅为申请受理，实际退款需核对交易撤销和服务器通知。订阅管理、兑换页返回 dismissed 不代表已经退订或兑换；真实交易由 updates/unfinished 交付。系统交互串行执行，超时后仍等待系统真正返回再解锁，不能因收到超时立即重购。

独立服务器验签参考

随插件交付 uni_modules/lizhao-apple-iap/server-example/package.json、uni_modules/lizhao-apple-iap/server-example/package-lock.json、uni_modules/lizhao-apple-iap/server-example/verifier.mjs、uni_modules/lizhao-apple-iap/server-example/verify-cli.mjs、uni_modules/lizhao-apple-iap/server-example/prepare-roots.mjs 和 uni_modules/lizhao-apple-iap/server-example/verifier.test.mjs。将整个服务器目录复制到独立服务器位置，再执行依赖安装，避免将 node_modules 或服务器配置打进客户端。

下面是 PowerShell 本地接入路径。C:/iap-server、C:/iap-server-private 及票据文件均由接入者自行准备；示例应用/商品/UUID须改成服务器真实登记和认证会话绑定值。JWS 经标准输入传入，不放命令行参数、日志或仓库。

Copy-Item -LiteralPath 'uni_modules/lizhao-apple-iap/server-example' -Destination 'C:/iap-server' -Recurse
Set-Location 'C:/iap-server'
npm ci --ignore-scripts
node prepare-roots.mjs --out 'C:/iap-server-private/apple-roots'
$env:APPLE_BUNDLE_ID = 'com.example.app'
$env:APPLE_ENVIRONMENT = 'Sandbox'
$env:APPLE_ROOT_CERT_PATHS = '["C:/iap-server-private/apple-roots/AppleRootCA-G3.cer","C:/iap-server-private/apple-roots/AppleRootCA-G2.cer"]'
$env:APPLE_PRODUCT_IDS = '["com.example.month"]'
$env:APPLE_PRODUCT_ID = 'com.example.month'
$env:APPLE_ACCOUNT_TOKEN = 'a7ca128f-6758-4b13-8ef1-05a27871675e'
# Production 使用服务器实际 App Store 数字编号；下面仅演示配置位置。
# $env:APPLE_APP_ID = '1234567890'
$env:APPLE_ENABLE_ONLINE_CHECKS = 'true'
Get-Content -LiteralPath 'C:/iap-server-private/transaction.jws' -Raw | node verify-cli.mjs

要求 Node.js 20+；固定依赖 Apple 官方 App Store Server Library。根证书仅从 Apple PKI 下载并核对固定指纹，已有不同目标不覆盖。缺应用、商品目录、环境、根或账户上下文均拒绝；Production 还必须设置实际 App Store 应用数字编号 APPLE_APP_ID。默认开启在线证书状态检查，离线开关只影响证书检查方式，不查询实时退款状态。服务器验签不需要把 .p8 私钥放到客户端。

业务服务端可从实际文件 uni_modules/lizhao-apple-iap/server-example/verifier.mjs 导入 readVerifierConfig 和 createTransactionVerifier。verifyForAccount 的第二参数必须来自服务器认证会话，不能直接相信客户端声称的账户 UUID。返回 verified 只表示签名和原文策略通过，currentStatusChecked=false、deliveryPerformed=false：还须通过 App Store Server API 和 Notifications V2 核对当前退款/权益，持久化幂等发货后才允许客户端 finish。历史有效JWS不能证明后来没有退款。

非续期订阅返回 requiresBusinessExpiry=true，必须由业务计算有效期；自动续期已过期按保守规则拒绝，宽限/账单重试需要另外验证当前续期状态。旧账户、家庭共享、缺 token 交易不会自动认领给当前账户。Xcode本地StoreKit Test票据不是Apple服务器证书链，服务器示例故意不信任；真实服务器集成使用Sandbox/TestFlight或Production签名交易。示例不提供公网接口、订单库或虚构发货成功。

批量、数量、超时与诊断配置

以下 UTS 代码演示可选参数的实际传入方式。仅定义函数，不在加载示例时发起购买；buyTwoConsumables 只适用于已查询确认的消耗型商品。

import { getIapProducts, purchaseIapProduct, getIapDiagnosticsSync, setIapDiagnosticsEnabled } from '@/uni_modules/lizhao-apple-iap'

function queryTwoProducts(firstId: string, secondId: string): void {
  getIapProducts({
    productIds: [firstId, secondId], timeoutMs: 30000,
    success: (result) => { console.log('商品数：' + result.products.length) },
    fail: (error) => { console.log('查询失败：' + error.errCode) },
    complete: (result) => { console.log('查询结束：' + result.outcome) }
  })
}
function buyTwoConsumables(productId: string): void {
  purchaseIapProduct({
    productId: productId, appAccountToken: null, quantity: 2, timeoutMs: 120000,
    success: () => { console.log('收到已验证交易，等待业务服务端核对与交付') },
    fail: (error) => { console.log('购买状态：' + error.outcome + '；错误=' + error.errCode) },
    complete: (result) => { console.log('请求结束：' + result.outcome) }
  })
}
function inspectIapDiagnostics(): void {
  setIapDiagnosticsEnabled(false)
  const snapshot = getIapDiagnosticsSync()
  console.log('版本来源=package生成字段；条数=' + snapshot.entries.length + '；丢弃=' + snapshot.droppedEntries)
  setIapDiagnosticsEnabled(true)
}

完整示例

Tabs 功能导航与测试方法

两种宿主都使用同一功能分组。默认显示“商品”，切换 Tabs 只改变展示，不清除商品/交易参数、不重新调用 API、不取消原生操作，也不重新生成日志快照。忙碌、最近结果和底部诊断跨分类可见。

uni-app x：完整初始化、查询、监听和释放流程

下面代码可放入 UTS 页面脚本。点击页面按钮调用 startIapExample，传入真实 Product ID；查询结束后解除忙碌。示例用 event.kind 展示事件摘要，业务处理交易时不得打印签名。页面拥有独立监听，卸载只移除自己的句柄；只有应用确实不再使用内购且无在途请求时才显式调用 releaseIapService。

import { onUnload } from '@dcloudio/uni-app'
import { getIapCapabilitiesSync, initializeIap, getIapProducts, onIapTransaction, offIapTransaction, disposeIap } from '@/uni_modules/lizhao-apple-iap'

let requestBusy = false
let pageActive = true
let listenerId: string | null = null

function removeExampleListener(): void {
  const id = listenerId
  if (id == null) return
  const result = offIapTransaction(id)
  if (result.removed) listenerId = null
  else console.log('监听移除失败；请查看诊断')
}
function startIapExample(productId: string): void {
  if (requestBusy || !pageActive) return
  const capability = getIapCapabilitiesSync()
  if (!capability.available) { console.log(capability.reason); return }
  requestBusy = true
  initializeIap({
    timeoutMs: 30000,
    success: () => {
      if (!pageActive) { requestBusy = false; return }
      if (listenerId == null) {
        const result = onIapTransaction((event) => { console.log('交易事件：' + event.kind) })
        if (result.registered) listenerId = result.subscriptionId
        else console.log('未注册监听；请查看诊断')
      }
      getIapProducts({
        productIds: [productId], timeoutMs: 30000,
        success: (result) => { console.log('商品=' + result.products.length + '；缺失=' + result.missingProductIds.length) },
        fail: (error) => { console.log('查询失败：' + error.errCode + ' ' + error.errMsg) },
        complete: (result) => { requestBusy = false; console.log('查询完成：' + result.outcome) }
      })
    },
    fail: (error) => { console.log('初始化失败：' + error.errCode + ' ' + error.errMsg) },
    complete: (result) => { if (result.outcome != 'succeeded') requestBusy = false }
  })
}
function releaseIapService(): void {
  if (requestBusy) return
  removeExampleListener()
  requestBusy = true
  disposeIap({
    timeoutMs: 30000,
    success: (result) => { console.log('释放结果：' + result.disposed) },
    fail: (error) => { console.log('释放失败：' + error.errCode + '；不代表购买已取消') },
    complete: () => { requestBusy = false }
  })
}
onUnload(() => { pageActive = false; removeExampleListener() })

uni-app：Vue2 / Vue3 共用的 JavaScript 页面流程

以下对象可作为 .vue 页面的脚本导出；在页面按钮中调用 startExample。productId 默认留空，必须通过输入框填写自己的真实值。包含初始化、查询、失败/完成和监听释放；购买与交付的完整可操作页面见下方真实路径。

import { getIapCapabilitiesSync, initializeIap, getIapProducts, onIapTransaction, offIapTransaction, disposeIap } from '@/uni_modules/lizhao-apple-iap'

export default {
  data() { return { productId: '', busy: false, active: true, listenerId: null, status: '尚未初始化' } },
  methods: {
    startExample() {
      if (this.busy || !this.active) return
      const capability = getIapCapabilitiesSync()
      if (!capability.available) { this.status = capability.reason; return }
      this.busy = true
      initializeIap({
        timeoutMs: 30000,
        success: () => {
          if (!this.active) { this.busy = false; return }
          if (this.listenerId == null) {
            const listener = onIapTransaction(event => { if (this.active) this.status = '交易事件：' + event.kind })
            if (listener.registered) this.listenerId = listener.subscriptionId
            else console.log('监听注册失败；请查看诊断')
          }
          getIapProducts({
            productIds: [this.productId], timeoutMs: 30000,
            success: result => { if (this.active) this.status = '商品=' + result.products.length + '；缺失=' + result.missingProductIds.length },
            fail: error => { if (this.active) this.status = error.errCode + ' ' + error.errMsg },
            complete: result => { this.busy = false; console.log('查询结束：' + result.outcome) }
          })
        },
        fail: error => { if (this.active) this.status = error.errCode + ' ' + error.errMsg },
        complete: result => { if (result.outcome !== 'succeeded') this.busy = false }
      })
    },
    removeExampleListener() {
      if (this.listenerId == null) return
      const result = offIapTransaction(this.listenerId)
      if (result.removed) this.listenerId = null
      else console.log('监听移除失败；请查看诊断')
    },
    releaseService() {
      if (this.busy) return
      this.removeExampleListener()
      this.busy = true
      disposeIap({
        timeoutMs: 30000,
        success: result => { if (this.active) this.status = '释放=' + result.disposed },
        fail: error => { if (this.active) this.status = error.errCode + ' ' + error.errMsg },
        complete: () => { this.busy = false }
      })
    }
  },
  onUnload() { this.active = false; this.removeExampleListener() }
}

完整的 Tabs 页面包含全部 19 个公开 API、购买/取消/补单/订阅操作、真实错误与完整报告：uni-app x 使用 uni_modules/lizhao-apple-iap/example/uniappx/index.uvue，uni-app 使用 uni_modules/lizhao-apple-iap/example/uniapp/index.vue。报告主源为 uni_modules/lizhao-apple-iap/example/report.uts，传统页面使用 uni_modules/lizhao-apple-iap/static/report.js。维护时由 scripts/build-apple-iap-examples.cjs 生成 Vue2/Vue3 页面，不能单改生成物。

API 用途速查

公开方法

所有方法从 @/uni_modules/lizhao-apple-iap 导入。iOS入口调用真实Swift混编实现；下表列出公开接口及条件，非iOS统一拒绝Apple支付。

14 个异步业务入口同步返回插件生成的字符串 requestId，不是 Promise，也不是 Apple 订单号。未填回调不改变终态；已提供的回调各至多一次，顺序为 success或fail → complete。购买仅在StoreKit验证通过时success；pending、取消和结果未知进入对应fail。complete 只包含 errSubject、errCode、errMsg、operation、requestId、outcome，不包含凭据。

选项与默认值

成功结果、事件与诊断合同

完整类型在 uni_modules/lizhao-apple-iap/utssdk/interface.uts。以下为真实业务返回字段；不代表已通过Apple环境或真机支付验收：

时间戳单位为 Unix 毫秒，可选原生字段不可取得时为 null。JWS 原文和 appAccountToken 仅交可信业务处理，禁止写入日志。当前诊断缓存上限300条、64000字符；单条超限会截断并标注，回收优先保留错误，所有丢弃均计数。诊断开关不触发上传。

错误码说明

所有插件错误的 errSubject 均为 lizhao-apple-iap。IapFail 同时包含 operation、requestId、outcome、stage、nativeType/nativeCode/nativeCause/nativeStack；当前没有原生异常时对应字段为 null。

全部错误码都有真实校验或原生分支。9362016还可能表示桥接结构、构建身份或容量不匹配；这些错误不能解释为Apple必然未扣款。除取消、待审批和结果未知外，错误outcome为failed。回调抛错只进入脱敏诊断，不改写本次终态。

注意事项

宿主和平台

发布配置使用两个宿主各自的 platforms.client 节点。Vue 框架兼容项表示相应语法与调用入口可接入；操作系统项另行表示 Apple 内购能力，不把框架兼容或网页示例当成支付验收。

插件市场字段遵循 uni_modules 配置规范：- 表示待确认，x 表示不支持。目录存在、跨端导入成功或拒绝合同通过，都不能当成平台支付支持证据。未实现的快应用或渲染方式按本表明确排除，不复制其他插件的支持勾选。

uni_modules/lizhao-apple-iap/utssdk/app-ios/config.json 声明StoreKit/Foundation/UIKit。Native使用Swift 5语言模式和Swift 5.9特性，需Xcode 15+；兑换码页需iOS16+，其余系统页还需唯一的前台活动窗口，多个活动窗口不猜测目标。退款submitted仅表示申请受理；dismissed仅表示系统页返回。

uni_modules/lizhao-apple-iap/utssdk/app-ios/PrivacyInfo.xcprivacy 为本地请求计时使用的 systemUptime 声明 SystemBootTime / 35F9.1；只测量本应用内经过时间，不读取或上传开机时刻。插件不默认收集上报交易或账户，宿主业务自行发送到服务器时必须维护自己的隐私声明。无额外IAP entitlement，实际签名、商品与Apple服务配置由应用维护。

生命周期、容量与恢复

同时最多32个实际原生请求；JS页面订阅最多128个、共用一个Native订阅，直接UTS原生订阅最多64个（包含JS桥占用的订阅）。商品缓存200项，进程内已完成证明缓存200笔。重复finish只在本进程确证已完成时返回alreadyFinished=true，重启后找不到返回9362014。注册失败不保留页面回调；off先停止本地派发，Native清理失败如实返回。JS宿主使用固定dispatcher和显式代际，页面引用仅保留在可释放表中。

iOS商品模型内部使用合法的description override保留公开字段，并通过白名单DTO字符串桥交给JS，避免普通class字符串化为空。调用者始终读取相同字段；自行序列化原生对象时应显式组装所需字段，禁止把交易/JWS整体写入日志。

批量最多扫描1000条，完整结果payload约1MiB；超过条数或实测JSON字节预算时保留已返回部分并给出 partial=true 和 verification=unknown 的容量问题。未返回交易不会自动finish。未完成交易可先核验/交付/完成当前批次后再次查询；权益或订阅大批量应使用服务器接口完整核对。其他结果或单笔事件超限返回9362016/capacity，不伪造空成功。无监听时最多缓存50条/256KiB事件，丢弃计数可查；缓存不是订单账本，仍应主动查询unfinished并与服务端核对。

Native超时只结束一次等待，原生交互锁保留到系统操作实际返回；迟到已验证购买会进入补单事件。UTS另有比原生期限晚约1秒的桥接兜底，不保证系统实时调度。dispose有任何实际请求未返回时拒绝9362019；成功释放观察/回调/缓存，不修改Apple未完成交易。商品实际支付价格以Apple确认页为准，业务展示前应重新查询商品。

诊断、隐私和报告

示例底部“一键复制日志”复制环境、插件快照和保留的完整操作轨迹，独立于页面可见行。分段复制基于同一固定报告编号和正文，只在实际复制成功后推进；失败显示真实错误并允许手动复制。生成新报告时会建立新快照，不能混用不同报告的分段。

版本来源分开：插件版本来自生成并检查的package字段；示例构建标记来自源码；运行环境来自实际宿主API；无法取得的编译器、构建HX、自定义基座身份明确记为unknown。不得用开发者当前电脑版本冒充应用安装包构建版本。日志会隐藏JWS、账户UUID、完整交易身份、授权头和敏感路径/地址，不自动上传日志，不为诊断申请无关权限。

验证与基座边界

同源UTS桌面回归、静态语法、宿主资源编译、Swift生成物、Apple SwiftCompile、匹配基座运行、真实支付是不同层次。Windows上的资源导出不能证明Apple原生编译或真实购买。需匹配源码的iOS联编/自定义基座，appResource或WGT不能替换旧基座原生代码。

当前未验收Apple签名/真机/沙箱购买、退款、恢复、订阅、离线重试和实际系统剪贴板。需准备真实开发者配置、商品和沙箱/TestFlight环境；账户、证书、密钥不要放入插件源码。恢复不自动触发，finish前必须验签并幂等交付，取消或超时不自动重购。

作者系列 UTS 插件

下表由作者统一维护并核实的已发布清单生成；本插件尚无已核实的市场详情页，因此未列为已上架产品。