← Administração da Conta

Administração da Conta · Integrações

Integração PrincipiaPay

Equipe administrativa Leitura de 3 minutos Onde: Menu › Integrações › PrincipiaPay

O que muda na prática

Sem uma integração de pagamento, a escola emite cobrança por fora e alguém precisa conferir o extrato e dar baixa manualmente em cada receita.

Com o PrincipiaPay, a fatura é registrada, o pagamento é reconhecido e a baixa acontece sem digitação. O status no banco da fatura passa a refletir o que o provedor informa.

Como é a conexão

Diferente das integrações de credencial, esta é um cadastro com análise. Você não cola um token: você abre uma conta, e o provedor precisa aprovar.

O processo tem três etapas:

  1. Dados básicos

    Os dados da instituição e da conta que será aberta, mais o nome da integração.

  2. Representantes

    As pessoas que respondem pela escola. Para cada uma:

    CampoO que informar
    Nome completo e nome socialComo consta no documento, e o nome de uso.
    CPF e data de nascimento
    Nome da mãeExigido na verificação de identidade.
    Tipo de vínculoSócio administrador, Demais sócios ou Representante legal.
    E-mail e celularContatos da pessoa.
    Endereço completoCEP, logradouro, número, complemento, bairro, cidade e estado.
  3. Termos de uso e documentos

    Aceite dos termos e envio da documentação pedida.

    a conexão não fica pronta na hora.

    O cadastro vai para análise do provedor. Planeje a virada com folga — abrir a conta na semana da primeira cobrança do ano é receita para atrasar o boleto de todo mundo.

Acompanhar a proposta depois de enviada

Abra a integração em minhas integrações e clique no lápis. A tela abre sempre — o que muda é se ela vem editável ou só para leitura.

A conexão está…A tela abre
Inativa, proposta ainda não enviadaEditável — corrija o que precisar
Inativa, proposta reprovadaEditável — é assim que se corrige e reenvia
Enviada, em análise, ou já aprovadaSomente leitura — consulta, sem alterar

A aba Documentos

Além das três etapas do cadastro, a tela em modo de edição tem uma aba Documentos com o que os sócios enviaram na proposta. Cada arquivo aparece com pré-visualização e um botão Baixar documento.

Se ninguém enviou nada ainda, a aba mostra "Os sócios ainda não enviaram documentos nesta proposta" — isso é estado normal de proposta recém-criada, não erro.

proposta reprovada não se reativa no botão.

O sistema inativa a conexão quando o provedor reprova, e bloqueia ligá-la de volta manualmente enquanto o onboarding não for aprovado. A reprovação pode chegar em qualquer fase da análise — cadastro, verificação de antecedentes ou conferência de documentos. O caminho é corrigir o que foi apontado e reenviar.

Depois de aprovado

  1. A conta aparece em Financeiro › Contas, com o campo de conexão preenchido.
  2. Aponte o modelo de fatura para essa conta.
  3. Emita um lote pequeno de teste antes do lote do mês.
conta com conexão inativa não entra em modelo de fatura.

O sistema recusa o vínculo com a mensagem "A integração desta conta não está ativa. Reative a conexão antes de vinculá-la a um modelo de fatura." Reative a conexão primeiro.

Perguntas frequentes

As faturas continuam dando erro depois de conectar.

O modelo de fatura precisa apontar para a conta que tem a conexão. É o esquecimento mais comum.

Quem deve ser cadastrado como representante?

Quem tem poderes para responder pela pessoa jurídica — normalmente sócio administrador ou representante legal com procuração.

A escola tem duas unidades com CNPJ diferente.

Uma conexão para cada, com o cadastro da respectiva pessoa jurídica.

Dá para usar junto com a Cielo?

Sim. PrincipiaPay cuida do boleto e da conciliação; Cielo cuida do cartão.

Continue