Pricing Plans

Pricing plans are the monthly subscriptions creators buy to access your app. Configure them in the Builder; Fanvue runs checkout and renewals and emits app.* webhooks for every charge.

​

Create a plan

In the Builder (Developer area), open your app and go to Store Listing → Pricing, then Add Plan. Fanvue takes 20% of each sale; you keep 80%.

​

Plan lifecycle

Read the same lifecycle over the API with GET /apps/{appUuid}/subscription-status: each plan’s status plus an app-level overallStatus.

​

Plan IDs

Every plan has a UUID, shown in the Plan ID column of the pricing table; click it to copy the full value. You will use it in three places:

• Deeplinks: ?plan=<planUuid> preselects the plan on your listing; add &action=checkout to skip the picker. See Deeplinks.
• Webhooks: the plan comes back as item.uuid on app.payment.* and as plan.uuid on app.subscription.* events.
• Entitlement: GET /apps/{appUuid}/subscription/me returns the buyer’s matched planUuid, which you compare against your feature tiers.

​

How buyers subscribe

A creator can reach checkout for a plan three ways:

1. Your listing’s plan picker.
2. A deeplink with the plan preselected, or straight into checkout. Safe to send to broad audiences.
3. A checkout link (https://www.fanvue.com/checkout/app_...); buyers must be signed in.

​

What fires when someone subscribes

The money and the access state arrive as separate events: The subscription payload does not tell you when access ends: status stays active (including after a cancellation) and expires_at is always null, so branch on cancel_at_period_end, and read live state from GET /apps/{appUuid}/subscription/me (hasActiveSubscription, currentPeriodEnd, cancelAtPeriodEnd). app.subscription.deactivated is a reserved name that is not emitted.

​

Tracking revenue

Subscriber counts are in the pricing table, earnings in your app’s Revenue tab. For programmatic reconciliation, see Reconciliation.