Skip to main content
These App Store Connect values identify your app and support different parts of your Qonversion connection:
  • Bundle ID — the reverse-DNS identifier of the app (e.g. com.example.app).
  • App Store ID — the numeric ID Apple assigns to an app (e.g. 1234567890). Qonversion uses it for product sync.
  • App-Specific Shared Secret — a 32-character secret used when validating subscription receipts. It serves receipt validation; API keys serve different Apple APIs.
Add the shared secret so Qonversion can validate your app’s App Store receipts. All three live on the App Information screen of a single app in App Store Connect, so you can grab them in one trip.

​
1. Copy the Bundle ID and App Store ID

  1. Log in to App Store Connect.
  2. Open My Apps, click your app, and choose App Information in the left sidebar.
  3. Under General Information, copy:
    • Bundle ID (looks like com.example.app) — paste into Qonversion’s Bundle ID field.
    • Apple ID (numeric, e.g. 1234567890) — this is what Qonversion calls the App Store ID.
You can also read the App Store ID from the URL bar while the app is open: https://appstoreconnect.apple.com/apps/<APP_STORE_ID>/...

​
2. Generate the App-Specific Shared Secret

Still on App Information, scroll down to the App-Specific Shared Secret card and click Manage. In the dialog that opens, click Generate if you don’t have one yet, then copy the 32-character secret.
An app-specific shared secret is per-app and stays the same once generated. Regenerating it invalidates the previous value immediately. If you need to regenerate it, coordinate with Qonversion support first, save the new value in Qonversion right away, and ask support to confirm receipt validation with the new value.

​
3. Paste everything into Qonversion

  1. Open Qonversion Dash → Project Settings → Stores → Apple App Store.
  2. Under Credentials on file, open App-specific shared secret (Set up or Edit) and enter the secret and Bundle ID. Click Save.
  3. For catalog sync, enter the App Store ID using Add App Store ID on the Product sync row when that action appears. Product sync also needs an App Store Connect API key.

​
Troubleshooting

​
”App Store ID is invalid”

The App Store ID is purely numeric — usually 9 to 10 digits. If you accidentally copied something with letters or punctuation (the bundle id, for example), Qonversion will reject it. Double-check the Apple ID field on App Information, not the Bundle ID.

​
”App-Specific Shared Secret is invalid”

The shared secret is exactly 32 hexadecimal characters. Check that you copied the value for the app you are configuring and removed any spaces added during copying.

​
Bundle ID doesn’t match the one in your Xcode project

Apple ties the bundle id to the app record on App Store Connect; you can’t change it after submission. Make sure the value you paste here matches the Bundle Identifier in your Xcode target’s signing settings — they have to be identical for receipt validation to succeed.

​
What’s next?

To finish setting up the App Store connection: