Manual de Integração do Software de Gestão Escolar Edukante ao Meio de Pagamento PagSeguro Para o Recebimentos por Cartão de Crédito ou Boletos Bancários

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.
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.
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.
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.
Configuração de Contas PagSeguro
A instituição deve acessar seu ambiente do sistema edukante.
..Navegar até o menu Financeiro > Configurações > PagSeguro
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.
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.
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.
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.
No menu da esquerda, navegue até o submenu Preferências > Integrações
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 ( ).
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 (
página seguinte, confirme a exclusão.
Realizando uma Matrícula Online
), existente ao lado de todas as contas. Na
Para realizar uma matrícula OnLine você deve acessar
http://www.edukante.com/nomeinstituicao/matriculaonline
o
endereço:
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.
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.
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
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.
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:
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.
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.
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.
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.
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:
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.