Subscriptions only, or any purchase?
Not only subscriptions. It depends on the channel.
| Channel | What arrives |
|---|---|
| Webhook (App Store Server Notifications V2) | Subscriptions (SUBSCRIBED, DID_RENEW, …) and one-time purchases (ONE_TIME_CHARGE, Consumable / Non-Consumable). |
| Sync Reports → SUBSCRIBER | Subscriptions only. |
| Sync Reports → SUBSCRIPTION_EVENT | Subscription events only (counts, no prices). |
The dashboard is named “subscription”, but the webhook accepts more than subscriptions. Apple daily reports are mostly subscription-focused.
Subscription vs one-time purchase
The Type column shows a product-type badge
(Subscription or
One-time) plus an event badge
(Initial, Renewal, Charge for ONE_TIME_CHARGE, …).
Filter with Product type on the dashboard.
| Field | Subscription | One-time |
|---|---|---|
notificationType |
SUBSCRIBED (often INITIAL_BUY), DID_RENEW, … | ONE_TIME_CHARGE |
transaction.type |
Auto-Renewable Subscription, Non-Renewing Subscription | Consumable, Non-Consumable |
expiresDate |
Present (end of paid period) | Usually missing |
Product-type badge (Type column) |
Subscription (blue) | One-time (amber); event badge Charge for ONE_TIME_CHARGE |
In plain language
The Subscriptions table can show the same purchase from several places: Apple’s live notifications, a backup API poll, and two daily reports. Turn sources on or off to focus on “right now” vs “official numbers from Apple.”
- Webhook — Apple pushes each subscription event to your server in real time. Best for “what happened right now” and customer price.
- Notification history — Backup poll of Apple’s Notification History API (Sync Notifications). Same data as webhook if something was missed.
- Subscriber report — Daily ASC sales file (Sync Reports → SUBSCRIBER). Official customer price and Proceeds — matches App Store Connect.
- Subscription events report — Daily ASC file (Sync Reports → SUBSCRIPTION_EVENT). Event counts and types only — no prices.
Price columns on the table
- Customer
- What the user paid in their App Store currency (e.g. 3.99 CAD). Shown on live events and Subscriber Report rows.
- Customer (USD)
- Rough conversion of Customer to US dollars using daily FX rates. Useful to compare countries; not Apple’s official payout.
- Proceeds
- What Apple pays you as the developer (after Apple’s commission and taxes). Comes only from the Subscriber Report, usually 1–2 days after the event.
- Group operations
- Merges webhook, history, and report rows for the same renewal/purchase into one line when IDs and time match.
Detailed comparison
| Source | What it is | When it appears | Customer price | Proceeds | Typical delay | How to sync |
|---|---|---|---|---|---|---|
webhookWebhook |
App Store Server Notifications V2 — instant push per event | Seconds after purchase, renewal, cancel, refund, etc. | Yes | No | Real time | Automatic (configure URL in ASC) |
notification_historyNotification history |
Same notifications, fetched via API | After Sync Notifications or cron (~15 min) | Yes | No | Minutes | Sync Notifications |
subscriber_reportSubscriber report |
ASC SUBSCRIBER daily sales report | After Sync Reports for that calendar day | Yes | Yes (Proceeds column) | ~1–2 days | Sync Reports |
subscription_event_reportSubscription events report |
ASC SUBSCRIPTION_EVENT daily report | After Sync Reports for that calendar day | No | No | ~1–2 days | Sync Reports |
Related: Funnel by app
The Funnel by app page (/overview) uses ASC Analytics for discovery and download-type breakdown, and counts initial purchases — it is not the same as this event table.