Reconciling Marketplace Payouts
A marketplace never pays you what you sold. Between the sale and your bank, the platform takes its commission, a payment fee, a shipping charge and its share of any voucher. It pays the rest on its own schedule, and takes back refunds from a later payout. This page is for the person who has to explain the difference. By the end of it, each marketplace has a balance in your books that equals exactly what the platform still owes you, and you can prove it at month end in about fifteen minutes.
BigLedger records part of this and leaves most of it to you. The page says which part is which.
Meet GadgetSphere Online
GadgetSphere Online Sdn Bhd (GSO) sells on four marketplaces as well as its own storefront. Take one
Shopee order: a smartphone invoiced at RM 2,000.00. Nine days later the settlement report shows:
| RM | |
|---|---|
| Order amount | 2,000.00 |
| Commission (6 %) | −120.00 |
| Transaction fee (2.1 %) | −42.00 |
| Shipping fee charged to you | −8.00 |
| Paid out | 1,830.00 |
The RM 1,830.00 arrives in the primary bank as part of a weekly transfer covering 312 orders. The RM 170.00 is a cost of selling on Shopee. If nobody books it, it becomes an unexplained difference between your receivables and your bank.
Before you start
- You can download each platform’s settlement report from its seller centre.
- You can create GL codes in the Chart of Account applet and cashbooks in the Cashbook applet, or know who can.
- Marketplace orders are being invoiced. A settlement report can only clear an invoice that exists.
Three things to know first
Until it pays you, the platform is holding your money. Treat it as a bank account you cannot draw on. That one idea is the whole procedure below. Give each marketplace a cashbook of its own, and its balance is what that platform owes you.
Every one of these parties takes a cut before the money reaches your bank. Names differ by platform; the settlement report lists them.
| Deduction | Who funds it | Does the buyer see it? |
|---|---|---|
| Commission | You | No |
| Transaction or payment fee | You | No |
| Shipping charged to you, or a shipping subsidy the platform pays | Either | Only the shipping they paid |
| Seller-funded voucher | You | Yes, as a discount |
| Platform-funded voucher | The platform | Yes, as a discount |
| Campaign or programme fees | You | No |
BigLedger’s invoice holds the order price and nothing else. A marketplace order comes in at the item price the channel reports, with no separate discount amount, always in Malaysian ringgit. Commission, fees and shipping charges never reach the order or the invoice; they exist only in the platform’s settlement report. Whether a voucher is already inside the item price depends on how the platform reports it. Check one order when a shop opens: compare its invoice with the same order on the settlement report, and write down which vouchers the invoice already includes.
What BigLedger records when a payout arrives
This depends on the marketplace, and on whether the payout job is scheduled for your shop at all. Look for it in the Scheduler applet’s job picker, or ask support.
| Marketplace | What the product does with a payout |
|---|---|
| Shopee | The payout job creates one Receipt Voucher per payout, for the net amount, as a single line, and finalises it. The paying party is an entity record for the shop. The money goes to the cashbook named in the job’s own schedule settings, and the other side credits receivables (Step 3). The breakdown is stored inside the voucher, but no column or report shows it. It is not matched to any invoice, so the invoices it pays stay open. |
| TikTok Shop | The product contains a matcher that would find each order’s invoice and settle it for the smaller of the payout and the amount still open. That leaves the platform’s deductions open on the invoice for you to clear. It is not available to schedule today, so TikTok payouts are recorded by hand. |
| Lazada | An older receipt job, marked for retirement in the code. Do not rely on it. |
| Shopify, your own storefront | No payout job. The storefront’s gateway payments become receipt vouchers one by one (Core Concepts §4). The gateway’s fee is not posted. |
So wherever a job runs, it records that money arrived. It does not record what the money paid, or what was taken before it was paid. The reconciliation is a person’s job on every channel.
Step 1: Set up four accounts and a cashbook for each marketplace
Chart of Account applet, then Cashbook applet. About ten minutes per marketplace, once.
For Shopee, GadgetSphere creates:
| Account | Type | What it holds |
|---|---|---|
CLEAR-MKT-SHOPEE | Current asset | What Shopee owes you. This is the account behind the marketplace cashbook |
Shopee as a supplier, under LIAB-SUPPLIER-TRADE | Payable | The platform’s charges, until they are netted off |
EXPENSE-MKT-COMMISSION | Expense | Commission and programme fees |
EXPENSE-MKT-SHIPPING | Expense | Shipping charged to you |
Then create a cashbook called Shopee (held by platform), pointing at CLEAR-MKT-SHOPEE.
The expense codes have no marketplace suffix. Each shop is its own branch, and every journal
line already carries its branch, so the Sales Report and the ledger can already split commission by
channel. The clearing account does carry the suffix, because it is a balance you reconcile
separately for each platform, just like CASH-PRI-KV01.
- Who: the finance administrator, when a new marketplace shop is opened, and before its first payout.
- How you know it is right: the cashbook appears on Cash Level with a zero balance, under the right company.
Step 2: When a settlement report arrives, book three documents
Receipt Voucher, Purchase Invoice and Payment Voucher. Once per settlement report.
Download the settlement report from the seller centre. It lists the orders being paid and every deduction. For GadgetSphere’s example order:
- Receipt Voucher, at the gross amount, into the Shopee cashbook, contra-linked to the invoices
the report pays. This clears each invoice in full: RM 2,000.00 moves from receivable to
CLEAR-MKT-SHOPEE. For a weekly report of 312 orders, this is one voucher contra-linked to all 312 invoices, not 312 vouchers. That only works if the shop bills one customer. On a Shopee or Lazada shop, that means ticking Default Entity on the marketplace branch (see Running an Online Channel, Step 7). A receipt voucher is made out to one customer, so with a customer per buyer you need one voucher per buyer. A TikTok Shop has no such choice: every TikTok order is billed to a customer record for its buyer, so the accounts clerk books one gross receipt per buyer on the report, into the TikTok cashbook. The check is the same: every invoice the report lists is closed, and the cashbook’s movement equals the report’s net payout. - Purchase Invoice from Shopee as supplier for the deductions: RM 162.00 to
EXPENSE-MKT-COMMISSION(the commission of RM 120.00 plus the transaction fee of RM 42.00), and RM 8.00 toEXPENSE-MKT-SHIPPING. - Payment Voucher from the Shopee cashbook paying that purchase invoice: RM 170.00 leaves
CLEAR-MKT-SHOPEE.
The Shopee cashbook now holds RM 1,830.00, which is exactly what Shopee is about to transfer.
- Who: the accounts clerk. Within two working days of the report, so the month’s figure is never more than one cycle behind.
- How you know it is right: the cashbook’s movement for the report equals the report’s own net payout, to the sen.
Step 3: When the transfer reaches the bank, move it out of the marketplace cashbook
Cashbook applet, Cash Transfer. Once per transfer.
Record a Cash Transfer of RM 1,830.00 from Shopee (held by platform) to your primary bank cashbook, dated the day the money arrived. The Shopee cashbook goes back to what Shopee still owes, and the bank line is ready for Bank Reconciliation.
If the Shopee payout job is scheduled for your shop, stop it before you use this method. Its receipt cannot stand in for the Cash Transfer, and the two together count the money twice. The job books each payout as a receipt voucher with two sides:
- The money side goes to whichever cashbook the job’s own account setting points at. That setting is on the schedule’s Json tab in the Scheduler applet, not on the marketplace branch.
- The other side is a credit to receivables, on the receivable account your company’s defaults give the payout party’s customer type. For an ordinary trade customer that is the company’s default debtor account. The payout party is a record for the shop itself (or, when Shopee’s payout names a customer, a customer record for that id), not the buyers your invoices are made out to. No setting on the job changes this account. Changing the company default would move every customer of that type with it.
So on GadgetSphere’s RM 1,830.00 payout, with the job’s money side pointed at the primary bank, the
bank is right, but CLEAR-MKT-SHOPEE still holds RM 1,830.00 and receivables carry a credit of
RM 1,830.00 that matches no invoice. Pointing the job at the Shopee cashbook instead only puts the
same money into the clearing account a second time.
- Who: whoever administers the Scheduler sets the shop’s Shopee payout schedule to INACTIVE (only ACTIVE schedules run), at the same time as Step 1 and before the first settlement you book this way. The accounts clerk then records every transfer by hand, as above.
- How you know it is right: the Scheduler shows no ACTIVE Shopee payout schedule for the shop, and
after that date the shop’s branch has no receipt voucher made out to the shop’s own record. To see
the credit side for yourself, open one of the job’s earlier receipt vouchers in Ledger and Journal:
it credits a receivable account, not
CLEAR-MKT-SHOPEE. - If the job has already run for payouts you also booked through the clearing cashbook, each one has left both balances above. Do not key Cash Transfers for them. List the job’s receipt vouchers with their dates and amounts and give the list to your accountant, who decides how to correct them.
Two ways to book it, and what each costs
The procedure above is not the only defensible one, and your accountant may prefer the other.
Neither way uses the Shopee payout job’s receipt unchanged. The clearing cashbook works once the job is stopped (Step 3). The net-receipt way can take the job’s receipt as its receipt, but that receipt is made out to the shop’s own record and matched to no invoice, so the invoices it paid stay open and the fee journal alone does not close them. Which way GadgetSphere should take is a choice for your accountant. This page does not choose between them.
| Clearing cashbook (Steps 1 to 3) | Net receipt and a fee journal | |
|---|---|---|
| How | Gross receipt into a marketplace cashbook; the fees as a supplier invoice; the transfer out | The payout received straight into the bank against the invoices; the gap written off to fee expense with a journal |
| Fees visible by type and channel | Yes | Only if the journal is split by type, every time |
| A number for “what the platform owes me” | Yes: the cashbook balance | No. It is spread across open invoices |
| Refunds after payout | A visible reduction in the cashbook (Step 5) | Easily lost in the next net figure |
| Work per report | Three documents | One receipt and one journal |
The comparison of channels on Running an Online Channel needs the fees by type. Only the first way gives you that without extra effort.
Step 4: Prove the balance at month end
Cashbook applet, Cash Level, and the seller centre. About fifteen minutes per marketplace.
On the last day of the month, compare two figures:
- Your side: the marketplace cashbook’s closing balance on Cash Level, plus the invoices on that marketplace branch that are still open because no settlement report has covered them yet.
- The platform’s side: the seller centre’s balance still to be paid to you, whatever it calls it, plus any amount it is holding.
If they differ, the cause is almost always one of four things, in this order:
- A cycle boundary. Orders completed at month end that the platform settles next cycle. The difference clears itself in the next report. Note it, and carry on.
- A held order. An order under dispute or review that the platform has not released. Check the seller centre’s list of held orders.
- A refund clawed back from a report you have not booked yet (Step 5).
- A fee charged late, such as a campaign or programme fee billed separately from the order settlements. Book it as in Step 2.
- Who: the accounts clerk prepares the comparison. The finance manager reviews it and signs it off, and should be someone who did not book the vouchers.
- How you know it is right: every difference is on a written list with one of those four reasons, and the list is shorter than last month’s. Do not close the month on an unexplained difference. Carry it on the list until it is found.
Step 5: Follow a refund into the next payout
A buyer returns a phone after Shopee has paid you for it. Shopee refunds the buyer and takes the money back from your next settlement, as a negative line.
- When the goods have been inspected, raise the credit note against the original invoice (Running an Online Channel, Step 4).
- When the settlement report shows the claw-back, record a Payment Voucher from the Shopee cashbook refunding the customer, contra-linked to that credit note. The cashbook falls by the refund, just as Shopee’s next transfer will.
- If Shopee also refunds part of its commission, reduce the next purchase invoice from Shopee as a supplier by that amount.
- How you know it is right: every negative line on the month’s settlement reports has a payment voucher against a credit note. Any refund without one means your sales are overstated.
What BigLedger will not do, and who does it instead
| It will not | Who does it instead, and when |
|---|---|
| Read a settlement report’s deductions | The accounts clerk books them from the report, once per report (Step 2) |
| Match a Shopee payout to the invoices it pays | The accounts clerk, through the gross receipt’s contra lines (Step 2) |
| Post a payment gateway’s fee | The accounts clerk, monthly, from the gateway’s own statement. The same clearing shape works: a cashbook for the gateway, whose balance then matches the gateway’s unsettled amount (Best Practices §7) |
| Convert a foreign-currency payout | Payouts are recorded in ringgit. The accounts clerk books a payout in another currency at the rate on the payout statement, when it arrives, and posts the difference from the invoice rate to the exchange gain or loss account. The clearing balance returning to what the platform shows is the check |
| Report payouts against sales | The month-end comparison in Step 4 is the report |
Split the duties. The person who approves refunds in the seller centre should not book the credit notes. The person who books the vouchers should not sign off the month-end comparison. Then a refund nobody can explain shows up as a difference between two people’s records.
What success looks like
At month end, for each marketplace:
- The marketplace cashbook’s balance, plus open invoices, equals the platform’s unpaid balance, or every difference has one of the four reasons in Step 4.
- Every settlement report in the month has its receipt, purchase invoice and payment voucher.
- Every transfer received has a Cash Transfer out of the marketplace cashbook, and no Shopee payout schedule is ACTIVE for a shop you reconcile this way.
- Commission and shipping appear in the profit and loss by branch, so each channel’s margin can be read after its costs.
Common mistakes
| Mistake | What you see | Fix |
|---|---|---|
| Treating the net payout as the sale | Sales understated, no fee expense, and invoices left open | Receipt at gross, fees as a purchase invoice (Step 2) |
| The Shopee payout job left running under the clearing method | Keyed with a Cash Transfer: the bank shows the money twice. Not keyed: the clearing account never falls, and receivables carry credits that match no invoice | Set the shop’s payout schedule INACTIVE before the first report you book this way, and give any receipts it already wrote to your accountant (Step 3) |
| Receiving the gross amount straight into the bank | The bank reconciliation is short by the fees every week | Receive into the marketplace cashbook; the bank sees only the transfer |
| Booking a refund only when the goods come back | A clearing balance that drifts down each month | Follow the claw-back into the next report (Step 5) |
| Adding a marketplace suffix to every expense code | A chart of accounts that grows with every shop | Branch already splits expenses by channel; only the clearing account needs the suffix |
Related documentation
- Running an Online Channel: the rest of the channel manager’s job, including returns and whether a channel pays
- Receipt Voucher (Internal) · Payment Voucher (Internal) · Purchase Invoice (Internal) · Cashbook Applet · Bank Reconciliation
- EcomSync related applets: which payout jobs exist for which marketplace
- Reports: what exists, and why payout reconciliation is not among it