Gateways de pagamento
Os gateways emitem os boletos, cobranças Pix e transações de cartão das mensalidades. Cada um tem sua tela de configuração, aberta pelo botão Configurar em Integrações. Todas exigem usuário conectado ao sistema administrativo.
Pontos comuns às três telas:
- O cabeçalho mostra o status: Configurado / Não configurado (e, no Asaas, Ambiente de testes quando o sandbox está marcado). O botão Integrações volta à vitrine.
- Um quadro "Como funciona a integração" resume os passos na própria tela.
- As chaves de acesso são como senhas: ficam ocultas na tela (botão de olho para exibir) e não devem ser compartilhadas. Este manual nunca documenta valores de chaves.
- Após salvar, a tela recarrega mostrando o estado real gravado.
:::info Regra do sistema Salvar as credenciais não ativa o gateway sozinho: o gateway em uso é o selecionado no campo Gateway de Pagamentos da tela Configurações de Pagamentos do módulo Financeiro (veja Financeiro). :::
Asaas
Onde: Integrações → cartão Asaas → Configurar.
Quem pode usar: administradores.
Para que serve
Conecta a conta Asaas da escola ("Gateway de pagamento — boletos, Pix e cartão de crédito"). O diferencial do Asaas: ao salvar a chave, o sistema importa automaticamente as taxas do contrato da escola (boleto, Pix e cartão por número de parcelas) e as usa para calcular o valor líquido na conciliação financeira.
Campos
| Campo | O que é | Obrigatório | Observações |
|---|---|---|---|
| Access Token | Chave de API da conta Asaas | Sim | No painel do Asaas: menu do usuário → Integrações → Chave de API. Trate como senha |
| Sandbox | Usa o ambiente de testes do Asaas | Não | Marque apenas para testes — cobranças de teste não geram pagamento real |
| Taxa Boleto R$ | Taxa fixa por boleto | — | Somente leitura; importada do Asaas |
| Taxa PIX R$ | Taxa fixa por Pix | — | Somente leitura; importada do Asaas |
| Taxa Transação Cartão R$ | Taxa fixa por transação de cartão | — | Somente leitura |
| Cartão de crédito — % por quantidade de parcelas | Percentual da taxa para 1x a 12x | — | Somente leitura; importado do Asaas |
Ações
| Ação | O que faz |
|---|---|
| Salvar e importar taxas / Salvar e atualizar taxas | Grava a chave e consulta as taxas do contrato no Asaas |
Passo a passo
- No painel do Asaas, copie a chave de API da conta da escola.
- Cole em Access Token. Deixe Sandbox desmarcado em produção.
- Clique em Salvar e importar taxas. Com sucesso, aparece "Configurações salvas e taxas importadas do Asaas!" e a seção "Taxas do seu contrato" é preenchida.
- Para atualizar as taxas depois de renegociar o contrato, basta abrir a tela e salvar novamente.
Problemas comuns
- "A chave foi salva, mas não foi possível consultar as taxas no Asaas. Confira se a chave de API está correta e se o ambiente (produção/sandbox) confere." — a chave gravou, mas a consulta de taxas falhou. Causas típicas: chave digitada errada, chave de produção com Sandbox marcado (ou vice-versa). Corrija e salve de novo.
- "O campo Access Token é obrigatório" — a chave não foi informada; sem ela nada é salvo (proteção para não apagar uma chave funcionando).
Zoop
Onde: Integrações → cartão Zoop → Configurar.
Quem pode usar: administradores.
Para que serve
Conecta a conta Zoop da escola. Diferente do Asaas, as taxas do contrato são digitadas manualmente — informe os valores do seu credenciamento para que a conciliação calcule o valor líquido corretamente.
Campos
| Campo | O que é | Obrigatório | Observações |
|---|---|---|---|
| ID do Marketplace | Identificador do marketplace no credenciamento Zoop | Sim | Fornecido pela Zoop |
| ID do Seller | Identificador do vendedor (a escola) | Sim | Fornecido pela Zoop |
| Chave de API | Chave de acesso da conta | Sim | Trate como senha |
| Nome na Fatura | Texto exibido na fatura do cartão do pagador | Sim | Use um nome que a família reconheça |
| URL da Logo do Boleto | Endereço da imagem impressa no boleto | Não | |
| Taxa Boleto R$ / Taxa Boleto % | Taxas do boleto no seu contrato | Não | Digitadas manualmente |
| Taxa PIX R$ / Taxa PIX % | Taxas do Pix | Não | Digitadas manualmente |
| Taxa Transação Cartão R$ | Taxa fixa por transação de cartão | Não | |
| Cartão de crédito — % por quantidade de parcelas | Percentual para 1x a 12x | Não | Digitados manualmente |
Ações
| Ação | O que faz |
|---|---|
| Salvar configurações | Grava credenciais e taxas; aparece "Configurações salvas com sucesso!" |
Problemas comuns
- "O campo ... é obrigatório" — os quatro campos de credenciais/fatura são obrigatórios; um envio incompleto não é salvo (proteção contra apagar credenciais funcionando).
Pagar.me
Onde: Integrações → cartão Pagar.me → Configurar.
Quem pode usar: administradores.
Para que serve
Conecta a conta Pagar.me da escola para emissão de boletos, Pix e cartão.
Campos
| Campo | O que é | Obrigatório | Observações |
|---|---|---|---|
| Secret Key | Chave secreta da conta Pagar.me | Sim | No painel do Pagar.me: Configurações → Chaves (a chave começa com "sk_"). Trate como senha |
| Texto exibido na fatura do cartão | Como a cobrança aparece na fatura do pagador | Não |
Ações
| Ação | O que faz |
|---|---|
| Salvar configurações | Grava as configurações; aparece "Configurações salvas com sucesso!" |
Problemas comuns
- "O campo Secret Key é obrigatório" — a chave não foi informada; nada é salvo sem ela.
TODO: VALIDATE— o Pagar.me não possui confirmação automática de pagamento neste sistema; confirme com o suporte o procedimento de conciliação antes de adotá-lo como gateway principal.