Referrals and earnings
You can earn on Lantfly in two ways:
- Paid actors: other accounts run an actor you published with a price per result or per event. See Monetization for how to set prices.
- Referrals: people you refer sign up and pay.
Both land in the same Earnings balance (https://lantfly.com/earnings, under Billing & usage).
Earnings from paid actors
When another account runs your paid actor, you earn 80% of the result and event charges that account actually paid for with money.
- Compute units and proxy traffic are never shared. They are the platform's.
- Usage covered by a Free plan's included usage, a free trial or credit granted for free does not earn.
- Runs of your own actors by your own account (or your organization) do not earn.
- Some actors charge a different price per plan. You earn 80% of the price actually charged.
From pending to usable
| Status | Meaning |
|---|---|
| Pending (awaiting settlement) | The customer's billing period has not been billed yet, so it is not known how much of the charge was paid |
| In hold | Settled. Each charge is held for 30 days from settlement (Payable from shows the date) |
| Available to use | Out of the hold: you can move it to credit |
| Reversed | Taken back because the customer's payment was refunded or disputed. Shown struck through |
The customer paid X of the Y charged means the customer's money covered only part of that charge, and you earn on the part that was paid.
The Earnings page shows the balance cards (Available to use, Pending, Moved to credit, Earned all time, with the part from referrals and the part reversed), a table By actor (charges, what customers paid, what you earned, what is still in hold) and the Latest charges.
Use your earnings: move them to credit
Earnings are not paid out in cash. You move them to the prepaid credit of the same account, 1:1 in USD, at once. Credit pays for runs, proxy and usage over your plan (see Billing).
- Open Earnings → Use your earnings.
- Click Move to credit and confirm.
| Rule | Value |
|---|---|
| Minimum | $1 |
| Who | Owner and admins (in an organization) |
| Reversible? | No: moved credit cannot be turned back into earnings or cash |
Each move is listed under Payouts with status In credit.
Credit that comes from earnings is not money paid through Paddle. If you spend it on another developer's paid actor, that developer earns nothing from it, as with credit granted for free.
Referral program
The referral program may not be open yet. In that case Settings → Referrals shows The referral program is not open yet. The terms below are the current defaults; the Referrals page always shows the terms that apply to you.
Open Account settings → Referrals (https://lantfly.com/settings/referrals).
Your referral link
- Each account (personal or organization) has a referral link of the form
https://lantfly.com/?ref=<your ID>. Use Copy referral link. Adding?ref=<your ID>to any Lantfly page link works too. - A browser keeps the first referral link it opened for 90 days. If that person signs up within that time, they count as yours.
- Owners and admins with billing rights can change the Referral ID (4 to 32 lowercase letters, digits and dashes). Links with the old ID stop counting. Sign-ups already counted stay.
- You cannot refer your own account.
Commission
| Term | Default |
|---|---|
| Rate in the first 3 months after the referred account signs up | 20% |
| Rate after that | 30%, recurring |
| Maximum per referred account | $2,500 |
| Hold before it is usable | 30 days after each payment |
Commission is calculated on what the referred account actually pays, before tax (after discounts). A refund or chargeback takes the commission on that payment back, even after the hold.
Only payments of the referred account itself count. An organization that person creates later does not.
Referral statistics
The Referrals page shows Link visits (once per browser), Sign-ups and how many are paying, Pending commission (in hold), Earned all time and the amount reversed. Referred accounts lists the latest 100 (emails masked) with their status: Not paid yet, Paying · rate or Cap reached. Latest commissions shows each payment, rate, amount and the date it becomes payable.
Commissions join your Earnings balance and are used the same way: move them to credit.
Permissions
In an organization, viewing Earnings needs billing.view. Moving earnings to credit and changing the referral ID
need the owner or an admin. See Roles and permissions.
API endpoints
| Endpoint | What it does |
|---|---|
GET /api/v3/earnings | Balance (pending, available, moved/paid, lifetime, reversed), share, hold days, per-actor totals |
GET /api/v3/earnings/history | One row per charge: gross_usd, paid_usd, amount_usd, settled_at, available_at, reversed_at |
POST /api/v3/earnings/credit | Move earnings to credit: {"amount_usd": 25}, or no amount for everything available |
GET /api/v3/earnings/payouts | Moves to credit |
GET /api/v3/referrals, PUT /api/v3/referrals/code | Referral terms, link, stats, referred accounts and commissions; change your referral ID |
curl -X POST https://lantfly.com/api/v3/earnings/credit \
-H "Authorization: Bearer $LANTFLY_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'