O edukante é um software de gestão escolar que pode adaptar-se e ser utilizado por todos os tipos de instituições de ensino, como escolas, cursos abertos, faculdades, pós graduação, programas de mestrado, etc. Realizar a integração do sistema edukante com a plataforma pagseguro, permitirá que a instituição de ensino gerencie, através do próprio software de gestão, a geração e baixa automática de recebimentos eletrônicos sobre as matrículas e mensalidades dos alunos ou sobre produtos e serviços que comercializa, através de cartão de crédito ou boleto bancário. Os alunos poderão, por exemplo, realizar o pagamento da matrícula, logo após o procedimento da matrícula OnLine. Este procedimento acontece através de cobrança transparente, onde quem paga, seja com cartão de crédito ou boleto bancário, realiza todo o procedimento no sistema da própria instituição de ensino, sem a necessidade de cadastro prévio no pagseguro ou ser redirecionado para sua página. Mais informações em http://www.edukante.com

1. Manual Integração edukante PagSeguro
Como utilizar o sistema edukante para recebimento através do
cartão de crédito e boleto bancário integrado ao pagseguro
O edukante é um software de gestão escolar que pode adaptar-se e ser utilizado por
todos os tipos de instituições de ensino, como escolas, cursos abertos, faculdades, pós
graduação, programas de mestrado, etc.
Realizar a integração do sistema ​edukante com a plataforma ​pagseguro​, permitirá que
a instituição de ensino gerencie, através do próprio software de gestão, a geração e
baixa automática de recebimentos eletrônicos sobre as matrículas e mensalidades dos
alunos ou sobre produtos e serviços que comercializa, através de ​cartão de crédito ou
boleto bancário​.
Os alunos poderão, por exemplo, realizar o pagamento da matrícula, logo após o
procedimento da matrícula OnLine. Este procedimento acontece através de cobrança
transparente, onde quem paga, seja com ​cartão de crédito ou boleto bancário​, realiza
todo o procedimento no sistema da própria instituição de ensino, sem a necessidade
de cadastro prévio no pagseguro ou ser redirecionado para sua página.

2. Matrícula Online
Para realizar a matrícula online o aluno abre o navegador e acessar o endereço
www.edukante.com/diretoriodainstituicao/matriculaonline ou clicar no link de
realizar matrícula no site da instituição de ensino. Este link pode ou não conter o
código da turma, onde será realizada a matrícula em questão.
Na imagem abaixo podemos ver a primeira tela da Matrícula OnLine, onde o aluno
insere seus dados pessoais e seleciona o período e curso. O aluno pode também
anexar um ou mais arquivos que deseja enviar.
Ao clicar no botão ​Continuar​, o aluno é direcionado ao formulário seguinte, onde
escolherá se deseja pagar com cartão de crédito ou boleto bancário.

3. Após informar o número do cartão e apertar no botão ​Carregar Parcelas​, de acordo
com o valor e com a bandeira do cartão, a quantidade de parcelas que podem ser
selecionadas é exibida na lista ao lado. O aluno então seleciona a quantidade de
parcelas e informa o mês e ano de vencimento do cartão, o código CVV e o nome, da
forma como está impresso no cartão. Por fim, deve pressionar o botão ​Pagar​.
Enquanto a conta estiver no ambiente de testes (sandbox, veremos mais à frente) os
seguintes dados do cartão podem ser usados para validar o processo:
Número do Cartão: 4111 1111 1111 1111
Vencimento: 12/2030
CVV: 123
Nome: Qualquer Um
Neste momento as Apis dos dois sistemas (edukante e pagseguro) darão início a uma
“​conversa segura​”, onde os dados do cartão e da transação são registrados.
Enquanto os sistemas estiverem em comunicação, as caixas aparecerão em branco e a
mensagem de Aguarde...
Após o fim do processo, a seguinte imagem será exibida para o aluno com os dados da
transação.

4. Segurança HTTPS
A transação de solicitação e envio dos dados do cartão, somente é possível porque o
sistema edukante e pagseguro contam com mecanismos de segurança e criptografia
de dados HTTPS (​Hyper Text Transfer Protocol Secure​), como pode ser notado no
navegador, ao lado do endereço URL da página acessada, existe um cadeado. Este
requisito garante a criptografia das informações durante seu envio das informações de
forma completamente segura.

