Coins, gifts and wallets

How a Coin Economy Works and How to Design One

By the GetFame team Published 12 min read

Short answer

A coin system is a ledger of in-app currency. Users buy coins with real money, spend them on unlocks or gifts, and sometimes earn them free. Platforms use coins to sell small amounts, bundle store purchases and keep paid and promotional balances separate. The design questions are pack pricing, expiry, sinks, creator conversion and an auditable ledger.

Key takeaways

  • A coin is a ledger entry, so the economy is only as sound as its record of every credit and debit.
  • Keep purchased coins and earned or bonus coins in separate balances, because they differ on expiry, refunds and accounting.
  • Apple's guidelines say credits bought through in-app purchase may not expire, so only promotional coins should carry an expiry.
  • The store fee is taken from the pack price, so the real value of a coin is its price net of fees, not its face price.
  • Fraud, refunds and chargebacks can push a balance below zero, so the ledger must be able to hold a debt.
On this page 9 sections
  1. Why platforms use coins instead of cash prices
  2. The anatomy of a coin economy
  3. Two balances: paid coins and earned coins
  4. Pricing the packs: the logic of the ladder
  5. A worked ledger: what happens to one user
  6. Gifts and creator conversion
  7. Expiry and the rules that touch coins
  8. Keeping the ledger honest
  9. Design mistakes, and what to decide next

A coin system is an in-app currency kept in a ledger. Users buy coins with real money in a few packs, spend them on small things such as an episode unlock or a live gift, and sometimes earn a few free ones for coming back. The platform sells in coins because small prices are easier to accept, one store purchase can fund many spends, and the operator gets one place to see and control everything users spend.

This post is the general explainer. It covers what a coin economy is made of, how to keep balances honest, and where the money goes between the user's card and the creator's payout. If you plan a drama app, our ReelShort clone is built around this wallet; the brand-specific pricing method lives in how to price coins in a micro drama app, and the live-gifting version is in how TikTok gifts and coins work. Here we stay on the design that sits under both.

Why platforms use coins instead of cash prices

A coin economy is more work than charging cash at each action, so there has to be a reason. There are four.

  • Granularity. An episode may cost the equivalent of a few cents. A card processor cannot economically handle a payment that small, but a coin spend inside the app costs nothing to process.
  • Bundling. One purchase of a pack funds many later actions, so the fixed fee on the payment is spread over many spends. This matters on both app stores and card gateways.
  • One currency for many actions. The same coin can open an episode, send a gift and unlock a chapter, so the user learns one balance, and you can move prices without changing the pack the user holds.
  • Control. Because spends are your ledger entries, you can run promotions, give rewards, apply limits and cap risk without calling a payment provider.

There are costs. Users treat coins as less than money, which is the intent, but regulators and app stores watch for confusing pricing. Users also build up balances that you must account for, and the system invites fraud. A coin model fits products with many small paid actions and a reason to top up. If your product has one large purchase per user, a plain price is simpler.

The anatomy of a coin economy

Economists who design game currencies describe an economy as sources, sinks and a stock. The same words work for a creator app.

PartWhat it isMicro drama exampleLive gifting example
Source: purchaseReal money in, coins creditedCoin pack at checkoutCoin pack in the live room
Source: rewardFree coins you issueDaily check-in, quests, referralWelcome bonus, event promotions
Sink: unlockCoins spent for accessPer-episode pricePaid replay or room entry
Sink: giftCoins spent to give value to another userRareVirtual gifts to a creator
Sink: expiryCoins removed by ruleReward coins past their windowPromotional coins past their window
ConversionValue passed to a creatorRevenue share to a studio, off-ledgerGift value turned into creator earnings
StockCoins held but not yet spentUnspent balancesUnspent balances

The stock is the number to watch. Coins outstanding are an obligation: users paid for them and expect to spend them. Ask your accountant how to record that obligation, since treatment depends on your jurisdiction. Operationally, track the stock by balance type, the age of the oldest paid coins and the ratio of coins sold to coins spent in a month. A stock that grows faster than spending means users are hoarding or have lost interest, and it will come back as a refund request.

Two balances: paid coins and earned coins

The most useful design decision is to keep two balances, not one. Paid coins were bought with real money. Earned coins were given by you as a reward or bonus. Merging them into one number looks simpler and creates problems later.

