> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Repassar a tarifa de venda ao comprador
> Acrescente ao total a tarifa do meio de pagamento para preservar o valor líquido da venda em cobranças avulsas.
Ao **repassar a tarifa de venda**, o comprador paga o valor do produto ou
serviço mais um acréscimo calculado pela Chargefy. A organização recebe o valor
integral definido para a venda, sem precisar manter preços diferentes para Pix,
boleto, cartão à vista e cada quantidade de parcelas.
O acréscimo não é fixo. A Chargefy usa a tarifa aplicável ao meio escolhido,
calcula o menor total que preserva o valor da venda e atualiza a página antes da
confirmação.
O comprador sempre vê o total do meio de pagamento selecionado antes de
confirmar. Se trocar de Pix para cartão, boleto ou outra quantidade de
parcelas, o checkout recalcula o valor na hora.
## O que muda na cobrança
| Componente | Quem paga | O que representa |
| ---------------------- | ------------------------- | ---------------------------------------------------------------- |
| Valor da venda | Comprador | Preço do produto ou serviço definido por você. |
| Repasse da tarifa | Comprador, quando ativado | Acréscimo necessário para preservar o valor líquido da venda. |
| Juros de parcelamento | Comprador ou organização | Custo de dividir o cartão, conforme a configuração de parcelas. |
| Total | Comprador | Venda + repasse + juros de parcelamento, quando houver. |
| Líquido da organização | Organização | Valor da venda preservado depois da tarifa coberta pelo repasse. |
Sem repasse, a organização absorve a tarifa. Com repasse, a Chargefy adiciona
um valor suficiente para que a própria tarifa, calculada sobre o novo total,
também seja coberta.
## Por que não basta somar a tarifa nominal
A tarifa percentual incide sobre o total cobrado, não apenas sobre o preço
original. Por isso, uma venda de R$ 100,00 com tarifa ilustrativa de **2,72% +
R$ 2,00\*\* não pode simplesmente receber R\$ 4,72 de acréscimo.
| Etapa | Cálculo | Resultado |
| ---------------------------------------- | -------------------------------------- | ---------: |
| Valor que a organização quer receber | — | R\$ 100,00 |
| Soma simples da tarifa sobre R\$ 100,00 | R$ 100,00 + R$ 2,72 + R\$ 2,00 | R\$ 104,72 |
| Tarifa que incidiria sobre R\$ 104,72 | 2,72% de R$ 104,72 + R$ 2,00 | R\$ 4,85 |
| Líquido com a soma simples | R$ 104,72 − R$ 4,85 | R\$ 99,87 |
| Total calculado por dentro pela Chargefy | menor total que cobre a própria tarifa | R\$ 104,85 |
| Líquido final | R$ 104,85 − R$ 4,85 | R\$ 100,00 |
Em termos simples:
```text theme={"theme":"css-variables"}
total antes dos juros = (valor da venda + tarifa fixa) ÷ (1 − tarifa percentual)
repasse da tarifa = total antes dos juros − valor da venda
total cobrado = valor da venda + repasse da tarifa + juros de parcelamento
```
A Chargefy também ajusta o arredondamento em centavos. O comprador paga o menor
valor que mantém o líquido da organização igual ou acima do preço definido.
As taxas acima são apenas um exemplo matemático. O cálculo real usa a tabela
de tarifas da sua organização e o meio de pagamento escolhido. Consulte [Taxas
e custos](/business-model/fees) para entender sua configuração.
## Como cada meio é calculado
| Escolha do comprador | Regra aplicada | O que aparece na página |
| -------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------- |
| Pix | Tarifa de Pix da organização. | Total de Pix antes de gerar o QR Code. |
| Boleto | Tarifa de boleto da organização. | Total antes de emitir o boleto. |
| Cartão à vista | Tarifa de cartão para 1 parcela. | Total no seletor de parcelas e no resumo. |
| Cartão parcelado | Tarifa correspondente à quantidade de parcelas; depois, juros quando configurados. | Parcela, total e acréscimo conforme o Builder. |
No cartão parcelado, a ordem importa: primeiro a Chargefy preserva o valor da
venda com o repasse; depois calcula os juros de parcelamento sobre **valor da
venda + repasse**.
### Repasse da tarifa e juros são coisas diferentes
| Comparação | Repasse da tarifa | Juros de parcelamento |
| ---------------- | ------------------------------------------- | -------------------------------------- |
| Finalidade | Cobrir a tarifa da cobrança. | Cobrir o custo de dividir o pagamento. |
| Ativação | Por Checkout Session ou Payment Link. | No Checkout Builder da organização. |
| Varia por | Meio de pagamento e quantidade de parcelas. | Quantidade de parcelas. |
| Campo público | `has_surcharge` e `surcharge_amount`. | `installment_interest_amount`. |
| Ordem do cálculo | Antes dos juros. | Depois do repasse. |
## Ativar pelo Dashboard
Ao criar ou editar um Payment Link de cobrança avulsa, escolha o produto e
ative **Repassar taxa** em **Configurações**. O valor do catálogo continua sendo
o que a organização quer receber; o total do comprador é resolvido no checkout.
Selecione um preço sem recorrência. O repasse não está disponível para
assinaturas.
A opção fica na seção **Configurações** do Payment Link.
Abra o link e alterne entre Pix, boleto e cartão. Confira o total de cada
método e as opções de parcelamento antes de publicar.
## Ativar pela API
Envie `has_surcharge: true` ao criar uma Checkout Session ou um Payment Link.
O valor dos itens continua sendo o principal que a organização quer receber.
```json Checkout Session theme={"theme":"css-variables"}
{
"has_surcharge": true,
"line_items": [
{
"price_id": "price_7Dk3mP9qR2vL5xN8",
"quantity": 1
}
],
"metadata": {},
"success_url": "https://meusite.com/pedido/confirmado"
}
```
```json Payment Link theme={"theme":"css-variables"}
{
"has_surcharge": true,
"label": "Consultoria estratégica",
"line_items": [
{
"price_id": "price_7Dk3mP9qR2vL5xN8",
"quantity": 1
}
],
"metadata": {}
}
```
| Recurso | Campo | Quando o total é resolvido |
| ---------------- | --------------------- | ------------------------------------------------------------- |
| Checkout Session | `has_surcharge: true` | Ao abrir e confirmar a sessão, usando o método escolhido. |
| Payment Link | `has_surcharge: true` | Em cada clique, quando o link cria uma nova Checkout Session. |
| Payment Preview | `has_surcharge: true` | Imediatamente, sem criar, reservar ou cobrar nada. |
Repasse de tarifa vale somente para cobrança avulsa. Uma Checkout Session ou
um Payment Link com item recorrente e `has_surcharge: true` retorna `400`.
Assinaturas são cobradas pelo valor do ciclo, sem esse acréscimo.
## Consultar os totais antes de criar a cobrança
Use `POST /v1/payment-previews` quando seu backend precisa mostrar os valores de
Pix, boleto e cada opção do cartão antes de criar a cobrança. A prévia usa a
mesma tabela de tarifas do checkout e não persiste nenhum recurso.
```bash theme={"theme":"css-variables"}
curl -X POST "https://api.chargefy.io/v1/payment-previews" \
-H "Authorization: Bearer {{API_KEY}}" \
-H "Content-Type: application/json" \
-d '{
"amount": 2500,
"has_surcharge": true
}'
```
```json theme={"theme":"css-variables"}
{
"object": "payment_preview",
"amount": 2500,
"currency": "brl",
"has_surcharge": true,
"livemode": true,
"payment_methods": {
"boleto": {
"amount": 2700,
"surcharge_amount": 200
},
"credit_card": {
"installments": {
"max_count": 3,
"options": [
{
"amount": 2775,
"count": 1,
"installment_interest_amount": 0,
"per_installment_amount": 2775,
"surcharge_amount": 275
},
{
"amount": 2889,
"count": 2,
"installment_interest_amount": 105,
"per_installment_amount": 1445,
"surcharge_amount": 284
},
{
"amount": 2924,
"count": 3,
"installment_interest_amount": 140,
"per_installment_amount": 975,
"surcharge_amount": 284
}
]
}
},
"pix": {
"amount": 2613,
"surcharge_amount": 113
}
}
}
```
| Campo | Como interpretar |
| ----------------------------- | ------------------------------------------------------------ |
| `amount` | Valor principal que a organização quer receber, em centavos. |
| `payment_methods.*.amount` | Total que o comprador paga naquele método. |
| `surcharge_amount` | Parte do total usada para cobrir a tarifa. |
| `installment_interest_amount` | Juros adicionais daquela opção do cartão. |
| `per_installment_amount` | Valor exibido por parcela. |
Para cada opção do cartão, a relação é:
```text theme={"theme":"css-variables"}
amount da prévia + surcharge_amount + installment_interest_amount = amount da opção
```
O Payment Intent recalcula os valores no servidor ao confirmar. A prévia ajuda
a montar a interface, mas não substitui o total resolvido na cobrança.
## Transparência para o comprador
O preço não deve mudar depois que o comprador já confirmou. No checkout
hospedado, o resumo acompanha o método ativo e mostra o total final antes da
ação de pagar, gerar o Pix ou emitir o boleto.
Boas práticas:
* explique na oferta que o total pode variar conforme o meio e o prazo;
* deixe o comprador comparar os métodos antes de confirmar;
* mostre parcela e total no cartão, não apenas o valor mensal;
* evite anunciar um preço final único se sua política repassa tarifas
diferentes.
No Brasil, a [Lei nº
13.455/2017](https://www.planalto.gov.br/ccivil_03/_ato2015-2018/2017/lei/l13455.htm)
autoriza a diferenciação de preços conforme o prazo ou o instrumento de
pagamento. A comunicação da oferta e do total continua sujeita aos deveres de
informação aplicáveis à sua atividade.
Esta página explica o funcionamento da Chargefy e não substitui orientação
jurídica. Valide sua política de preços com seu jurídico ou contabilidade,
especialmente em setores, contratos ou canais com regras próprias.
## Quando faz sentido usar
Use o repasse quando:
* sua margem exige receber o valor integral definido para a venda;
* você oferece vários meios e não quer manter uma tabela manual de preços;
* o comprador pode escolher conscientemente entre custo e conveniência;
* sua comunicação deixa a diferença de preço clara antes da confirmação.
Evite quando sua estratégia depende do mesmo preço final em todos os meios ou
quando o canal de venda exige que a tarifa já esteja embutida no preço
anunciado.
## Próximos passos
Calcule Pix, boleto e parcelas sem criar uma cobrança.
Ative `has_surcharge` em uma página hospedada de cobrança avulsa.
Publique uma URL reutilizável que repassa a tarifa em cada compra.
Consulte tarifas por método e entenda o valor líquido da organização.