5. Configuração de Contas PagSeguro
A instituição deve acessar seu ambiente do sistema edukante.
​..Navegar até o menu ​Financeiro > Configurações > PagSeguro

6. Cada uma das contas exibidas na imagem abaixo representa uma configuração de
conta do pagseguro, incluindo a informação se a conta deve ser utilizada no ambiente
de testes ou produção​ e se ela é ou não a conta ​padrão​.
ambiente de testes > Utilizado para validar se todo o mecanismo está funcionando
como deve. É primordial que a instituição utilize e aprove o processo no ambiente de
testes antes de mudar a conta para o ambiente de produção. Este procedimento trará
segurança ao processo, que uma vez funcionando bem no ambiente de testes,
também deverá funcionar no ambiente de produção.
ambiente de produção > Uma vez provado e aprovado o ambiente de testes, é
indicado que a instituição de ensino crie uma nova conta do pagseguro, clicando no
botão ​+ Nova Conta do pagseguro​. Desta forma teremos duas contas cadastradas,
uma para o ambiente de testes e outra para o ambiente de produção, ambas para a
mesma conta do PagSeguro. É importante perceber que o token fornecido pelo
pagseguro para cada uma dos ambientes é diferente.
conta padrão > Você pode criar quantas contas quiser, contudo, apenas uma delas
poderá ser a conta padrão. Será através desta conta padrão que o sistema gerará as
cobranças e computará os recebimentos, sobre as transações com cartão de crédito
e/ou boleto bancário. Enquanto estiver testando o procedimento com a conta no
ambiente de testes (sandbox) deixe-a como sendo a conta padrão. Quando chegar o
momento de colocar o processo em produção, defina sua conta de produção como a
conta padrão.

7. Adicionando uma Nova Conta
Para adicionar uma nova conta, acesse o menu ​Financeiro > Configurações >
PagSeguro​. Quando a página carregar clique no botão ​+ Nova Conta PagSeguro​.
Informe os dados solicitados. As contas são cadastradas por padrão para funcionar no
ambiente de testes. Para passá-la ao ambiente de produção volte até a lista de contas
e peça para modificá-la, na coluna de ações, no ícone de editar a conta. Os próximos
dois tópicos mostram como deve proceder para resgatar os Tokens, o do ambiente de
testes e o do ambiente de produção.

8. Resgatando o Token do Ambiente de Testes (Sandbox)
Para resgatar o token do ambiente de testes, acesse a página do pagseguro sandbox:
www.sandbox.pagseguro.uol.com.br
Realize a autenticação utilizando os campos na parte superior direita, como mostra a
imagem acima, utilizando suas credenciais do pagseguro.
Após acessar o ambiente do sandbox, selecione a opção ​Vendedor , na coluna da
esquerda, no grupo de ​Perfis de Integração​.

9. Resgatando o Token do Ambiente de Produção
Para resgatar o token do ambiente de produção, acesse a página do pagseguro:
www.pagseguro.uol.com.br
Informe as credenciais de sua conta no pagseguro, na parte superior da página
mostrada na imagem acima. O painel do pagseguro será aberto.

10. No menu da esquerda, navegue até o submenu ​Preferências > Integrações

11. Para resgatar o Token você pode pedir para que o pagseguro o envie por email no link
Enviar por Email ​ou ainda gerar um novo token, no botão ​Gerar token​.
Modificando uma Conta PagSeguro
Para modificar uma conta acesse o menu ​Financeiro > Configurações > PagSeguro​.
Quando a página carregar, selecione o ícone de ​Editar​, existente ao lado das contas
cadastradas e listadas ( ).

12. Como pode ver na imagem acima, neste momento é possível definir se a conta deve
começar a ser a conta ​Em Ambiente de Produção ​e se ela deve se tornar a conta
Padrão. Se assim for definido, os pagamentos a partir deste momento, serão
registradas nesta conta do pagseguro.
Excluindo uma Conta
Para excluir uma conta acesse o menu ​Financeiro > Configurações > PagSeguro​.
Quando a página for carregada, clique no ícone ( ), existente ao lado de todas as
contas. Na página seguinte, confirme a exclusão.