RulePaid (purchased) coinsEarned (reward and bonus) coins
OriginCard, web checkout or store billingCheck-ins, quests, referral, bonus on packs, coupons
ExpiryShould not expire where store rules applyMay expire on a stated window
Refund and chargebackReversible, must be recoverableNothing to refund; can be revoked for abuse
Spend orderSpent secondSpent first
ReportingCounts toward obligations to usersCounts toward promotion cost
Cash-outNever converts to moneyNever converts to money

The spend order matters. Spending earned coins first uses up the promotional balance before it expires and keeps the purchased balance, which has no deadline, for later. It is also the order that users find least surprising, since free coins are visibly used. Our white-label ReelShort clone works this way: reward coins and purchased coins are tracked apart, the console shows both, and a spend draws reward coins before purchased ones. The ReelShort clone features page describes the wallet and the reward ladder.

Some platforms add a third unit, often called gems, diamonds or points, for items you do not want to price in coins, such as a premium cosmetic or a creator earning unit. A third unit is justified only when it follows different rules from coins. Otherwise it is one more thing for users to misunderstand.

Pricing the packs: the logic of the ladder

A pack ladder is the list of packs on the top-up screen, from a small impulse pack to a large one. We cover the step-by-step method, including episode price and bonus tuning, in the coin pricing post, so here is only the logic you need to design the economy.

  1. Fix a base value. Decide what one coin is worth in the smallest pack. Every other pack is a discount from that base, so the base is the anchor for all comparisons.
  2. Make each step visible. A user should see why a bigger pack is a better deal, typically through bonus coins rather than a lower price per coin on the label.
  3. Offer a first-purchase pack. A one-time offer lowers the barrier to the first payment, and the first payment is the hardest conversion.
  4. Check the top of the ladder after fees. A bonus that looks small to the user can be large to you. Run the net revenue per coin through every channel before publishing.

The net revenue per coin is the figure that drives the whole economy. The next sections show how to compute it.

A worked ledger: what happens to one user

These are invented numbers for illustration. Say one coin has a base value of 0.01 and a pack of 500 coins costs 5.00 with 50 bonus coins. A user opens the app, earns a reward, buys the pack, watches several episodes at 30 coins each, sends a gift and later disputes the purchase. The ledger records each event as an entry with a type, an amount and a balance after.

StepEntryEarned balancePaid balanceNote
1Check-in reward +20200Source: reward
2Pack bought: +500 paid, +50 bonus70500Source: purchase, 5.00 charged
3Unlock episode, -3040500Earned spent first
4Unlock episode, -3010500Earned spent first
5Expiry sweep, -10 earned0500Promotional window ended
6Unlock episode, -300470Paid spent
7Gift sent, -1000370Sink: gift, creator credited
8Chargeback reverses the pack, -500 paid0-130Debt of 130 coins, account blocked

Four things stand out. First, every row is a new entry, and no row edits an earlier one. Second, the balance after the chargeback is negative, because the user had already spent 130 purchased coins. The ledger has to represent that debt, block further spending and let support clear it. Third, the 100-coin gift at step 7 had already credited a creator, so the creator-side entry needs a reversal rule, which is covered below. Fourth, the earned coins expired without any effect on what the user paid.

From face value to platform revenue

Now compute what the platform keeps. The user paid 5.00 for the pack. Channel costs come out first. Apple's Small Business Program page says the standard commission is 30% and the reduced rate is 15% for developers with up to 1 million USD in proceeds in the prior calendar year, as of October 2026. Google Play's service fees page describes tiered fees that also reach a 15% tier on the first 1 million USD of annual revenue, with other rates by transaction type. For a web checkout we assume 5% as an example.

Channel (example rate)Fee on 5.00Net to platformNet per coin credited (550 coins)Gift of 100 coins, creator share 50% of face
Store at 30%1.503.500.0064Face 1.00, creator 0.50, platform keeps about 0.14
Store at 15%0.754.250.0077Face 1.00, creator 0.50, platform keeps about 0.27
Web checkout at 5%0.254.750.0086Face 1.00, creator 0.50, platform keeps about 0.36

