Skip to content
AppDues
Log in
Contact salesSign up

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.

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.

ConfigureTargetTest
Event-to-action map
EventMeaningSuggested action
INITIAL_PURCHASENew subscription purchasedStart onboarding
RENEWALExisting subscription renewedConfirm continued access
BILLING_ISSUECharge attempt failed; not expiredSend payment-recovery message
CANCELLATIONSubscription or non-renewing purchase cancelledStart win-back flow
EXPIRATIONSubscription expiredRemove 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.