Formas de cobrança e adquirentes

Onde fica: Configurações → Adquirentes

A tela abre respondendo uma pergunta só — o topo diz "Você já pode cobrar seus alunos" ou "Nenhum adquirente conectado" — e desce em quatro blocos, nesta ordem: Adquirentes (quem processa), Cobrança (gateway padrão e métodos do checkout), Pagamento recebido por fora e Régua de recebimento (quando o dinheiro entra). Taxas e Conta Stripe só aparecem com a Stripe ativa.

Sem adquirente conectada não existe cobrança online: recorrência, link de pagamento, Pix e boleto dependem dela — matrícula paga só pode ser registrada como pagamento recebido por fora.

Qual adquirente escolher

São quatro linhas independentes, e mais de uma pode ficar ligada ao mesmo tempo. As três primeiras cobram online; a quarta é o terminal físico.

Stripe

Conexão pelo fluxo guiado da própria tela — não há chave para colar. O cadastro (dados da empresa, conta bancária, documentos) acontece dentro do onboarding da Stripe; enquanto ele não termina, a linha mostra o que ainda falta.

• Antes de conectar, a linha mostra as taxas públicas de referência da Stripe BR: cartão 2,20% + R$ 0,05, Pix 0,30%, boleto R$ 3,00.
• Cartão e carteiras digitais são geridos no Dashboard da Stripe, não aqui. Pix e boleto à vista você liga no OctaGym, que ativa o método na sua conta.
• Os métodos aceitos seguem o país da sua conta, não o da plataforma: conta brasileira continua com Pix e boleto.
• Saldo e repasses aparecem dentro do OctaGym (saldo disponível e histórico de transferências) — nenhuma outra adquirente tem esse painel embutido. Em conta Enterprise o acompanhamento é pelo dashboard da própria Stripe.
• Contas Enterprise negociam a taxa direto com a Stripe: aparece o botão Taxas negociadas para informar os valores, porque o OctaGym não conhece o contrato. Nos demais planos vale o acordo OctaGym↔Stripe, a linha mostra a taxa efetiva e não há o que preencher.

Quando o dinheiro cai na conta. No Brasil o repasse da Stripe é diário — agenda semanal ou mensal não existe por lá —, e cada pagamento entra no primeiro repasse depois de ficar disponível. Repasse que cairia no fim de semana vai para o próximo dia útil.

O prazo é contado em dias corridos a partir do processamento do pagamento — não da matrícula nem do vencimento do título.

Fonte: Cronograma de repasses e disponibilidade de pagamentos no Brasil, na central da Stripe.

Stone / Pagar.me

Conexão por credencial: Secret Key (sk_…), Public Key (pk_…) e Account ID (acc_…). Chave sk_test_… conecta em ambiente de teste — a linha fica marcada como sandbox e não movimenta dinheiro real.

• É o caminho para Elo, Hipercard e Amex e para o parcelamento nacional.
• As taxas são digitadas à mão (crédito, débito, Pix, boleto). Não é burocracia nossa: essa conta não expõe o custo por venda pela API. Sem preencher, a DRE lança zero de custo de cartão — e zero é indistinguível de "de graça" para quem só olha o resultado.
• Antes de ligar o Pix à vista, habilite o Pix no painel da Pagar.me (Configurações → Meios de pagamento). O OctaGym não cria o método por você.
• O segredo do webhook é opcional: sem ele pagamentos e recusas continuam sendo processados (cada evento é conferido direto na API). Configurar destrava o tratamento automático de estorno, chargeback, cancelamento feito no painel da Pagar.me e antifraude. O mesmo valor precisa ser colado lá, em Webhooks → Habilitar autenticação.

Vindi

Conexão por chave de API e chave pública, com escolha de ambiente.

• A lista de métodos vem da sua conta Vindi — quem define o código de cada método é o painel dela. Ativou um método novo lá? Reconecte a Vindi aqui para o OctaGym reler a lista.
• A API dela não expõe a taxa, então o custo por venda é informado na régua de recebimento (abaixo), não numa aba própria.
• "Assumir a cobrança" aparece só para quem veio de ERP legado (EVO, Pacto) com a carteira já na Vindi: o cartão dos alunos continua onde está e a virada muda apenas quem dá a ordem de cobrar. São três etapas — vincular alunos, agendar as cobranças e ligar —, cada uma com simulação antes de aplicar. Para quem nasceu no OctaGym a seção não existe. → Migrar de outro sistema