The last column treats a gift as costing 100 coins at the net value of the channel the coins came through, then subtracts a creator payment set at half of face value (1.00 times 50%). It shows why a platform that pays creators by face value must watch its channel mix: at a 30% store fee, the platform's remainder is under a third of the creator's share, and any extra cost, such as moderation or a chargeback, moves it toward zero. The point generalizes: set creator payouts against net revenue per coin, not against the price on the pack.

Gifts and creator conversion

In a drama app, the sink is an unlock, and the money flow to creators is usually a contract with a studio outside the ledger. In live gifting, the sink is a gift, and the conversion to a creator is part of the ledger itself. This is where the second unit appears.

TikTok's virtual items terms describe the chain. Users buy coins, exchange them for virtual gifts and send gifts to creators during live streams. Creators receive diamonds, which cannot be bought and which TikTok describes as a measure of popularity, and creators can withdraw diamonds for money under rates TikTok sets. The terms also say coins cannot be exchanged for cash and gifts are final. If a gift giver receives a refund, the creator must return that portion within 5 business days. The design lessons, independent of any brand, are these.

  • Separate the unit the fan buys from the unit the creator earns. This blocks any path from a fan balance to a cash withdrawal, which is where laundering and fraud usually look for a gap.
  • Set the conversion rate as an operator setting. You will tune it, and it is a promise to creators, so announce changes.
  • Write down who bears a reversal. If a gift is reversed after the creator earned it, say whether you claw it back from the creator's balance or absorb it.
  • Add a minimum withdrawal. Tiny payouts cost more to send than they are worth.

The gift catalog design, the room dynamics and the margin by gift tier are in the TikTok gifts post. A TikTok clone carries that gift economy, with earned value landing in a creator wallet and withdrawals approved in the admin panel. The same mechanics also fit a fan platform: the OnlyFans clone includes a wallet that fans top up for tips and gifts.

Expiry and the rules that touch coins

Expiry is the most disputed part of coin design, and it is partly decided by the stores, not you.

Apple's App Review Guidelines, section 3.1.1, state that credits or in-game currencies purchased by in-app purchase may not expire, and that apps need a restore mechanism for restorable purchases. They also say apps may use in-app purchase currencies to let customers tip developers or digital content providers, and that gifts of purchasable items may only be refunded to the original purchaser and may not be exchanged. Those are published guidelines as of October 2026, and they can change, so read the live page before you ship. For the Google side and the detail of how billing works for drama coins, see app store billing for drama coins and Apple and Google in-app purchase rules.

The practical rule follows from the two-balance design:

  • Purchased coins do not expire while the account is active.
  • Earned and bonus coins can expire, with a stated window shown to the user before they earn the coins and visible in the wallet.
  • Account closure is a separate rule. TikTok's terms say coins, gifts and diamonds are cancelled on account cancellation or termination. State your own closure rule plainly.

Expiring promotional coins does two jobs. It keeps free balances from piling up as a liability, and it gives users a reason to return before the deadline. It also creates a trust risk if the window is hidden, so show the date. This is not legal advice; consumer rules on virtual currency differ by country, so ask counsel before you set expiry terms for any market.

Keeping the ledger honest

The economy is a bookkeeping system with a user interface. If the books are wrong, every other part fails. These rules are standard for any balance system.

  1. Append only. Never edit or delete a ledger row. A correction is a new row that references the one it fixes. Balances are derived from entries or reconciled against them.
  2. Typed entries. Each row carries a type code: purchase, reward, unlock, gift, expiry, refund, adjustment. Typed rows are what make the analytics trustworthy, since revenue by episode or by gift is a query, not an estimate.
  3. Idempotent writes. A store callback or a button double-tap should never credit twice. Give each external event a unique key and refuse to apply it again.
  4. Atomic spends. Checking the balance and debiting it must be one operation, or two simultaneous unlocks can overspend.
  5. Daily reconciliation. Compare coins sold in the ledger with settled payments from the stores and gateways, and compare the sum of balances with the sum of entries. Investigate any difference the same day.
  6. Audited adjustments. When an admin credits or removes coins, the row records who did it and why.

