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.