Maquininha Stone

Ativação com Account ID, StoneCode, Public Key e Secret Key. Com terminais ativos na Unidade, a matrícula e o PDV enviam a cobrança direto para a maquininha, e a tela acompanha o estado (Aguardando pagamento na maquininha, Pagamento confirmado pela Stone), com reenviar ou cancelar o pedido.

Os terminais são cadastrados em Loja → Terminais. É uma linha separada da Stone/Pagar.me online: conectar uma não conecta a outra.

Gateway padrão

A escolha só aparece quando Stripe e Stone/Pagar.me estão prontos ao mesmo tempo — com um adquirente só não há o que decidir, e a Vindi não entra nessa preferência.

O padrão vale para as novas cobranças. A recepção ainda pode escolher o outro adquirente por matrícula, e cobrança já em andamento continua no gateway em que nasceu.

O que cada método suporta

O quadro de meios do checkout, dentro do bloco Cobrança, lista Stripe, Stone / Pagar.me e Vindi — nesta última só os métodos que a sua conta tem ativos. Nem todo método serve para todo tipo de plano, e a tela troca o botão pelo motivo quando a combinação não existe:

• Pix não debita sozinho nos ciclos seguintes de uma assinatura — a regra vale nos três adquirentes online.
• Boleto recorrente o OctaGym monta na Vindi (um por período), não na Pagar.me.
• Carteira digital emite token de uso único: não renova, e na Pagar.me também não parcela.
• Pix e boleto são pagamento integral — descaracterizam o parcelamento.

Onde cada taxa é informada

Cada adquirente tem uma casa só — a tela nunca pede a mesma taxa duas vezes:

Régua de recebimento

Em quantos dias cada meio de pagamento cai na conta, por adquirente. A mesma academia cobra crédito pela Stripe, pela Pagar.me e pela maquininha com contrato diferente em cada uma; projetar as três com um prazo só erra o líquido em pontos percentuais.

• A seção aparece sempre, mesmo sem nenhum adquirente online conectado — dinheiro, Pix na chave e maquininha de terceiro também precisam de previsão.
• Onde o adquirente já tem tela de taxa (Stripe, Pagar.me), aqui entra só o prazo.
• Par desligado não é prazo zero: ele sai da projeção, e o faturamento dele aparece separado na Conciliação.
• Os prazos que a tela sugere são de mercado, não os da sua conta. Na Stripe BR, Pix e boleto liberam em D+2 (a sugestão é D+0 e D+1) e cartão nacional em D+30. Conferir antes de salvar é o que impede o fluxo de caixa de prometer dinheiro dois dias antes de ele existir.

Pagamento recebido por fora

A política Pagamento recebido por fora define quem pode confirmar dinheiro que entrou sem passar pelo adquirente (dinheiro, Pix externo, outra maquininha):

Problemas comuns

• "Conectei e continua dizendo que não posso cobrar." Na Vindi, falta cadastrar o webhook no painel dela; na Stripe, o onboarding não foi concluído (a linha lista o que falta); na Pagar.me, as credenciais podem ter sido recusadas.
• "Está tudo verde, mas não entra dinheiro de verdade." A linha está em sandbox — chave de teste não movimenta dinheiro real. Troque pelas chaves de produção.
• "O aluno pagou e a matrícula não ativou." O webhook do adquirente pode ter falhado; confira o histórico de cobranças do aluno antes de cobrar de novo.
• "A cobrança recorrente não aconteceu." Ou o plano foi vendido como pagamento manual, sem cartão salvo, ou — na Pagar.me — a sua conta não tem Assinaturas habilitadas. Nesse segundo caso a linha da Pagar.me mostra o aviso "Assinaturas recusadas nesta conta": habilite Assinaturas no painel da Pagar.me (Configurações → Assinaturas) e volte aqui para clicar em Já habilitei — liberar venda.
• "A maquininha não aparece." Ela pertence a outra Unidade, ou a conexão da maquininha Stone ainda não foi concluída — ela é separada da Stone/Pagar.me online.
• "O Pix não aparece no checkout." Na Pagar.me, ele precisa ser habilitado antes no painel dela; na Vindi, o método precisa estar ativo na conta e a integração reconectada.

Relacionado

• Como o financeiro funciona
• Contas a receber
• Conciliação