Fraud patterns to design against

  • Reward farming. Many accounts claiming check-in or referral rewards. Limit by device, verify referrals on a first purchase and cap daily earnings.
  • Chargeback after spend. The user buys, spends and disputes, as in step 8 above. Hold new users to low limits and block accounts with a negative balance.
  • Stolen cards used for gifting. A stolen card funds gifts to a colluding creator, who then withdraws. Delay withdrawals on new accounts and review large gift flows to new creators.
  • Restore abuse. A replayed store receipt credits coins twice. Verify each receipt once with the store and record it.
  • Insider adjustments. Require two roles for large manual credits.

The ReelShort clone ships a typed ledger, a wallet inspection tool and the ability to block an account or adjust a balance, and the operator console reports revenue by the typed codes. The ReelShort clone business model page lays out how these revenue lines connect.

Design mistakes, and what to decide next

Most coin economies that leak money do so for one of these reasons.

  1. A single merged balance. You cannot expire promotional coins without touching purchased ones, and you cannot report the two separately.
  2. Pricing from face value. A large pack with a generous bonus looks fine at face value and loses money through a 30% store fee.
  3. Rewards that outrun purchases. If the free coins let users watch everything, nobody buys. Tune the reward ladder against paid conversion.
  4. No sink for the stock. Coins that nothing useful can buy sit idle and turn into refund claims. Keep adding things worth spending on.
  5. Hidden expiry or unclear refund terms. Users forgive a rule they saw and resent one they discovered.
  6. No negative balances. A ledger that cannot hold a debt will be gamed by chargebacks.
  7. Creator payouts set from pack price. Always set them from net revenue per coin.

Here is what to settle before launch: your base coin value, your two balances and their rules, the ladder and its first-purchase offer, the sinks users will spend on, the conversion rate to creators if gifts exist, the expiry window and its disclosure, and the reconciliation routine. Then price the result in each billing channel with real fees. If you are weighing coins against other revenue types, our overview of how creator platforms make money compares the five engines side by side, and the pricing page shows what the platform itself costs to own.

Questions and answers

Should coins expire?

Coins bought through Apple in-app purchase should not. Apple's App Review Guidelines say credits or in-game currencies purchased this way may not expire. Promotional coins you give away, such as check-in rewards or bonus coins, can carry an expiry if you tell users. Store the expiry on a separate balance so the two never mix.

Can users cash coins out?

Usually not. TikTok's virtual items terms say coins cannot be exchanged for cash. Creators are paid through a different unit, which TikTok calls diamonds, at a rate the platform sets. If you design a creator earning unit, keep it separate from the coin that fans buy, so a fan balance can never become a withdrawal.

What is the difference between coins and a wallet?

A wallet is the container and coins are one thing inside it. A wallet can hold cash balances, coins, bonus coins and gems, each with its own rules. Some platforms call a stored cash balance a wallet, while others use the word for the coin balance itself. Define each balance and its rules in your terms.

Does a coin model work without video?

Yes. Coins suit any product with many small paid actions: unlocking a chapter of a story, sending a gift in a live audio room, buying a sticker pack or a paid reply. The model needs frequent low-value purchases and a reason to top up. Without them, a plain subscription or a fixed price is simpler.

Why do coin packs include bonus coins?

Bonus coins give a reason to buy a bigger pack, which raises the amount charged per transaction and lowers the share lost to fixed fees. They also create a promotional balance you can expire. Keep the bonus modest enough that the largest pack still earns after store fees.

How do refunds work for coins?

That depends on the channel and your terms. TikTok states that gifts are final and that unused coins are not refunded. If a store or card issuer reverses a purchase, you still have to recover the coins that were bought. Your ledger must be able to record a negative balance and block further spending until it is cleared.

Sources

  1. Apple App Review Guidelines (3.1.1 In-App Purchase)
  2. TikTok Virtual Items Terms
  3. Apple Small Business Program
  4. Google Play Console Help: Service fees

Checked in October 2026. Rules, fees and programme terms change; confirm on the source before you rely on them.

Independence note. GetFame is an independent software company. ReelShort and TikTok are trademarks of their respective owners and are named here only to describe a category of platform. GetFame is not affiliated with, sponsored by or endorsed by any of them.

ReelShort guidesTikTok guides All articles

→Start here

Tell us what you want to launch.

Share the platform and your market. You get a walkthrough of the live demo, the exact scope of what ships, and a fixed price in writing. First response in under 2 hours, Monday to Saturday, 10:00 to 19:00 IST.

We reply to every inquiry. No newsletters, no shared data. See our privacy policy.