Fitnos
Para o dono

Taxas, formas de pagamento e conexão do gateway

Como o dinheiro entra no Fitnos: os métodos aceitos na venda, o cadastro das taxas da operadora pra enxergar receita líquida e a conexão com o Mercado Pago.

7 min de leituraAtualizado em

Tem três coisas diferentes aqui que costumam ser confundidas numa só. Vale separar antes de mexer em qualquer tela:

  • Método de pagamento — como o aluno pagou. É escolhido na venda e existe desde sempre, sem configurar nada.
  • Taxas de recebimento — quanto a operadora fica de cada transação. É o que transforma receita bruta em líquida no relatório.
  • Gateway de pagamento — a integração que faz a cobrança sair de dentro do Fitnos, em vez de você cobrar por fora e lançar no sistema depois.

Dá pra rodar a academia inteira só com o primeiro. Os outros dois são melhoria, não pré-requisito.

Os métodos aceitos na venda

Toda venda registra um método: Pix, Dinheiro, Cartão de Crédito, Cartão de Débito, Boleto ou Outro. A lista é fixa e não se configura — ela é a mesma em toda a base pra que o relatório consiga somar por método sem depender de cada academia ter digitado o mesmo nome.

A venda também aceita de 1 a 12 parcelas, com a data de vencimento da primeira. As parcelas seguintes são geradas a partir dela, e cada uma vira uma linha que a recepção baixa quando o dinheiro entra.

Método é o que aconteceu, não o que vai acontecer

Escolher "Pix" na venda não dispara cobrança nenhuma por si só — é registro. Quem dispara cobrança de verdade é o gateway, e só quando ele está conectado.

Taxas de recebimento

Aqui você cadastra o que a sua maquininha ou operadora cobra. Sem isso, o painel enxerga só o valor bruto — e receita bruta de academia que vende muito no cartão é um número que engana.

No painel
ConfiguraçõesVendas e pagamentosTaxas de recebimento

Cada regra é uma combinação de método, faixa de parcelas e vigência:

  1. Escolha o âmbito

    Global vale pra academia toda. Regra criada pra uma unidade específica tem prioridade sobre a global — é como se registra a unidade que negociou taxa melhor com a operadora.

  2. Método e operadora

    A operadora é texto livre, só pra você se lembrar de onde veio aquele número ("Stone", "Cielo"). Quem realmente casa a regra com o pagamento é o método.

  3. Faixa de parcelas

    De 1 a 12. Cartão costuma ter taxa diferente à vista e parcelado, e é assim que se representa isso: uma regra de 1x a 1x, outra de 2x a 6x, outra de 7x a 12x.

  4. MDR e taxa fixa

    MDR é o percentual sobre o valor da transação. Taxa fixa é o valor em reais cobrado por transação, independente do tamanho dela — os R$ 0,30 de Pix, por exemplo.

  5. Vigência

    Válido a partir é obrigatório; válido até é opcional. Quando a operadora renegociar a taxa, não edite a regra antiga: feche ela com a data de fim e crie a nova. É o que mantém o histórico calculando com a taxa que valia na época.

A partir daí, cada parcela baixada guarda quanto foi de taxa e quanto sobrou de líquido. É esse líquido que aparece no relatório de resultado, unidade por unidade.

A taxa é aplicada no momento em que o pagamento é baixado

O valor da taxa é gravado na parcela quando ela é marcada como paga, com a regra vigente naquele dia. Cadastrar as taxas depois não recalcula o que já foi recebido — se você está começando agora, vale cadastrar antes de rodar o primeiro mês.

Sobre a taxa de antecipação

O campo existe e guarda o percentual mensal que a operadora cobra pra adiantar recebível de cartão parcelado. Hoje ele é registro de referência: o líquido de cada parcela é calculado com MDR mais taxa fixa. Se você antecipa muito, considere esse custo à parte na hora de fechar o mês.

Conectar o gateway

Com o gateway conectado, a cobrança sai do próprio Fitnos: o aluno paga e a parcela é baixada sozinha, sem alguém no balcão conferir extrato e marcar na mão. O provedor suportado é o Mercado Pago, e a conta é sua — o Fitnos usa suas credenciais pra cobrar em seu nome, o dinheiro nunca passa por nós.

No painel
ConfiguraçõesVendas e pagamentosGateway de pagamento
  1. Crie uma aplicação no painel de desenvolvedor do Mercado Pago

    É de lá que saem as credenciais. Use as de produção quando for cobrar de verdade — as de teste começam com TEST e não movimentam dinheiro.

  2. Escolha Mercado Pago como provedor

    A opção Manual, que é o padrão, significa "sem gateway": cobrança por fora e baixa manual no painel.

  3. Cole o Access Token e a Public Key

    O Access Token é secreto e fica guardado cifrado — depois de salvo, o painel só mostra que existe, nunca o valor de volta.

  4. Cole o Webhook Secret

    É a assinatura que o Mercado Pago usa pra provar que o aviso de pagamento veio mesmo dele. Sem ela, a confirmação automática da parcela não é aceita.

Conectado, cada método funciona de um jeito:

  • Pix é cobrado direto pela API, com o QR Code aparecendo dentro do Fitnos — o aluno não sai da tela.
  • Cartão e boleto vão por link de pagamento do Mercado Pago (Checkout Pro).

Só vale pra venda em 1 parcela

Venda parcelada continua com cobrança manual, mesmo com o gateway ligado. Se você vende muito em 3x e esperava a cobrança automática de todas as parcelas, esse é o limite atual — vale saber antes de montar a operação em cima disso.

Rede com várias unidades

A configuração da rede é o padrão de todas as unidades. Se alguma unidade tem CNPJ e conta própria, dá pra configurar o gateway só dela, e essa configuração vence a da rede. O botão de remover a configuração específica faz a unidade voltar a herdar a da rede.

Quem configura

Gateway e taxas são de dono e gerente. Recepção e professor não abrem essas telas.

Em que ordem fazer

Se você está montando a academia agora, a sequência que evita retrabalho é: cadastrar as taxas antes da primeira venda, rodar um mês cobrando do jeito que você já cobra hoje e só então decidir se o gateway compensa. Integração de pagamento no meio de uma migração de base é o tipo de coisa que dobra o número de variáveis quando algo dá errado.