Troubleshoot App Store integration

This article covers common App Store integration issues. Each section below lists the symptoms, root cause, and resolution.

Products don’t appear

Two surface symptoms point to the same root cause:

  • The App Store Connect API key is set up correctly, but Adapty can’t fetch products at all.
  • Products exist in App Store Connect but don’t appear in Adapty, or fewer appear than expected. The SDK reports “Product Id not found” on attempted purchase.

The most common root cause is unsigned Apple agreements — the paid agreement, tax forms, or banking forms in pending or unsigned state. When agreements are pending, the App Store Connect API silently returns 403 on product-related endpoints. No clear error surfaces to Adapty; products are silently filtered out.

Go to App Store Connect → Agreements, Tax, and Banking and sign every pending agreement. Then re-sync in Adapty’s App settings → iOS SDK.

App Store Server Notifications show “Delayed”

In App Store Connect, the App Store Server Notifications status may show as Delayed. This means Apple is delayed in sending subscription event notifications — renewals, cancellations, and billing issues are queued and arrive late.

Install statistics are not affected. Adapty counts installs from the first app launch, not from server-side notifications.

If renewal or cancellation data lags behind, the Delayed status is the most likely cause. The status usually clears automatically as Apple processes the backlog.

Prices in Adapty don’t match App Store

The price field on Adapty’s product edit page behaves differently depending on how the product was added.

If you create a product in Adapty and push it to the store from the dashboard, this price is used as the initial store price.

If you add a product that already exists in the store, this price is a placeholder. Adapty’s analytics, integrations, and SDK use the real prices fetched from the App Store regardless. Changes to App Store prices don’t sync back to update the placeholder, and you can’t currently edit the placeholder from the dashboard.

CSV price export is empty

If your CSV price export returned only column headers, your App Store Connect API key isn’t fully configured. See Step 6 — Add App Store Connect API key.

Can’t push new products to App Store

Adapty can push new products to App Store Connect when you create them in the dashboard. The push option is blocked if your App Store integration isn’t fully configured. Two settings are required: