Liberação do botão "Pagamento" no Meu eduCONNECT.

Esses recursos estão disponíveis a partir da release 12.1.27 do TOTVS Educacional e TOTVS Educa Mobile. Para mais informações sobre como adquirir favor entrar em contato com nosso time de atendimento.

Para outros dúvidas sobre o Meu eduCONNECT FAQ - Meu eduCONNECT

A solução eduCONNECT Pay oferece aos alunos, pais e responsáveis a experiência de pagamento digital de forma mais simples e segura. Já para as instituições de ensino oferece recursos para reduzir a inadimplência e o custo operacional.

Para habilitar o botão "Pagamento" e utilizar a funcionalidade de pagamento com cartão de crédito pelo app Meu eduCONNECT, existem algumas recomendações que precisam ser seguidas:

Importante

Atualizem para o Microsoft Internet Information Services (IIS) versão 7.0 ou superior;
O Portal do aluno e o Educamobile devem possuir certificado digital implementado. No caso de duvidas neste processo clique aqui: Requisitos de ambiente EduCONNECT Pay.

Após seguir as recomendações acima, é necessário que a Instituição de Ensino configure a URL Rewrite e o Application Request Routing Cache (ARR).
Aviso

As configurações de URL Rewrite devem apontar para porta API (APIPORT) definida dentro dos arquivos de configuração do host, no diretório de instalação do TOTVS.
Avaliar se há espaço na configuração da URL Rewrite
Esta porta deve estar pública no Firewall ou nas regras de segurança do servidor.
Um teste que pode ser feito é a utilização da porta 8051 para a porta API (APIPORT) definida dentro dos arquivos de configuração do host, já que essa porta por padrão é utilizada pelo RM para acesso aos webservices.
Assim se o botão aparecer para a porta 8051. Isso indica que a porta inicial utilizada não tem as mesmas permissão presente para a porta 8051. E isso deve ser verificado.
Verificar se o reewrite está instalado
Excutar o comando %windir%\system32\inetsrv\appcmd list module , no CMD, no servidor Web e verificar se existem na lista

Liberação do pagamento no Perfil do usuário:

Para testar se a API está respondendo corretamente, temos os seguintes links:

O link abaixo auxilia nos processos de definir se a porta está publica e parametrizada para consumir APIs.
localhost:PORTA/api/swagger
O link abaixo acusa se a funcionalidade está corretamente liberada no sistema.
http://endereco/EducaMobile/api/framework/v1/menus/dd6626a5aa1e3c2c2ad79198824f67a4?$filter=tagMenu eq '808100759'
Já este link verifica se as permissões foram corretamentes concedidas dentro do sistema:
http://endereco/EducaMobile/Mensagens/Parametrizacao?guid=C9A022F4-D56B-4173-8226-B6C1738118B6&page=0&pageSize=0

Endereço do Servidor do Host

A URL a ser utilizada é a do servidor onde encontra-se instalado o Host, como exemplo, utilizamos o endereço http://IPdoServidorHost:8052/xxxx

Em alguns casos o servidor do Host é dirente do servidor Web, então neste caso, deve-se utilizar o endereço do servidor do Host.

Os links acima devem ser chamados via Postman (ou similares), substituindo a parte em negrito pelo seu link do Educamobile, no método GET, informando as credenciais de acesso do Educamobile. Veja o exemplo no print abaixo:

Aviso

O botão "Pagamento" no meu EduCONNECT será exibido somente caso os testes dos três links acima tenham retornado êxito.

Permissão por contexto

Pode ser que algum menu só esteja sendo apresentado para apenas alguns usuários.

Conferir se a opção 04 ("Pagamento") está marcada na etapa eduCONNECT 5/5 dos parâmetros do eduCONNECT no contexto em que o usuário tem permissão para acessar o sistema conforme anexo "Usuário / Filial".

Clique aqui para mais detalhes sobre a ativação dessa opção.

Usuário do serviço do host diferente ou não ter permissão na porta (ApiPORT) de configuração do URL Rewrite

Se o usuário configurado para a porta do host (APIPort) via netsh estiver diferente do usuário do serviço, o postman retorna o JSON corretamente mas o botão de pagamento ainda pode não aparecer no Meu eduCONNECT.

netsh http show urlacl

Erros encontrados:

1) Ao acessar a API de parametrização de mensagens "../Mensagens/Parametrizacao", é exibido o erro abaixo:

erro 500 - "ORA-01017: Invalid username/password; login denied"

Solução:

Verificar o usuário e senha do código de acesso "eduCONNECT" no caminho: "Serviços Globais | Segurança | Acesso | Código de Acesso | "eduCONNECT"

Poderá ser utilizada a página do Educamobile de verificação do Status do aplicativo incluindo a tag abaixo no web.config do Educamobile e chamando em seguida a URL da página de status conforme abaixo:

Tag do web config do Educamobile: <add key="SUPORTE" value="True" />
URL de suporte: http://<<Endereço do Educamobile>>/status

O resultado para a verificação do TOTVSEduCONNECT deve ser conforme abaixo:

2) Ao tentar cadastrar um novo cartão na carteira digital (eduCONNECT Pay), na inclusão dos dados do usuário, o sistema exibe a mensagem de erro "Erro interno do servidor".

Veja a solução em FAQ - Meu eduCONNECT

3) Ao tentar chamar a api para geração de token "http://localhost/EducaMobile/api/connect/token", é retornado um erro de acesso negado "Access denied" conforme abaixo:

Esse erro acontece ao tentar consumir o certificado X509 embutido na dll da lib ("RM.Lib.Server") pelo usuário parametrizado no serviço (RM.Host.Service)

Solução:

Normalmente, o usuário de serviço é o Networking Service (Serviço de Rede), conforme abaixo.

Alterar para "Local System (Conta de Sistema Local) ou dar permissão para o usuário de rede acessar a pasta "C:\ProgramData\Microsoft\Crypto\RSA\MachineKeys"

Link que ajudou a solucionar esse problema:
https://github.com/Microsoft/dotnet-framework-early-access/issues/25

4) Botão de Pagamento não é apresentado no APP, mesmo com todas as configurações de ARR e Rewrite corretas: