# How payouts work

Earnings land in the creator’s 2fans balance. From $20 they can request a payout as crypto, a bank transfer or to a card through MassPay, or to Paxum, all included with the API.

## Payout options

Earnings land as funds in the creator's 2fans balance. From there they can request them out in any of these ways, all included when you use the API:

| Option | How it works |
| --- | --- |
| Crypto | Through a MassPay wallet |
| Bank transfer | Through a MassPay wallet |
| Card | Through a MassPay wallet |
| Paxum | To the creator's Paxum account |

## From sale to payout

1. A sale's earnings go into `pending` for at least 14 days. The hold can be longer for a specific account.
2. Each sale is released on its own date, so money moves to `available` every day once a creator is past their first two weeks.
3. The creator requests a payout once at least $20 is available. The whole available balance is paid out, not part of it.
4. Our team reviews the request and sends it.

## Do creators have to go to 2fans?

Not if your app runs it. With the Payouts category switched on, your app can add the payout method and request the payout through the API, so the creator stays in your product. For a MassPay wallet, they open MassPay's activation link once. Personal keys can only read payouts, so those creators use the 2fans dashboard. See [Earnings, balances and payouts](https://2fans.dev/docs/build/payouts.md).

## What your app can do

| Task | How | Access |
| --- | --- | --- |
| Show balances | `GET /balance` | On by default |
| Show earnings | `GET /earnings` | On by default |
| Show payout history | `GET /payouts`, `GET /payouts/summary` | On for personal keys; Payouts category for apps |
| Add a payout method | `POST /payouts/methods`, `POST /payouts/masspay/profile` | Payouts category and an app key |
| Request a payout | `POST /payouts/requests` with an `Idempotency-Key` header | Payouts category and an app key |
| Follow progress | `payout.requested`, `payout.processing`, `payout.paid` and `payout.failed` webhooks | Approved apps |

The Payouts category starts switched off for new apps, so ask us to enable it. An API payout request also needs an account that has passed the ID check.

## If a sale is reversed later

Earnings that haven't been paid out simply drop out. If they've already been paid, they're recovered from later earnings, so a balance can go negative until those cover it.

## Paying your app

If your app is approved, its 5% commission lands in the app owner's balance and is paid out the same way.

## Next

- [Earnings, balances and payouts](https://2fans.dev/docs/build/payouts.md): Show earnings and balances in your product, set up crypto, bank or Paxum payouts, and request them through the API without sending creators to 2fans.
- [Refunds and chargebacks](https://2fans.dev/docs/handled/chargebacks.md): Who deals with disputes, what a reversal does to access and earnings, and the webhook events your app gets.

2fans was called Dropfans until October 2026, so the API host is still www.dropfans.io and keys still start with dpfn_.

Last updated 2026-11-02. All pages: https://2fans.dev/llms.txt.