Ledger Architecture & Escrow Clearing Dynamics
BDX.market operates a dual-entry digital ledger system designed to enforce financial integrity, prevent unauthorized balance mutations, and provide full transparency over seller earnings.
This document provides a reference for the seller ledger model, escrow clearing calculation rules, hold mechanisms, and dispute collateral reservations.
1. Core Ledger Entry Types​
All financial activity linked to a seller store profile is recorded as individual, immutable ledger entries.
Ledger Entry Types​
- Sale Credit: Revenue credited from a completed buyer order (gross sale price minus category commission).
- Payout Debit: Funds deducted upon approval and disbursement of a seller payout request.
- Refund Debit: Deductions applied when an order is cancelled or refunded following a dispute verdict.
- Adjustment Credit / Debit: Administrative ledger adjustments issued for promotional credits, dispute resolutions, or fee corrections.
2. Commission Calculation & Sale Credits​
When a buyer confirms delivery or an order auto-completes after 7 days, sale credits are generated automatically:
Gross Earning = unit price * quantity
Commission Rate (%) = category commission rate
Net Seller Credit = Gross Earning * (1 - Commission Rate / 100)
Example: An order for a digital game key sold at 1,000 BDT with a category commission of 5% yields a net seller credit of 950 BDT.
3. Balance Classifications​
To ensure sellers understand exactly where their money is, seller funds are divided into four distinct financial metrics:
Total Earnings Ledger
├── Held / Escrow Balance (Orders in progress, awaiting delivery/confirmation)
├── Clearing Balance (Completed orders undergoing security clearing)
├── Open Dispute Reserves (Collateral locked for open buyer disputes)
└── Available Balance (Matured funds ready for immediate payout request)
A. Held / Escrow Balance​
Funds associated with active, unconfirmed orders where delivery or buyer confirmation is pending. Money remains safely in BDX escrow until order completion.
B. Clearing Balance​
Earnings from completed orders where the mandatory security hold period has not yet expired. These funds belong to the seller but cannot be withdrawn until the clearing countdown completes.
C. Available Balance​
The net liquidity available for immediate withdrawal:
Available Balance = Total Matured Credits - Executed/Pending Debits - Requested Payouts
D. Reversed Balance​
A record of earnings reversed due to approved buyer refunds or administrative dispute decisions.
4. Escrow Clearing Window​
To protect the marketplace against fraudulent sellers attempting immediate withdrawal after delivering invalid or temporary digital goods, BDX implements a security clearing window:
- Clearing Countdown: Upon order completion, earned funds enter a clearing period.
- Maturity: Once the clearing countdown completes, funds transition automatically from clearing balance into available spendable/withdrawable balance.
- Dashboard Countdown Timers: Sellers can view real-time countdown timers for upcoming clearing credits on their Seller Dashboard.
5. Open Dispute Collateral Reservations​
When a buyer opens a dispute against an order, BDX protects the marketplace against seller balance draining:
- Dispute Collateral Reservation: Funds equal to the disputed order value are reserved from the seller's withdrawable balance while moderation is active.
- Over-Withdrawal Protection: If a seller has 5,000 BDT in available balance but faces an active dispute on a 2,000 BDT order, BDX reserves 2,000 BDT as collateral. The maximum allowable payout request is constrained to 3,000 BDT until the dispute is resolved.
6. Protection Against Double-Spending​
To eliminate double-spending and financial race conditions:
- Unique Transaction References: System rules prevent duplicate crediting or debiting of any order or payout request.
- Atomic Balance Locking: All balance checks and payout requests lock ledger records during processing to prevent concurrent withdrawal attempts.