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"