13. Realizando uma Matrícula Online
Para realizar uma matrícula OnLine você deve acessar o endereço:
http://www.edukante.com/​nomeinstituicao​/matriculaonline
Por exemplo, no caso do Curso Edukante:
http://www.edukante.com/​cursoedukante​/matriculaonline
Em ​nomeinstituicao você substitui pelo nome do diretório de sua instituição de ensino
no sistema edukante. Este link pode ser chamado diretamente da webpage da
instituição, enviando inclusive por parâmetro o código do curso ou turma da matrícula.
O aluno preencherá seus dados pessoais, anexará arquivos digitais (caso queira) e
clicará no botão ​Continuar​. A tela seguinte solicitará os dados do cartão de crédito. Se
desejar, mude a forma de pagamento para Boleto Bancário.
No ambiente de testes, os seguintes dados podem ser utilizados para validar o
processo.
Número do Cartão: 4111 1111 1111 1111
Vencimento: 12/2030
CVV: 123
Nome: Qualquer Um
Os dados são de um cartão fictício, fornecido pelo pagseguro para que o processo de
pagamento possa ser validado. Após informar o número do cartão, clicando-se sobre o
botão ​Carregar Parcelas ​serão retornadas todas os possíveis parcelamentos da
compra, de acordo com o valor e a bandeira do cartão.

14. Após informar os dados o aluno clica no botão ​Pagar​. Neste momento o sistema
estabelecerá um canal seguro de comunicação e enviará as informações da compra,
criptografadas, diretamente até o sistema do pagseguro. Enquanto o processo se
realiza será visualizada a mensagem : ​Comunicando..
Ao final do processo os dados da transação são exibidos para o aluno. Neste momento
é possível gerar um arquivo .PDF do recibo da matrícula.

15. Consultando os Dados da Matrícula
Uma vez realizada, a matrícula online é registrada como matrícula online e também
como uma matrícula efetiva.
Para visualizar a matrícula online navegue até o menu ​Acadêmico > Controles >
Matrículas Online

16. Para visualizar a matrícula real do aluno, navegue até o menu ​Acadêmico > Controles >
Matrículas Acadêmicas​. Após o carregamento da página, informe uma parte do nome
do aluno no filtro de pesquisa e localize-o.
Para visualizar o recebimento financeiro gerado a partir da matrícula, navegue até o
menu ​Financeiro > Recebimentos > Matrículas e Mensalidades​. No filtro novamente
informe parte do nome do aluno e localize o recebimento.

17. Consultando as Transações
Para consultar as transações com os pagamentos dos alunos com o PagSeguro, ou seja,
ver os pagamentos eletrônicos realizados na matrícula online, acesse o sistema
edukante e navegue até o menu ​Financeiro > Configurações > PagSeguro​. Clique
então no botão ​Consultar Transações.
As transações serão exibidas:

18. Perceba que a última matrícula que realizamos, de José Roberto Trinidade, consta
como a última da lista. No próximo tópico mostraremos como você deve fazer para
acessar o ambiente de testes do PagSeguro e mudar o status da transação.
Modificando o Status de uma Transação no Ambiente de Testes do
PagSeguro
Como estamos operando sobre o ambiente de testes, precisamos manualmente mudar
o status da transação, para que assim, o sistema edukante consiga dar a baixa
automática no pagamento da matrícula. Para isto, acesse o ambiente do pagseguro
sandbox: ​www.sandbox.pagseguro.uol.com.br
Agora navegue, no menu da esquerda, até a opção de ​Transações​.

19. Clique sobre a transação que deseja mudar o status. Em nosso caso, será modificado o
status da transação de José Roberto Trinidade. Veja os detalhes da transação. Ao lado
do Status, na primeira linha, há um link ​alterar ​, clique sobre ele e mude o status da
transação para Paga.

