iOS Offer Code集成后有效兑换码提示已过期问题排查

注意：苹果的优惠码兑换接口对错误提示做了高度模糊处理，绝大多数校验不通过的场景——包括绑定对象不匹配、地区不匹配、测试环境错误、同步延迟等，不会返回具体的失败原因，只会统一弹出“该优惠码已过期”的提示，不要被提示误导，仅围绕码本身的有效期设置排查。

绑定维度匹配排查 #

• 核对优惠码的关联绑定对象：在App Store Connect创建优惠码时，必须选择对应App的具体版本、或是对应具体的内购/订阅产品。如果创建时误选了同账号下其他App的内容、绑定了已经下架/被驳回的历史版本、或是关联了失效的内购项目，哪怕码本身设置了极长的有效期，兑换时也会直接触发过期类报错。
• 核对优惠码的适用地区设置：如果创建码时仅勾选了部分国家或地区，测试时登录的Apple ID归属地、手机系统设置的地区不在适用范围内，兑换校验会直接被拦截，返回过期提示。

测试环境配置排查 #

• 区分正式优惠码与沙盒测试码的适用场景：你从App Store Connect批量下载的500个上限的官方Offer Code，属于面向正式用户的一次性兑换码，仅能在关联正式iCloud账号的环境下使用。如果测试时手机内登录了沙盒测试账号、或是应用的Store关联到了沙盒环境，哪怕输入的是完全有效的正式优惠码，也会被判为无效并弹出过期提示。测试前需要先退出所有已登录的沙盒账号，用符合码适用地区的普通正式Apple ID登录系统后，再唤起presentCodeRedemptionSheet()操作。
• 检查系统Storefront的匹配状态：如果手机系统设置的地区与优惠码的适用地区不一致，系统在拉取兑换校验数据时会匹配错误区域的码库，直接返回校验失败的过期提示。

状态与同步问题排查 #

• 核对绑定的内购/项目状态：如果优惠码绑定的是自动续期订阅、非消耗型内购，对应项目当前在App Store Connect的状态存在元数据缺失、审核驳回、待开发者操作等异常，哪怕项目之前已经过审，优惠码的兑换链路也会直接拦截请求，触发过期报错。
• 核对测试包的Bundle ID：确保测试安装的应用Bundle ID和创建优惠码时绑定的正式App的Bundle ID完全一致。如果是临时修改Bundle ID的测试包，哪怕能正常唤起兑换页，也会因为身份不匹配被校验拦截。
• 排查批量码的同步延迟：批量生成500个优惠码时，苹果的兑换节点不会在码生成完成后立刻做全量同步，通常需要等待1-2小时才能覆盖所有区域的兑换服务节点。如果刚下载完码就立刻测试，部分节点还未同步到新生成的码段，会批量返回过期错误。

内容的提问来源于stack exchange，提问作者blackstar26