Merchants
The partner registers stores in the console, under Merchants. Each store has a name, a TON wallet, and a fee. An admin must enable the feature on the account (merchants_allowed).
Who earns what
Section titled “Who earns what”The store fee cannot go below the partner’s TonRamp spread (floor 0.8%–2.0%). Blank inherits the floor.
Even at the floor the partner earns: a share of the spread (default 30%, negotiated in admin, cap 50%). Markup above the floor is 100% theirs. The fixed fee stays 100% TonRamp.
| Destination | What it receives |
|---|---|
| Store wallet | the amount |
| Partner wallet | amount × (floor × share + markup) |
| TonRamp | the rest of the floor + fixed fee − costs |
The console dashboard shows Your commission separately from store volume.
Generate with merchant_id
Section titled “Generate with merchant_id”POST /v1/wallet/trp/generate accepts merchant_id of an active store. Without it, the payload still uses the partner wallet (1:1 path).
If the body sends a wallet, it must be the partner’s or an active store of that partner. A third-party wallet is still 403.
PIX checkout POST /v1/c also accepts merchant_id. The amount in USDT goes to the store wallet.