Promotional and introductory offers follow store guidelines

Apple Promotional Offers are only valid for users who have previously subscribed to the product — presenting them to first-time users generates an invalid purchase attempt that fails at the platform level. An offer identifier string that does not match exactly what is configured in App Store Connect causes the same failure. Both scenarios result in a purchase error that the user experiences as a broken "Subscribe" button. Apple's promotional offer system requires server-side signature generation to prevent unauthorized use, so a mismatch between the code's offer identifier and App Store Connect configuration breaks the entire offer flow silently.

Verify that every promotional offer identifier string in your codebase matches exactly the identifier configured in App Store Connect under Subscriptions → [Your Subscription] → Subscription Prices → Promotional Offers. Check eligibility before showing a promotional offer to a user.

// StoreKit 2 — check eligibility before showing the offer
if let promoOffer = await subscription.promotionalOffer(offerID: "win_back_50") {
  // User is eligible (has a prior subscription history)
  try await product.purchase(options: [.promotionalOffer(promoOffer)])
}
// If subscription.promotionalOffer returns nil, the user is not eligible

For RevenueCat promotional offers, use Purchases.purchasePackage(package, promotionalOffer: offer) and confirm the offer's identifier property matches App Store Connect before shipping. Audit all offer identifier strings in src/lib/iap/offers.ts or equivalent against your current App Store Connect configuration.