docs
हिन्दी

इस पेज का अभी अनुवाद नहीं हुआ है, इसलिए यह अंग्रेज़ी में दिखाया गया है।

इस पेज पर

Fees and business info

How fees work

The platform fee is taken on-chain inside every sweep (from your invoice/customer addresses to your Hot Wallet); you never pay an invoice. The rate is marginal per business per fixed 30-day fee period (fees reset every 30 days in fixed cycles, e.g. Nov 3 → Dec 3 UTC; the dashboard and GET /v1/fees show the current cycle) and depends on the volume swept in that period:

period volume (USDT)rate
≤ 25,0001.0 %
≤ 100,0000.8 %
≤ 300,0000.6 %
≤ 1,000,0000.4 %
above0.3 %

Plus your operator's share (operator multiplier, see /v1/fees): at most 100% of the Polysia fee, so a business pays at most twice the Polysia fee in total (at most 2% of the volume). A deposit counts in the period in which it is swept, not received.

GET /v1/fees (scope business:read)

Reads the factory contract (cached 30 s; 503 chain_unavailable if the RPC fails):

{"object":"fees","fee_period":{"period":692,"start":"…","end":"…","swept_volume":"3.000000","polysia_fee":"0.030000",
 "next_rate_percent":"1","tiers":[…],"note":"…"},"operator_multiplier_percent":"50","pending_multiplier":null,
 "unswept":{"amount":"1.000000","estimated_polysia_fee":"0.010000","estimated_operator_fee":"0.005000","estimate":true}}

GET /v1/fees/quote?amount=250 (scope business:read)

Estimate for one more sweep of amount now (estimated_polysia_fee, estimated_operator_fee, estimated_net). The real fee depends on everything swept before it in the same period.

GET /v1/business (scope business:read)

Business name and on-chain id, network, chain_id, factory, token, Hot Wallet (active / pending), on-chain owner status, and invoice_settings (min_amount, max_amount, expiry_default_seconds, tolerances) — read the limits here before creating invoices.

curl -sS "$API/v1/business" -H "Authorization: Bearer $POLYSIA_API_KEY"