将应用内购买密钥添加至 Adapty

Adapty 使用应用内购买密钥来验证应用内的购买,并为促销活动签名。在 App Store Connect 中生成密钥,然后在 Adapty 的 App settings 的两个部分中输入该密钥。如果密钥失效或需要更换,请替换密钥。

App 内购买密钥与 App Store Connect API 密钥不同,尽管 App Store Connect 对这两种密钥的 ID 均标注为 Issuer ID 和 Key ID。

如需在 App settings > iOS SDK 中一次性填写所有凭据,请参阅配置 App Store 集成。

在 App Store Connect 中生成密钥

  1. 在 App Store Connect 中,前往 Users and Access > Integrations > In-App Purchase。

    同一个密钥可供你的 App Store Connect 团队下所有应用使用。如需复用此页面中已有的活跃密钥,你需要有对应的文件。如果你已有该文件,可跳过第 2-4 步。生成新密钥后,原有的活跃密钥仍然有效。

  2. 生成密钥需要在 App Store Connect 中拥有 Account Holder 或 Admin 角色。如果你没有这两个角色,请联系拥有相应角色的人员来生成密钥,并让其将文件连同 Issuer ID 和 Key ID 一并发给你。

    如果页面上已列出活跃密钥,点击 +;否则,点击 Generate In-App Purchase Key。

    In-App Purchase keys page in App Store Connect, with the button that adds a key
  3. 输入密钥名称,然后点击 Generate。密钥将出现在 Active 列表中。

    Generate In-App Purchase Key dialog with a name for the key and the Generate button
  4. 每个密钥只能下载一次。在新密钥旁边,点击 Download In-App Purchase Key。

    Active list of In-App Purchase keys, with the download link next to a new key

    然后在弹出的对话框中点击 Download。请妥善保管该文件:你需要将它上传到每个使用此密钥的 Adapty 应用中。

    Download dialog for an In-App Purchase key

Apple 在 创建 API 密钥以授权 API 请求 中描述了这些步骤。

将密钥添加到 Adapty

  1. 要查找密钥的 Issuer ID 和 Key ID,请在 App Store Connect 中前往 Users and Access > Integrations > In-App Purchase。如果是其他人生成了密钥并将 Issuer ID、Key ID 和文件发送给您,请跳过此步骤。

    Issuer ID and the Key ID of an In-App Purchase key in App Store Connect
  2. 在 Adapty 中,前往 App settings > iOS SDK。在 In-app purchase API (StoreKit 2) 部分,填写以下字段:

    • Issuer ID:从 App Store Connect 的 In-App Purchase 页面复制。
    • Key ID:从 In-App Purchase 页面的 Active 列表中复制,位于您下载的密钥旁边。
    • Private key (.p8 file):上传您下载的文件。
    Issuer ID, Key ID, and Private key (.p8 file) fields in the In-app purchase API (StoreKit 2) section in Adapty
  3. Adapty 使用 In-App Purchase 密钥为促销活动签名。在 App Store promotional offers 部分,再次输入密钥:

    • Subscription key ID:步骤 2 中的 Key ID。
    • Subscription key (.p8 file):步骤 2 中的文件。
    Subscription key ID and Subscription key (.p8 file) fields in the App Store promotional offers section

    若使用了不同的密钥,保存时不会报错,但用户将无法收到促销活动。

  4. 点击 Save。Adapty 在保存页面之前,会通过 Apple 验证 In-app purchase API (StoreKit 2) 部分中的密钥。如果 Apple 拒绝该密钥,页面将显示”The provided field values are incorrect”:请检查相关值。

替换密钥

如果密钥失效或需要更换,请在吊销旧密钥之前先将新密钥保存到 Adapty。

密钥失效时会出现以下情况:

  • 应用内购买无法解锁任何访问等级,且应用不会收到任何报错。
  • 用户无法兑换促销活动。
  • Refund Saver 无法响应消耗请求。
  • Adapty 不会显示任何警告,App Store server notifications 部分中的状态仍显示为 Active。

当您的应用迁移至另一个 Apple 开发者账号时,请将密钥替换为新所有者团队的密钥。

To replace the key:

  1. 在 Adapty 中,进入 App settings > iOS SDK。要确认 Adapty 当前使用的密钥,在 In-app purchase API (StoreKit 2) 部分,记录 Key ID 字段中的值。
  2. 生成一个新密钥。
  3. 在 In-app purchase API (StoreKit 2) 和 App Store promotional offers 部分,将新密钥添加到 Adapty,然后点击 Save。
  4. 一个密钥可供你 App Store Connect 团队的所有应用使用。如果其他 Adapty 应用也使用了第 1 步中的 Key ID,请将新密钥一并添加到这些应用中。同时,将你服务器上使用旧密钥的地方也替换为新密钥。
  5. 已吊销的密钥将在所有使用它的应用中立即失效,且无法恢复。请在 App Store Connect 中吊销旧密钥:即第 1 步中 Key ID 对应的有效密钥。

当 Adapty 没有可用密钥时完成购买的用户,可以通过恢复购买找回访问权限。