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.

Info

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.