测试 App 内购买项目

Apple 提供了一种名为“沙盒”的测试环境,以便你使用测试账户来测试 App 内购买项目,并且不会产生实际所需的购买费用。这是因为沙盒使用 App Store 基础架构但不处理实际付款。在此环境下,系统将返回交易并视为已成功完成付款处理。

测试 App 内购买项目之前无需先通过“App 审核”了解如何使用 Xcode 和沙盒来测试 App 内购买项目。

你可以在 App Store Connect 中添加沙盒测试员,并管理其账户设置。其中包括:

App Store 国家或地区

你可以将测试员账户关联到任一 App Store 国家或地区(共 175 个)。因此,同一个沙盒 Apple ID 可以在不同国家或地区的店面中进行测试,无需创建新的测试员账户。

账户所属国家或地区变更后,测试员需要使用其沙盒 Apple ID 重新登录设备。

订阅项目续期速率

通过沙盒测试,你可以在较短的时间内测试订阅项目续期、状态变更和中断购买等订阅事件,而无需等待订阅所需的实际时长。在添加沙盒测试员后,你可以为每位测试员选择订阅项目的续期速率,即测试时每次续期间隔的时长。测试员的续期速率默认为 1 个月 = 5 分钟。你也可以按需修改续期速率,以延长或缩短测试时的续期间隔,具体请参见下表。订阅项目最多会续期 12 次。超过 12 次后,订阅将自动取消续期。

沙盒测试中可供选择的订阅续期速率:

订阅时限

每 3 分钟续期一次

每 5 分钟续期一次(默认)

每 15 分钟续期一次

每 30 分钟续期一次

每小时续期一次

1 周

3 分钟

3 分钟

5 分钟

10 分钟

15 分钟

1 个月

3 分钟

5 分钟

15 分钟

30 分钟

1 小时

2 个月

6 分钟

10 分钟

30 分钟

1 小时

2 小时

3 个月

9 分钟

15 分钟

45 分钟

1 小时 30 分钟

3 小时

6 个月

18 分钟

30 分钟

1 小时 30 分钟

3 小时

6 小时

1 年

36 分钟

1 小时

3 小时

6 小时

12 小时

中断购买

你可以在运行 iOS 14 或更高版本的设备上测试购买中断的情况,只需在 App Store Connect 中为沙盒 Apple ID 启用购买中断即可。启用后,此沙盒 Apple ID 在沙盒环境中从设备上进行的购买尝试将被中断;除非你停用此功能或测试员在 iOS 设备上同意条款与条件,否则购买将一直被中断。此功能可以测试 App 对中断情况的响应,进而确保顾客有顺畅的购买体验。

通常,当顾客需要解决有关 Apple ID 的问题时,购买中断的情况便会出现。例如,顾客需要同意最新的条款和条件,或者需要更新其付款方式。

进一步了解如何测试购买中断的情况测试 App 内购买项目

了解如何在 iOS 中对测试员账户进行额外设置,从而测试处于“计费重试”状态的自动续期或其他情况。

计费重试

下表中列出了在沙盒测试中,不同的订阅续期速率所对应的计费重试和帐单宽限期时长。如果你开启了帐单宽限期,当订阅进入计费重试状态时,也同时进入帐单宽限期。如果订阅在帐单宽限期内恢复或被取消,帐单宽限期会立即结束;否则需等到计费重试到期时结束。

在沙盒测试中,系统会在计费重试期间尝试恢复订阅至少 6 次。

每 3 分钟续期一次

计费重试

帐单宽限期

每周订阅

6 分钟

3 分钟

月度和年度订阅

6 分钟

3 分钟

每 5 分钟续期一次(默认)

计费重试

帐单宽限期

每周订阅

10 分钟

3 分钟

月度和年度订阅

10 分钟

5 分钟

每 15 分钟续期一次

计费重试

帐单宽限期

每周订阅

30 分钟

5 分钟

月度和年度订阅

30 分钟

15 分钟

每 30 分钟续期一次

计费重试

帐单宽限期

每周订阅

1 小时

10 分钟

月度和年度订阅

1 小时

30 分钟

每小时续期一次

计费重试

帐单宽限期

每周订阅

15 分钟

2 小时

月度和年度订阅

1 小时

1 小时

了解如何利用沙盒来测试 App 内购买项目。

必要职能:“账户持有人”职能、“管理”职能、“App 管理”职能或“开发者”职能。请参见职能权限

更改测试员账户设置

如需修改沙盒测试员的账户设置:

  1. 在“用户和访问”中,点按“沙盒测试员”标签页,以查看所有的沙盒 Apple ID。

  2. 点按需要修改的沙盒 Apple ID。

  3. 在出现的对话框中修改设置。

  4. 点按“存储”。

    沙盒测试员设置截屏

清除购买历史记录

你可以清除测试员的购买历史记录,以便继续使用同一个沙盒 Apple ID 进行其他测试。清除购买历史记录后,该测试员在沙盒环境中购买的所有自动续期订阅和非消耗型项目均会被删除。此操作不会影响顾客账户。

如需清除测试员的购买历史记录:

  1. 在“用户和访问”中,点按“沙盒测试员”标签页。

  2. 点按“编辑”。

    沙盒测试员设置截屏:标出了右上角的“编辑”按钮
  3. 选择需要修改的测试员,然后点按“清除购买历史记录”。

    沙盒测试员设置截屏:标出了右上角的“编辑”按钮
  4. 在出现的对话框中,点按“清除购买历史记录”。

    如果沙盒 Apple ID 的购买次数较多,则清除其购买历史记录可能需要更长时间。此操作无法撤销。