20. Agora voltaremos ao sistema edukante, solicitando que o mesmo conecte-se com o
pagseguro para dar baixa sobre os pagamentos que foram dados baixa. Para acessar
esta tela, navegue até o menu ​Financeiro > Configurações > PagSeguro e clique no
botão ​Consultar Transações​.
Agora clique no botão ​Atualizar Transações. ​Perceba que a transação do aluno José
Roberto Trinidade, último da lista, foi atualizada e agora possui status de Pago, a data
e o valor do pagamento.

21. Em Ambiente de Produção
Chegou a hora de colocar o mecanismo no ar, funcionando no ambiente de produção e
de forma real. Em um tópico anterior vimos como devemos cadastrar as contas do
pagseguro​ no ​edukante​.
Indicamos que tenha duas contas no sistema edukante para cada conta do pagseguro
que possua, uma com os dados do token do ambiente de testes e outra com os dados
do token do ambiente de produção.
Desta forma, o único que precisamos fazer definir a conta de produção como ​Padrão.
Como deve haver apenas uma e ao menos uma conta que seja a conta padrão, o
sistema realiza o controle desta forma, mantendo sempre apenas uma como padrão.
Acesse o menu ​Financeiro > Configurações > PagSeguro​. Escolha a conta que deve
estar como Padrão e na coluna de ações clique na opção ​Editar.
Em ​Definir como conta padrão ​selecione a opção ​Sim ​e no campo ​Testes ou Produção
selecione ​Produção​.
Para realizar um teste realize a Matrícula Online e o pagamento com um cartão real.
Lembre que pode mudar o valor da matrícula durante os testes, colocando-o com um
valor pequeno, como de R$ 5,00, por exemplo.

22. Colocando o Link para Matrícula no WebSite da Instituição de
Ensino
Existem duas formas de criar um link para a página de matrículas online da
instituição de ensino.
1) Chamando diretamente a página sem o envio de parâmetros. O
aluno iniciará a escolha do tipo de ensino, curso e período.
http://www.edukante.com/nomeinstituicao/matriculaonline
2) Enviando como parâmetro o código da turma.
http://www.edukante.com/nomeinstituicao/matriculaonline?codigoTurma=5
Neste segundo caso, o número 5 deve ser substituído pelo código da turma.
Neste caso o Ensino e o Curso são previamente selecionados pelo sistema, de
acordo com o código enviado da turma.
Para resgatar o link ou url de matrícula online para uma turma em específico,
acesse o sistema de gestão escolar e navegue até o menu ​Acadêmico >
Configurações > Turmas ​, ao solicitar a edição dos dados de uma Turma ou
visualizar seus detalhes, através da coluna de ações, a URL da matrícula online
será exibida:

23. Conclusão e Trabalhos Futuros
A plataforma software de gestão escolar edukante pode ser utilizada para permitir que
o pagamento de mensalidades, produtos e serviços sejam realizados através da
internet e do seu próprio sistema de gestão, utilizando cartão de crédito ou boletos
bancários. No caso dos boletos a instituição não precisa necessariamente utilizar os
boletos do pagseguro, podendo optar por cadastrar sua conta bancária no sistema e
gerar os boletos a partir dela, com as tarifações negociadas com o seu banco.
Todo o processo de pagamento, desde a seleção do curso, passando por quando o
aluno informa os dados do cartão e a confirmação do pagamento acontece no próprio
ambiente da matrícula online da instituição de ensino. Por se tratar de uma cobrança
transparente o aluno não precisa ser cadastrado previamente no PagSeguro e também
não será redirecionado para sua página.
Um dos próximos passos da equipe edukante será permitir que além da matrícula, as
parcelas das mensalidades também possam ser quitadas com o uso do cartão de
crédito, caso a instituição tenha realizado a configuração prévia do sistema para tal.
Neste caso, o aluno ou pai responsável realizará o procedimento diretamente do
painel do Aluno ou do painel do Pai.
Haverá também a possibilidade de cobrança recorrente, onde através de uma
autorização prévia do titular do cartão, a instituição de ensino poderá programar todos
os pagamentos do aluno de acordo com datas e valores futuros que serão debitados
automaticamente em seus cartões de crédito.