Guidelines & Best Practice

There are several caveats your application must observe to pass Apple’s App Store Review under the new “external purchase link” policy. Be sure every checklist item below is satisfied before you submit:

1. External Browser Redirection Only

• Apple requires the purchase flow to leave the app entirely.
• Do NOT embed, iframe, or present the checkout page in a WKWebView / SFSafariViewController.

2. US Region Only

• As of Apple’s latest policy update (May 2025), external payment links are allowed only when the device region is set to the United States. Developers are required to implement a runtime feature flag by checking the user region. If user region is not US, fallback to StoreKit-based IAP. Apple reviewers test with a U.S. Apple ID, so ensure the redirection path is always reachable for that locale.
• You can follow this code snippet to check for user region

func purchaseBreeze(_ product: Product, onSuccess: (() -> Void)? = nil) async throws {
  // wrap Storekit Product to Breeze Product
  let breezeProduct = try await Breeze.shared.fromSkProduct(product: product)

  if(Breeze.shared.configuration.appCountryCode == 'USA'){
    //1) breeze purchase
    try await breezeProduct.purchase(using: Breeze.shared, onSuccess: onSuccess: {  verifiedTransaction in
      // YOUR logic to handle successful verified transaction
      onSuccess?()
      await Breeze.shared.finish(verifiedTransaction)
  	})
  } else {
    //2) original IAP purchase
    let result = try await product.purchase()

    switch result {
      case .success(let verification):
        let transaction = try checkVerified(verification)

        // YOUR logic to handle successful transaction	
        onSuccess?.()

        await transaction.finish()
        return transaction
      default:
        return nil
    }
  } 
}

3. Additional Reviewer Checks (highly recommended)

• Parental Controls: If your app is in a kids’ category, external payments are currently prohibited.
• Logging: Keep server-side logs of redirect and completion events; reviewers sometimes ask for evidence of a successful end-to-end flow.

Following these expanded guidelines should smooth the review process and make it clear to Apple that your SDK-integrated flow complies with every nuance of the external purchase policy.