Platform Account
Introduction
Platform Account helps platforms that manage a large volume of sellers, freelancers, or pre-paid wallet users streamline account creation, fund collection, revenue splitting, and payouts.
This is ideal for gig platforms and marketplaces that need to onboard participants quickly, collect payments centrally, split revenue automatically, and distribute funds without requiring each participant to maintain a separate bank relationship.
💡 This guide covers the Platform Account use case. For comparison with other account types, see Account types.
What you can do
- Instantly create ledger accounts for sellers or freelancers via API
- Collect buyer or client payments into a central master virtual account
- Split revenue atomically between participants and your commission pool
- Control fund release timing with virtual balance partitions
- Initiate low-cost local payouts to participants' bank accounts or wallets
Example
Figure 1. Structure of Platform Account
Let's imagine a fictitious gig economy platform called GigHive, which connects freelance designers, writers, and developers with clients around the world. GigHive manages thousands of freelancers who need fast onboarding, transparent earnings tracking, and flexible withdrawals.
User Journey
Figure 2. Fund flow of Platform Account
1 A client pays for a completed project into GigHive's master virtual account.
2 GigHive atomically splits the payment between the freelancer's ledger account and the platform's commission ledger.
3 The freelancer's share enters a pending state for a configured holding period.
4 After the holding period, the balance becomes withdrawable.
5 The freelancer requests a withdrawal, and GigHive initiates a payout to their local bank account or wallet.
Typical Customers:
- Gig platforms managing freelancers or independent contractors
- Pre-paid wallet or e-money platforms
- Creator economy platforms paying influencers and content producers
- On-demand service platforms distributing earnings to workers
Building it with WorldFirst
Step 1: Create ledger accounts for freelancers
Start by onboarding each freelancer through a Lite KYC (Level 2) flow — typically a name and mobile or email verification. Once verified, call the Create Ledger API to create a dedicated ledger account instantly. The freelancer can start accepting gigs without waiting for document review.
Step 2: Collect client payments
Client payments are collected into the platform's master virtual account. Because individual freelancers do not have their own virtual accounts, all inbound funds flow into the platform's pooled balance. The ledger system tracks how much of that balance belongs to each freelancer through independent virtual balances.
Step 3: Split revenue atomically
When a project is marked complete, the platform calls the Split (1-to-N) API to distribute the payment. For example, a single $1,000 gig might be split into 85% to the freelancer's ledger account and 15% to the platform's commission ledger. The split is atomic: either all allocations succeed, or the entire operation fails. This prevents partial distributions that would create reconciliation nightmares.
If a split needs to be reversed, the platform can call Split Reverse using the original split identifier to refund all associated amounts.
Step 4: Manage balance states
Each ledger account maintains virtual balances that the platform can partition. A common pattern is maintaining two states: "pending settlement" and "withdrawable." When a split occurs, the freelancer's share enters the pending state. After a configured holding period (for chargeback protection or contractual terms), the platform moves the balance to withdrawable, at which point the freelancer can request a payout.
Step 5: Initiate withdrawals
When a freelancer requests a withdrawal, the platform validates that sufficient withdrawable balance exists and initiates a payout on the freelancer's behalf. The freelancer provides local bank account or wallet details, which the platform stores as recipient information. The payout is executed from the platform's master account, with the ledger automatically debiting the freelancer's virtual balance.
Step 6: Reconcile and report
For reconciliation, the platform regularly pulls Sub-Ledger Statements by ledger identifier to reconcile each freelancer's virtual balance against actual gig and payout activity. Consolidated views show the platform's total liability across all freelancers, ensuring that the sum of all virtual balances never exceeds the physical balance held in the master virtual account.