In-App Purchase Webhooks: Subscription Events for Your App
In-app purchase webhooks let your app react as soon as a subscriber's status changes, rather than waiting for the next poll or app open.
You can monitor subscriber state changes, send timely messages, and connect those moments to the rest of your stack.
What webhooks let you do
Webhooks are most useful when each event maps to a clear product action. A practical setup is: listen for purchase and upgrade events to start onboarding, listen for billing problems to warn the user before access is lost, and listen for cancellation and expiration to start a win-back flow. That turns a stream of store events into three repeatable jobs: welcome, protect, and recover.
Three playbooks to build first
Win back users: when churn is detected, trigger an offer or discount instead of letting the relationship end silently. Alert users of billing issues: send an automated message when a charge fails so the user can fix payment and keep access, protecting both experience and revenue. Educate and onboard: when someone newly subscribes or upgrades, send messaging that highlights the benefits they have just unlocked.
Events you can connect
Test — a test event issued through the dashboard. TEST Initial Purchase — a new subscription has been purchased. INITIAL_PURCHASE Non Renewing Purchase — a customer has made a purchase that will not auto-renew. NON_RENEWING_PURCHASE Renewal — an existing subscription has been renewed, at the end of the current billing period or later if a lapsed user re-subscribes. RENEWAL Product Change — a subscriber has changed the product of their subscription. PRODUCT_CHANGE Cancellation — a subscription or non-renewing purchase has been cancelled. CANCELLATION Uncancellation — a non-expired cancelled subscription has been re-enabled. UNCANCELLATION Billing Issue — a charge attempt for the subscriber failed, but the subscription has not expired; if you are already handling cancellation, a billing-error cancellation can be ignored for access purposes. BILLING_ISSUE Subscription Paused — a subscription has been paused. SUBSCRIPTION_PAUSED Transfer — a transfer of transactions and entitlements was initiated between one App User ID to another. TRANSFER Expiration — a subscription has expired and access should be removed. EXPIRATION
Failure distinctions that matter
Do not treat every event as an access change. Billing Issue is a warning state, not expiration. Cancellation is not always final, because Uncancellation can re-enable a non-expired cancelled subscription. Renewal can also arrive after a lapse, when a former subscriber returns. Build your access logic around Expiration for removal, and use the other events for messaging, offers and payment recovery.
Connecting events to your tools
No-code integrations can connect real-time events and revenue data to your existing tools. Examples listed for this integration area include Adjust, Apple Search Ads, Singular, Branch, SplitMetrics Acquire, Meta Ads, Tenjin and AppsFlyer. Use webhooks when you need event-level control in your own systems, and no-code integrations when you want those events flowing into marketing or attribution tools quickly.
| Event | Meaning | Suggested action |
|---|---|---|
| INITIAL_PURCHASE | New subscription purchased | Start onboarding |
| RENEWAL | Existing subscription renewed | Confirm continued access |
| BILLING_ISSUE | Charge attempt failed; not expired | Send payment-recovery message |
| CANCELLATION | Subscription or non-renewing purchase cancelled | Start win-back flow |
| EXPIRATION | Subscription expired | Remove access |
Event codes are shown exactly as supplied; payload fields and delivery behaviour were not supplied.
Frequently asked questions
Does a billing issue mean access should be removed?
A billing issue means a charge attempt failed; it does not by itself mean the subscription has expired. If you also listen for cancellation, a billing-error cancellation can be ignored for access-removal purposes, as described in the billing-issue guidance.
How do renewal and expiration differ?
Renewal covers an existing subscription renewing at the end of the current billing period, or later when a lapsed user re-subscribes. Expiration is separate: it signals the subscription has ended and access should be removed.
What is the difference between cancellation and uncancellation?
Cancellation covers a subscription or a non-renewing purchase being cancelled. Uncancellation is narrower: a cancelled subscription that has not yet expired is re-enabled.