Pricing plans
Commercial packages that map to tenant ledger fees: percent of USD, fixed USD per completed payment, and a VES reserve held back from available balance.
What these plans are
Plans are commercial packages applied to a tenant’s fee settings: feePercent, feeFixedUsd, and reserveVes. They are not selected by an API field on each payment.
Plan comparison
| Plan | feePercent | feeFixedUsd | Reserve |
|---|---|---|---|
| Starter | 2.5% | $0.15 | Higher (configured per tenant) |
| Growth | 2.0% | $0.10 | Medium (configured per tenant) |
| Volume | 1.5% | $0.05 | Based on rolling volume (ops-set) |
How available balance is affected
- Credit the collection
On payment.completed, the ledger posts PAYMENT_CREDIT for vesAmount.
- Debit the platform fee
PLATFORM_FEE posts −feeVes from the plan’s percent + fixed USD converted at bcvRate.
- Hold the reserve
Available balance subtracts reserveVes as a safety buffer. It is not a separate ledger entry type — it is applied when reading balance.
Choosing a plan
| Plan | Best for |
|---|---|
| Starter | New tenants ramping up; higher fee + higher reserve |
| Growth | Steady volume; mid fee and medium reserve |
| Volume | High throughput; lowest listed fees with reserve tied to rolling volume |
Configuration
Ops (or dashboard admins) set feePercent, feeFixedUsd, and reserveVes on the tenant. There is no checkout-time plan picker on payment APIs.
- Dashboard → Tenants → Fees: view and update feePercent, feeFixedUsd, reserveVes, and available balance.
- Marketplace seller payouts remain separate: retain your product fee by paying sellers less than you collected. See /marketplace-settlement.
- Importable collect → payout walkthrough: /postman.