Fórmulas de cálculo de juros (Banco Central, dinâmica e PagSeguro)
O plugin oferece três formas diferentes de calcular o juros do parcelamento. Cada uma reflete um modelo de mercado real — escolha a que bate com o que seu gateway cobra.
1. Banco Central (juros compostos, padrão)
É o cálculo padrão do plugin. Aplica a mesma taxa mensal a todas as parcelas, mês a mês — a chamada fórmula da Tabela Price.
Configuração:
- Taxa de juros no parcelamento: taxa mensal em % (ex:
1.99para 1,99% ao mês). - Usar tabela dinâmica: desmarcado.
- Parcelamento via PagSeguro: desmarcado.
Fórmula:
Parcela = Total × r × (1 + r)^n / ((1 + r)^n − 1)
Onde r = taxa mensal (decimal) e n = número de parcelas.
Quando usar: funciona pra Stone, Cielo, Mercado Pago e a maioria dos gateways brasileiros que seguem o modelo bancário tradicional.
2. Taxa dinâmica (taxa por parcela)
Alguns gateways (e estratégias comerciais) usam taxas diferentes pra cada quantidade de parcelas. Por exemplo: 1x = 0%, 2x = 1.5%, 3x = 3%, 4x = 4.5%, e por aí vai.
Configuração:
- Usar tabela dinâmica: marcado.
- Taxas de juros dinâmica: preencha a porcentagem total somada para cada parcela.
Fórmula:
Total ajustado = Total + (Total × Taxa% / 100)
Parcela = Total ajustado / Número de parcelas
Aqui a taxa não é mensal — é o multiplicador total que você quer somar ao preço.
Se preencher uma parcela com 0, ela aparece como sem juros, independente do que estiver em Parcelas sem juros. A tabela dinâmica tem prioridade.
Quando usar: quando seu gateway publica uma tabela tipo "1x = 0%, 3x = 3.5%, 6x = 7%, 12x = 15%" e você quer espelhar exatamente.
3. PagSeguro (multiplicador total)
O PagSeguro usa um modelo próprio: aplica um único multiplicador no total e divide igualmente entre as parcelas.
Configuração:
- Parcelamento via PagSeguro: marcado.
- Taxa de juros no parcelamento: o multiplicador total em % (ex:
4para 4% somados ao total).
Fórmula:
Total ajustado = Total × (1 + Taxa% / 100)
Parcela = Total ajustado / Número de parcelas
Quando usar: se você vende usando PagSeguro como gateway principal e quer que o que aparece na vitrine seja igual ao que o cliente vai ver na hora do checkout.
Comparativo rápido
| Modelo | Taxa | Modelo de soma |
|---|---|---|
| Banco Central | Mensal (%) | Juros compostos por mês |
| Taxa dinâmica | Total por parcela (%) | Taxa fixa somada ao total |
| PagSeguro | Total único (%) | Multiplicador único sobre o total |
Casos especiais
Tudo sem juros
Configure Parcelas sem juros igual a Máximo de parcelas. Nenhuma fórmula vai entrar em ação porque nenhuma parcela tem juros.
Parcela mínima ignorando o que a fórmula diz
A configuração Parcela mínima é um corte de baixo: se a fórmula geraria parcelas de R$ 2,00 mas o mínimo é R$ 10, o plugin para de oferecer mais parcelas naquele ponto.
Limitar a tabela dinâmica visível
Por padrão, a tabela dinâmica mostra todas as parcelas configuradas. Se quiser limitar (ex: só até 6x), use o filtro wcsp_dynamic_installments_limit — veja Referência de hooks.