> ## Documentation Index
> Fetch the complete documentation index at: https://api.fanvue.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# App revenue share

> Take a percentage of a creator's earnings on every eligible payment made through your app: turning it on, creator consent, the calculation and rate changes.

**Revenue share** pays your app a percentage of a creator's earnings on every eligible payment made through your app. You turn it on and set the rate on your app's **App details** tab. The creator accepts it on the screen where they connect your app, and Fanvue takes your share out of the creator's earnings on each payment. It works for every app type, API-only and off-platform included, and sits apart from [pricing plans](https://api.fanvue.com/docs/payments/app-billing/pricing-plans.md), so an app can bill creators, take a revenue share, or both.

You need an app in the [Developer Area](https://www.fanvue.com/dev) and creators who connect it through [OAuth](https://api.fanvue.com/docs/authentication/overview.md).

## Turn on revenue share

In the Developer Area, open your app and go to the **App details** tab. In the **Revenue share** section, turn the setting on and enter a rate as a percentage, up to 50%. The setting saves as soon as you change it and is not part of app review.

The share applies to all [eligible sales](#what-the-share-applies-to) unless you limit it to some of them. You can also share it with one other builder, who is paid their own rate.

No share is taken on a creator's payments until that creator accepts the rate. Turning the setting on changes nothing for creators who connected your app before, until they go through the consent screen again. [Ask connected creators to accept](#ask-connected-creators-to-accept) covers how.

The share is set once for the whole app; pricing plans carry none. Read the [App Revenue Share Terms](https://legal.fanvue.com/app-revenue-share-terms) before you set one, because they set out what you and the creator each agree to.

## What the share applies to

The share is taken on every eligible payment made through your app. The table defines which payments are eligible.

| Included | Not included |
| - | - |
| Paid messages and paid media your app sends through the API | Subscriptions to the creator and their renewals |
| Paid access to your fan experiences | Tips |
| Priced actions fans buy inside your fan experiences | The creator's sales made outside your app, including through other apps |
| | Checkout links your app creates |
| | What the creator pays for your own [pricing plans](https://api.fanvue.com/docs/payments/app-billing/pricing-plans.md) and [one-time items](https://api.fanvue.com/docs/payments/app-billing/one-time-items.md) |

## How the share is calculated

The rate applies to the creator's earnings on a payment, never to the price the fan paid. Start from the sale price before tax. Fanvue's fee comes off first, then your rate applies to what remains.

Assuming a 20% Fanvue fee and a 15% rate, a \$10 sale splits like this:

| Line | Amount | Goes to |
| - | - | - |
| Sale, before tax | \$10.00 | |
| Fanvue fee (20%) | \$2.00 | Fanvue |
| Creator earnings before revenue share | \$8.00 | |
| Your share (15% of \$8.00) | \$1.20 | You |
| Creator earnings after revenue share | \$6.80 | Creator |

## What creators see

The creator accepts the revenue share on the Fanvue consent screen, the same screen where they grant your app's scopes. The screen shows your rate, what it applies to, what it excludes and a link to the terms. Allowing the connection accepts the revenue share, and records an agreement for that creator and your app at the rate shown.

Only the creator's own account can accept. An agency manager working in the creator's account cannot accept for them, so no share is taken until the creator accepts it themselves. A fan or agency account that authorises your app never sees the revenue share.

A creator who installed your app from the App Store is also asked when they open your app's creator page on Fanvue. An agency manager who opens that page in the creator's account cannot accept for them.

## Ask connected creators to accept

Creators who connected your app before you turned revenue share on, or before you raised the rate, have to accept again before a share is taken on their payments. How they reach the consent screen depends on your app.

For an on-platform app, Fanvue shows the screen the next time the creator opens your app. An app with a fan experience and no creator authorisation step is the exception. Creators who installed it before you turned revenue share on, or before you raised the rate, accept only by installing the app again.

For an API-only or off-platform app, send each of these creators through authorisation again. A creator whose app keeps refreshing its tokens never returns to the consent screen on their own, so your app has to start a new authorisation.

When your app has a remembered authorisation for the creator and the creator has not accepted your current rate, Fanvue shows the consent screen again instead of approving silently. To force the screen on every request you send for this purpose, add `prompt=consent` to the [authorisation URL](https://api.fanvue.com/docs/authentication/implementation-guide.md#build-the-authorisation-url):

```text theme={null}
https://auth.fanvue.com/oauth2/auth?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&response_type=code&scope=openid+offline_access+offline+read:self&state=RANDOM_STRING&code_challenge=CODE_CHALLENGE&code_challenge_method=S256&prompt=consent
```

With the [Builder SDK](https://api.fanvue.com/docs/app-store/sdk/off-platform.md), pass `prompt: "consent"` to `createConfig` for the route that starts the re-authorisation, or set `OAUTH_PROMPT=consent`. The variable applies to every authorisation the config starts.

## Change or turn off the rate

An agreement is locked at the rate the creator accepted. What happens to existing agreements when you change the setting:

| Change | Existing agreements |
| - | - |
| Raise the rate | Unchanged. The new rate applies to each creator only after they accept it on the consent screen |
| Lower the rate | Move to the lower rate automatically, with no action from the creator |
| Turn revenue share off | All end. No share is taken on any creator's payments |

New creators always see and accept the current rate.

## When an agreement ends

A creator's agreement ends when they uninstall your app. For an app they connected without installing it from the App Store, it ends when they disconnect it from their account. A payment made after it ends carries no share. If the creator connects or installs your app again, they accept the rate again on the consent screen.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.