Pular para o conteúdo

Merchants

O parceiro cadastra lojas no console, em Merchants. Cada loja tem nome, wallet TON e uma taxa. O admin precisa ligar o recurso na conta (merchants_allowed).

A taxa da loja não fica abaixo do spread TonRamp do parceiro (piso 0,8%–2,0%). Em branco, a loja herda o piso.

Mesmo no piso o parceiro ganha: uma participação no spread (padrão 30%, negociada no admin, teto 50%). Markup acima do piso é 100% dele. A taxa fixa continua 100% TonRamp.

Destino O que recebe
Wallet da loja o amount
Wallet do parceiro amount × (piso × participação + markup)
TonRamp o restante do piso + taxa fixa − custos

O dashboard do console mostra Sua comissão separado do volume das lojas.

POST /v1/wallet/trp/generate aceita merchant_id da loja ativa. Sem esse campo, o payload continua na wallet do parceiro (caminho 1:1).

A wallet do body, se enviada, precisa ser a do parceiro ou a da loja ativa dele. Wallet de terceiro continua 403.

O checkout PIX POST /v1/c também aceita merchant_id. O USDT do amount cai na wallet da loja.