> ## 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.

# Payments on Fanvue

> Compare checkout links, App Store billing and fan experience payments: who pays whom, how amounts and fees are reported, and where to read results.

Fanvue has three payment rails. Creators sell to fans with checkout links, your app bills creators through the App Store, and fans pay creators inside an experience your app runs. Pick the rail by who is paying whom, then follow its guide.

Every rail's API and webhook access runs through an app in the Developer Area. Even a creator-side integration that only reads checkout results needs to [create an app](/docs/get-started/build-your-first-app) for its OAuth credentials.

## Choose a rail

| Rail | Who pays whom | You create | You get paid | Read results | Webhooks |
| - | - | - | - | - | - |
| Checkout links | Fan pays creator | A link, via the Checkout Links page or `POST /checkout-links` | The creator earns the sale; read `net` and `fees` on the payment | `GET /creators/{creatorUserUuid}/checkout-links/payments` | `checkout_link.*`, `payout.*` |
| App Store billing | Creator pays your app | Plans and one-time items in the Developer Area | 80% of each charge; the platform fee is 20% | `GET /apps/{appUuid}/payments`, `GET /apps/{appUuid}/subscription-status` | `app.*` |
| Fan experiences | Fan pays creator | Priced actions and paid access on an experience | Nothing; the creator is the seller at the standard Fanvue fee | `GET /experiences/{experienceUuid}/action-purchases` | `app.experience.action.*`, `creator.experience_subscription.*` |

<CardGroup cols={3}>
  <Card title="Create checkout links" icon="link" href="/docs/checkout/create">
    Sell a product to anyone with a Fanvue-hosted checkout page.
  </Card>

  <Card title="Bill creators through the App Store" icon="puzzle-piece" href="/docs/payments/app-billing/overview">
    Charge creators for your app with plans and one-time items.
  </Card>

  <Card title="Payments inside fan experiences" icon="ticket" href="/docs/app-store/experiences/payments">
    Let fans pay the creator for actions inside your experience.
  </Card>
</CardGroup>

Checkout links accept several payment methods, BNPL instalments among them. [Create checkout links](/docs/checkout/create) lists the methods, and [Instalments](/docs/checkout/installments) covers how a BNPL sale arrives.

Every `checkout_link.*`, `payout.*` and `app.*` event arrives in the [Standard-Webhooks envelope](/docs/webhooks/index#event-envelope) with a snake\_case resource in `data`; the [event catalogue](/docs/webhooks/event-catalog) lists them all. Each of those topics, `app.experience.action.*` included, has a test payload, so you can [send a test delivery](/docs/webhooks/subscribing#test-a-destination) and exercise a handler without a real charge.

## Units and currency

Amounts are integers in USD minor units (cents): `1999` means \$19.99. Settlement is in USD on every rail.

The `currency` field on a checkout payment is informational. It names the local currency the fan paid in, while `gross`, `net` and the `fees` amounts are already converted to USD minor units. App webhooks always carry `"currency": "USD"`.

## Fees

Checkout fees are read from the payment, never from a published rate. The checkout payment resource carries `gross`, `net` and `fees { fanvueFee, transactionFee }`, all in USD minor units. The `checkout_link.payment.*` webhook carries the same values in snake case as `fees { fanvue_fee, transaction_fee }`, plus `total` (what the fan was charged) and `tax`.

Reconcile the creator's earnings from `net`. On an inclusive-tax link `gross` is the pre-tax base, so compare fan charges against `total` and `tax` on the webhook rather than `gross`. [Reconcile checkout payments](/docs/checkout/reconcile) walks through it.


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