RevenueCat support can explain error messages or help you troubleshoot reproducible issues but don't have other ways of expediting the review process.
Your app is finally complete! 🎉 You're tracking subscriptions in Sandbox, your Testflight users love it, you've followed our Launch Checklist, and you're finally ready to launch your app to the world.
After a few days in review, you get the dreaded 'Rejected' message. Now what? Let's work through some common rejection reasons and the best way to get your app back on track.
According to Apple's App Review Center, over 40% of app rejections are for Guideline 2.1 – Performance: App Completeness - this means that something didn't work in your app during review. We can't help with those rejections, obviously.
If you're here, we'll assume that your app was rejected for some problem with purchases. There are three places in the purchase flow that cause the majority of App Store rejections we hear about:
- Issues fetching products
- Error during purchase
- Content not unlocked after purchase
Usually the reviewer will include a screenshot with the problem they encountered. This can be helpful for you to track down where to look for the problem in your app. Always try to reproduce the issue first in a local build or Testflight. RevenueCat will behave the same way in your environment and the reviewers, so if there's any problem with your integration it should be able to be reproduced.
Often times, purchases will work fine in Sandbox and Testflight, but App Store Review will not be able to fetch products. It's important to ensure that you are submitting your in-app purchases with your app for review. If an app has not previously had in-app purchases approved on the App Store, an option to submit them will appear on the main app version page.
To see this option, you must first fill in all required metadata so that the status of any in-app purchases you intend to use is 'Ready to Submit'.
If you've already released a version of your app containing in-app purchases, you can create new products in App Store Connect without having to release an update to your app. You'll have to submit new products for review independently of a new app version, and they must be in the 'Approved' state before they'll be available for purchase.
If you're having trouble fetching products in Testflight or a local build, see our community article on the most common reasons this occurs.
If an error occurs during the purchase process, it will be one of the errors outlined in our Error Handling guide here. Understanding what error triggered the rejection is the only way to make sure the issue gets resolved.
If the reviewer provides a screenshot of an error popup - use that to help track down the issue. RevenueCat itself will never display a user-facing popup or error message, so look through your app to find the code that triggered the alert and work backwards to determine the error message.
This is the most common error from RevenueCat that can lead to unexplained App Store rejections. Unfortunately, this error occurs when Apple's sandbox environment is down and unable to verify purchases. The best course of action here is usually to re-submit your binary or try to explain the situation to the reviewer.
Your app could also get rejected even if there are no issues during the purchase process, but the content does not get unlocked after purchasing. You should be able to reproduce this issue in a test environment.
Sometimes, the reviewer will provide you with "Next Steps" to resolve the rejection. These are usually not the most helpful in pinpointing any issues with purchases. One of the more common reasons is shown below:
When validating receipts on your server, your server needs to be able to handle a production-signed app getting its receipts from Apple’s test environment. The recommended approach is for your production server to always validate receipts against the production App Store first. If validation fails with the error code "Sandbox receipt used in production," you should validate against the test environment instead.
If you're using RevenueCat, sandbox and production purchases are automatically handled so even if the reviewer provides you with this reason, it's simply incorrect.
When an app is launched for the first time or when new products are created for an existing app it can take 24 hours for purchases to work on the App Store and the app/update might show up hours before the products can be purchased. This is simply due to App Store propagation times – App Store data must be replicated to hundreds of servers around the world and this is apparently a slow, error-prone process for the App Store.
Once your app/update is 'Ready for Sale' your products should be available for purchase soon, but be prepared for it to take up to 24 hours. We recommend releasing the app at least 24 hours before mentioning the app publicly or kicking off any marketing efforts.
Just to be sure there's nothing wrong in the production environment, you can also follow this guide to testing in the production environment prior to releasing an app.
Updated 6 months ago
For additional reading, check out our blog post on getting through app review.