https://app.slimpay.com.br/api/v1. Cobranças, saldo, saques e webhooks.Taxas e liquidação
A taxa é calculada na criação da cobrança e nunca muda depois.
Composição da taxa
A taxa tem duas partes: um percentual sobre o valor e, opcionalmente, uma parcela fixa por transação. As duas são configuradas por conta e ficam visíveis no painel, em Taxas.
O percentual é expresso em basis points, onde 1 bps é 0,01%. Uma taxa de 2,49% corresponde a 249.
Como calculamos
Tudo é feito em aritmética inteira, sobre centavos, com arredondamento para o inteiro mais próximo. Não há ponto flutuante em nenhuma etapa do cálculo.
amount 14990 valor da cobrança
percentual 373 2,49% de 14990, arredondado
fixo 0 parcela fixa configurada
─────────────────
fee_amount 373
net_amount 14617 amount - fee_amount| Valor cobrado | Taxa | Você recebe |
|---|---|---|
| R$ 10,00 | R$ 0,25 | R$ 9,75 |
| R$ 149,90 | R$ 3,73 | R$ 146,17 |
| R$ 1.000,00 | R$ 24,90 | R$ 975,10 |
A taxa fica registrada na cobrança em fee_amount, e o valor líquido em net_amount. Se a sua taxa for renegociada, a mudança vale para cobranças criadas dali em diante — nada é recalculado retroativamente.
Prazo de liquidação
Um PIX pago cai na hora, mas o valor entra primeiro no saldo a liberar. O prazo até virar disponível é o D+n da sua conta, contado em dias corridos a partir da confirmação.
Numa conta em D+1, uma cobrança paga hoje fica disponível amanhã, no mesmo horário. Contas novas ou de setores com mais disputa costumam começar com prazo maior e reduzi-lo conforme o histórico.
Reserva de segurança
Além do prazo, pode haver um percentual retido de cada recebimento como reserva de segurança. Esse valor aparece como reserve no saldo e é liberado ao fim da janela de retenção, tipicamente 30 dias.
Reserva de 5% em D+1, sobre uma cobrança de R$ 1.000,00 com taxa de 2,49%: entram R$ 975,10 no saldo a liberar; no dia seguinte, R$ 926,34 ficam disponíveis e R$ 48,76 seguem em reserva por 30 dias. A reserva incide sobre o líquido, não sobre o bruto.
Onde consultar suas condições
Percentual, parcela fixa, D+n e reserva são específicos da sua conta. O painel mostra os valores vigentes.
Cada movimentação de taxa, reserva e liberação aparece como um lançamento no extrato, o que permite reconciliar centavo por centavo.