Repassar a tarifa de venda ao comprador

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:

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 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.

Dashboard da Chargefy criando um Payment Link com a opção Repassar taxa ativada e preview do checkout — Criação de um Payment Link com Repassar taxa ativado e a página hospedada aberta ao lado para conferência.

Escolha uma cobrança avulsa

Selecione um preço sem recorrência. O repasse não está disponível para assinaturas.

Ative Repassar taxa

A opção fica na seção Configurações do Payment Link.

Salve e teste os métodos

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.

Checkout Session

{
  "has_surcharge": true,
  "line_items": [
    {
      "price_id": "price_7Dk3mP9qR2vL5xN8",
      "quantity": 1
    }
  ],
  "metadata": {},
  "success_url": "https://meusite.com/pedido/confirmado"
}

Payment Link

{
  "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.

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
  }'

{
  "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 é:

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 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

Criar uma prévia de pagamento

Calcule Pix, boleto e parcelas sem criar uma cobrança.

Criar uma Checkout Session

Ative has_surcharge em uma página hospedada de cobrança avulsa.

Criar um Payment Link

Publique uma URL reutilizável que repassa a tarifa em cada compra.

Taxas e custos

Consulte tarifas por método e entenda o valor líquido da organização.

Pagamentos online

Integrações avançadas

Payment Intents e cobranças

Formas de pagamento

Customers

Faturas

Assinaturas

Operação financeira

Repassar a tarifa de venda ao comprador

O que muda na cobrança

Por que não basta somar a tarifa nominal

Como cada meio é calculado

Repasse da tarifa e juros são coisas diferentes

Ativar pelo Dashboard

Ativar pela API

Consultar os totais antes de criar a cobrança

Transparência para o comprador

Quando faz sentido usar

Próximos passos

Criar uma prévia de pagamento

Criar uma Checkout Session

Criar um Payment Link

Taxas e custos

​O que muda na cobrança

​Por que não basta somar a tarifa nominal

​Como cada meio é calculado

​Repasse da tarifa e juros são coisas diferentes

​Ativar pelo Dashboard

​Ativar pela API

​Consultar os totais antes de criar a cobrança

​Transparência para o comprador

​Quando faz sentido usar

​Próximos passos

Criar uma prévia de pagamento

Criar uma Checkout Session

Criar um Payment Link

Taxas e custos

O que muda na cobrança

Por que não basta somar a tarifa nominal

Como cada meio é calculado

Repasse da tarifa e juros são coisas diferentes

Ativar pelo Dashboard

Ativar pela API

Consultar os totais antes de criar a cobrança

Transparência para o comprador

Quando faz sentido usar

Próximos passos