App Store Server Notifications

Overview

Encore uses Apple’s App Store Server Notifications (webhooks) to track subscription lifecycle events: trial starts, renewals, expirations, and refunds. These events power the Analytics section of your dashboard and the lift measurement behind the Reduce Churn use case.

Without this step, Encore cannot track subscription outcomes. Analytics will show no data.

Choose your integration method

Set URL in App Store Connect (Recommended)
Forward from Your Server

Point App Store Connect directly at Encore’s webhook endpoint. This is the most reliable integration: Encore receives notifications directly from Apple with no intermediary.

Open App Store Connect

Go to appstoreconnect.apple.com and navigate to Your App → General → App Information.

Find App Store Server Notifications

Scroll down to the App Store Server Notifications section.

Set Production Server URL

Enter the following URL as the Production Server URL:

https://api.encorekit.com/encore/webhooks/apple

Set Sandbox Server URL

Enter the same URL as the Sandbox Server URL:

https://api.encorekit.com/encore/webhooks/apple

Setting both Production and Sandbox URLs ensures Encore tracks subscription events during development testing as well as in production.

Save

Click Save at the top of the page.

Confirm the webhook is wired

Back in the Encore Dashboard, open your app’s Analytics (or Integration Progress → Configure Analytics) view. Once Apple delivers the first notification, the App Store Server Notifications status flips to Connected and a “last received” timestamp appears.To force an event immediately, complete a sandbox purchase (or trigger a renewal or refund) for a test user; the notification typically lands within a minute or two. If nothing appears after a few minutes, re-check the Production and Sandbox URLs in App Store Connect.

If you already have an App Store Server Notifications URL configured and don’t want to change it, forward each notification to Encore from your existing webhook handler. Your current flow is preserved; you just add a single forwarding call.

app.post('/webhooks/apple', async (req, res) => {
  // Forward the raw signed payload to Encore
  await fetch('https://api.encorekit.com/encore/webhooks/apple', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(req.body),
  });

  // Continue with your existing logic...
  res.sendStatus(200);
});

How Encore attributes the notification to your app: Apple’s notification is a signed JWS that Encore verifies against the Apple Root CA - G3 certificate chain, then reads the bundle ID embedded in the verified payload. That bundle ID is matched to your registered app, so no shared secret or per-app token is needed. Just forward the raw request body unmodified (re-serializing or re-signing it will break verification).If you operate multiple apps under one forwarding handler, you can optionally disambiguate by appending your Encore app ID as a query param: …/encore/webhooks/apple?app=<your-app-id>.

Using a third-party subscription manager? Its webhook carries your subscription events instead: see Superwall, RevenueCat, or Adapty.

Need help?

If you have questions about configuring App Store Server Notifications or the forwarding setup, contact us at admin@joinyaw.com.

iOS

Android

Web

Bridges

App Store Server Notifications

Overview

Choose your integration method

Need help?

​Overview

​Choose your integration method

​Need help?

Overview

Choose your integration method

Need help?