Referência
Taxas
Modelo de taxas: max(1%, piso de 0,10 unidade do token), caps fixados on-chain, split com afiliados e garantia de saldo zero.
Na consulta à API oficial em 8 de novembro de 2026, a taxa informada era 1% com piso de 0,10 unidade do token. Os valores podem variar por ambiente; consulte GET /api/crypto/v1/fees e os dados da ordem para conhecer os valores aplicáveis. Nada é
deduzido "depois": a taxa sai no mesmo pagamento, pelo contrato.
A fórmula
taxa = max(valor × percentual configurado, piso configurado)
- Em ticket grande, a taxa é 1%;
- Em ticket pequeno, o piso de 0,10 unidade do token garante que a taxa cubra o processamento;
- A taxa nunca pode superar o valor do pedido — o lojista jamais fica negativo.
Caps fixados on-chain
Os limites de ajuste estão gravados no contrato e são iguais em todas as redes:
| Parâmetro | Valor máximo |
|---|---|
| Percentual de taxa | 10% |
| Piso de taxa | 5 USDT |
A taxa corrente é ajustável pelo owner dentro dos caps — nunca além
deles. Na resposta da API, a taxa corrente aparece como feeBps (basis
points; 100 bps = 1%).
Split multi-destinatários
O split aceita o lojista mais até 10 afiliados na mesma transação:
- Cada destinatário recebe sua fração líquida de taxa na hora;
- O arredondamento favorece o lojista: qualquer resto de centavo (rounding dust) vai para a carteira do lojista, não para a Caedral;
- Comissões de afiliados são definidas na criação da ordem, dentro do
wallet.affiliates.
Overpayment e underpayment
| Situação | Comportamento do contrato |
|---|---|
| Cliente enviou a mais | Devolve o excedente na mesma transação |
| Cliente enviou a menos | Reverte integralmente — nada fica retido |
| Valor exato | Split executa e liquida |
Garantia de saldo zero
O contrato termina toda execução com saldo zero: cada centavo entra e
sai na mesma transação. Isso é comprovado pelos testes fuzz (256 execuções
aleatórias) que verificam address(contract).balance == 0 ao final de cada
run, e por auditoria de saldos on-chain após pagamentos reais.
A taxa corrente e os caps podem ser lidos direto do contrato em qualquer explorer — a verdade sempre está on-chain, não nesta página.