Skip to main content
Apple sends a notification to a URL of your choice every time a subscription event happens on your app — renewals, refunds, billing retries, status changes. Qonversion exposes one URL per project; pasting it into App Store Connect is a one-time setup.
We recommend server-to-server notifications for apps in production. Without them, subscription updates reach Qonversion later, so entitlements, analytics, integrations and webhooks can lag behind the store.

​
1. Copy the URL from Qonversion

Open Project Settings → Stores → Apple App Store in Qonversion. Find the Server-to-server notifications section and copy the Notification URL. The URL looks like https://api.qonversion.io/v1/apple-s2s/<your-project-key>.

​
2. Paste into App Store Connect

  1. Log in to App Store Connect.
  2. Open My Apps, click your app, then choose App Information in the left sidebar.
  3. Scroll to the App Store Server Notifications section.
  4. Paste the URL into the Production Server URL field.
  5. Choose Version 2 for the Server Notifications version (Version 1 is legacy).
  6. Click Save at the top of the page.
If you also test in the App Store sandbox, paste the same URL into the Sandbox Server URL field — Qonversion accepts both production and sandbox notifications on the same endpoint.

​
Troubleshooting

​
Apple shows “Could not verify your URL”

App Store Connect probes the URL when you save. The probe expects an HTTP 200 response within a few seconds. If you see this error:
  • Make sure you copied the full URL including https:// and the project key.
  • Make sure you’re not behind a corporate proxy that’s rewriting outbound requests.
  • Try saving again after a minute — Apple’s probe occasionally times out on transient network blips.

​
Notifications aren’t appearing in Qonversion analytics

  • Check that you saved with Version 2 selected. Qonversion supports both, but Version 2 carries a richer payload.
  • Verify the URL points to the same project you’re configuring in Qonversion — projects don’t share keys.
  • Wait 10-15 minutes after the first eligible event (renewal, refund, etc.) — Apple batches some notification types.

​
What’s next?

After this step, your iOS configuration is complete. Test the integration end-to-end:
  • Make a sandbox purchase and confirm it appears in Qonversion within seconds (not minutes).
  • Trigger a refund in App Store Connect and confirm the refund event arrives.