2fansAPI docs

How payouts work

View as Markdown

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.

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

Last updated 2026-11-02