Why am I getting an "Invalid Token" or "Bad Device Token" error for iOS push notifications?

This error typically indicates a mismatch between the Apple Push Notification service (APNS) environment configured in your Pushwoosh application settings and the environment used by your iOS app build.

Apple uses two distinct environments for push notifications:

• Sandbox (Development): Generally used for builds installed directly from Xcode onto a device during development.
• Production: Used for builds distributed via TestFlight or released on the App Store.

You must ensure the gateway setting in your Pushwoosh iOS configuration matches the environment of the build you are sending pushes to:

1. Log in to your Pushwoosh Control Panel.
2. Navigate to your application, then go to the iOS platform configuration section.
3. Check the Gateway setting.
4. If you are sending notifications to a build installed directly from Xcode (using a development provisioning profile), set the Gateway to Sandbox.
5. If you are sending notifications to a build installed via TestFlight or an App Store release (using an Ad Hoc, Enterprise, or App Store provisioning profile), set the Gateway to Production.

Important: The provisioning profile used to sign your app determines which APNS environment it connects to. Ensure your Pushwoosh gateway setting aligns with the profile type.

Recommendation for Testing: To avoid frequently switching your main application's gateway between Production and Sandbox, consider creating a separate Pushwoosh application specifically for development and testing. Configure this separate application with the Sandbox gateway and use it with your development builds. Keep your main application configured for the Production gateway for TestFlight and release builds.