API de Assinatura para Educação: Matrículas, Rematrículas e EAD
Toda instituição de ensino conhece a cena: a temporada de matrículas — filas na secretaria, contratos impressos em três vias, responsáveis que "passam depois para assinar" e nunca passam. E toda edtech conhece a versão digital do problema: o checkbox de termos que não prova nada. Este guia mostra o fluxo completo via API para os três cenários do setor: matrícula com responsável assinando pelo celular, rematrícula em massa disparada pelo sistema acadêmico e aceites de EAD com evidência real.
Os documentos do setor e o nível certo de cada um
| Documento | Signatários | Nível recomendado |
|---|---|---|
| Contrato de matrícula | Responsável legal (+ responsável financeiro, se distinto) + instituição | Avançada (CLICK_PLUS_OTP) |
| Rematrícula / aditivo anual | Responsável financeiro | Avançada |
| Termos de uso da plataforma EAD | Aluno (ou responsável) | Simples com evidência (CLICK_ONLY) |
| Contrato de curso livre / pós | Aluno adulto | Avançada; biometria em valores altos |
| Autorizações (passeios, imagem, saída) | Responsável legal | Simples/avançada |
| Contratos com professores e fornecedores | Partes + testemunhas | Avançada; guia para autônomos |
A base jurídica é a geral dos contratos privados — MP 2.200-2/2001 e Lei 14.063/2020 — detalhada no mapa regulatório por setor. O ponto específico do setor é outro: quem assina.
Menor de idade: o envelope com dois responsáveis
Aluno menor não assina — assinam o responsável legal e, quando a escola separa os papéis, o responsável financeiro (que pode ser outra pessoa: avô, tio, ex-cônjuge). É o caso de manual para envelopes multi-signatário:
Com o owner definido, os convites saem por e-mail automaticamente; cada responsável assina pelo celular, sem instalar nada; e o evento ENVELOPE.ALL_SIGNED avisa o sistema acadêmico que a matrícula está completa. Precisando de ordem (financeiro só depois do legal), troque para SEQUENTIAL — a fila é imposta pela API.
Rematrícula em massa: a temporada sem fila
O fluxo que transforma a temporada: o sistema acadêmico itera os alunos aptos e, para cada um, gera o PDF do contrato (dados do aluno, série, valores) e cria a sessão — com X-Idempotency-Key por aluno + período letivo, para que o reprocessamento de um lote interrompido não duplique nada:
- Disparo: um job percorre os aptos e cria as sessões (o sandbox é o lugar de ensaiar o lote inteiro antes);
- Assinatura: convites por e-mail; responsáveis assinam de onde estiverem;
- Acompanhamento: webhooks atualizam o status por aluno em tempo real — a secretaria vê a lista de pendentes, não uma fila no balcão;
- Cobrança educada:
POST /v1/signing-sessions/{sessionId}/resend-invitepara os atrasados, na cadência que a escola definir; - Arquivo: concluído, o sistema baixa o PDF assinado e o pacote de evidências para a pasta do aluno.
Sem equipe de desenvolvimento? O mesmo fluxo se monta visualmente com o nó de n8n a partir de uma planilha de alunos.
EAD e edtechs: o aceite que prova
Para termos de uso, política de privacidade e contratos de cursos on-line de menor valor, o caminho é o clickwrap com evidência: o PDF versionado dos termos, o perfil CLICK_ONLY e a entrega do link dentro da sessão logada da plataforma — o aceite sai com hash do documento, data/hora, IP e trilha, no lugar do checkbox que não prova nada. Cursos de valor mais alto sobem para CLICK_PLUS_OTP mudando um campo. E para o white-label — a edtech que atende várias instituições — o objeto appearance por envio faz cada escola ver a própria marca na página de assinatura, como no guia de SaaS white-label.
Perguntas Frequentes
Contrato de matrícula assinado eletronicamente tem validade jurídica?
Sim. O contrato de prestação de serviços educacionais segue a regra geral dos contratos privados: a MP 2.200-2/2001 (art. 10, §2º) admite a assinatura eletrônica aceita pelas partes, e a Lei 14.063/2020 organiza os níveis. Para matrículas, a assinatura avançada — o responsável autenticado por código no e-mail/SMS, com trilha de auditoria completa — é o padrão que equilibra segurança e conveniência. Instituições que queiram reforço em contratos de maior valor (pós-graduação, cursos longos) podem exigir biometria ou certificado ICP-Brasil do responsável, mudando apenas o perfil de autenticação no mesmo fluxo.
Quem assina a matrícula de um aluno menor de idade?
O responsável legal — e, quando a escola separa os papéis, também o responsável financeiro, que pode ser outra pessoa. É um caso clássico de envelope multi-signatário: o documento sobe uma vez, e cada responsável recebe a sua própria sessão de assinatura, com seu link e sua autenticação. Se a instituição também assina (diretor ou mantenedora), entra como mais um signatário, em ordem sequencial se o fluxo interno exigir. Cada assinatura fica registrada com sua identificação e evidências próprias na trilha da transação.
Como funciona a rematrícula em massa via API?
É o cenário em que a API paga o ano inteiro em uma temporada: seu sistema acadêmico itera sobre os alunos aptos, gera o contrato de cada um (PDF com os dados do aluno, série e valores) e cria uma sessão por responsável — com X-Idempotency-Key por aluno+período letivo para que reprocessamentos não dupliquem. Os links seguem por e-mail; os responsáveis assinam pelo celular, sem instalar nada; os webhooks de conclusão atualizam o status no sistema acadêmico em tempo real; e a secretaria acompanha a lista de pendentes em vez de uma fila no balcão. Reenvio de convite para os atrasados é uma chamada.
E os termos de uso de plataformas EAD e edtechs?
Para o aceite de termos de uso, política de privacidade e contratos de cursos on-line de menor valor, o clickwrap com evidência (perfil CLICK_ONLY) resolve com fricção mínima: o aluno aceita com um clique sobre o PDF versionado, e a plataforma registra hash do documento, data/hora, IP e trilha — prova muito mais forte que o checkbox caseiro. A regra de segurança é entregar o link do aceite dentro da sessão logada da plataforma. Para contratos de cursos de maior valor, suba o nível para CLICK_PLUS_OTP no mesmo fluxo.
A escola precisa guardar os contratos por quanto tempo?
Contratos de prestação de serviços seguem os prazos gerais de prescrição cível — a prática recomenda guardar o contrato e as evidências por pelo menos 5 anos após o término da relação, e as políticas internas de muitas instituições estendem isso. O importante é a qualidade da guarda: o PDF assinado e o pacote de evidências (.p7m) baixados via API e arquivados no seu repositório permanecem verificáveis de forma independente pelo verificador público, mesmo anos depois. Consulte o jurídico da instituição para a política de retenção específica.
Dá para integrar com o sistema acadêmico que já usamos?
Sim — esse é o desenho natural. O sistema acadêmico (ou ERP educacional) chama a API na virada de status do aluno (aprovado → gerar contrato), recebe os webhooks de conclusão e arquiva os documentos, tudo por REST com SDKs oficiais em seis linguagens. Sem equipe de desenvolvimento disponível, o caminho no-code com o nó de n8n monta o mesmo fluxo visualmente: planilha ou formulário → contrato → assinatura → atualização. E o desenvolvimento inteiro acontece no sandbox gratuito antes de qualquer contrato.
A próxima temporada de matrículas, sem fila
Modele o fluxo da sua instituição no sandbox gratuito — envelope com responsáveis, rematrícula em lote, webhooks no sistema acadêmico — e dimensione a produção com o time comercial.
Criar credenciais de homologação Falar com o time comercial