{"_id":"5a7c4a5b5ac9e4003d7fcba6","project":"575aeffae12cf20e002f306c","version":{"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","__v":31,"createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","categories":["575aeffae12cf20e002f3070","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","57602fe5b82256240055c657","57602ff6c811102000cef302","576030909b1a9a220067ca40","57604518b82256240055c722","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","577680bf3cee3a0e00a000bc","577ff3b1ff48990e000c6806","5783f78c5cbce30e0074e2b7","5783f86292edb92200e6101c","5783f86dbfbba719003f0d8b","5783f8755cbce30e0074e2b8","5783f8b65cbce30e0074e2b9","5783f8bf5cbce30e0074e2ba","5783f8d8ce802f0e0087d574","578529f887c9280e0090394b","57852aeb87c9280e0090394d","57866e72b2f4060e00fa39ca","57ab6d5c39c2fd1900191879","57f39451ab0ee12000bef915","582499a0d90fa027009b259e","58c29df1258e5a1900b60478","5a7c4127490e52002a7f643c"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"2016","version_clean":"1.0.0","version":"1"},"category":{"_id":"5a7c4127490e52002a7f643c","project":"575aeffae12cf20e002f306c","version":"575aeffae12cf20e002f306f","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2018-02-08T12:23:03.906Z","from_sync":false,"order":11,"slug":"sistemas-integrados","title":"Sistemas Integrados"},"user":"57601a13af3e090e00108059","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-02-08T13:02:19.941Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":9,"body":"<img src=\"https://gerencianet.com.br/wp-content/uploads/2015/08/post-1-integra----o-mkauth.jpg\" alt=\"Mk-Auth\">\n\n<br>\n\nVá direto ao ponto ­- utilize o índice abaixo e veja diretamente o que você precisa:\n\n- [Configurando a Gerencianet no Mk-Auth](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-configurando-a-gerencianet-no-mk-auth)\n\n- [Como dar baixa automática (callback) no Mk-Auth?](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-como-dar-baixa-autom-tica-callback-no-mk-auth-)\n\n- [Como verificar se a integração está funcionando?](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-como-verificar-se-a-integra-o-est-funcionando-)\n\n- [A integração falhou. Como verificar o erro?](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-a-integra-o-falhou-como-verificar-o-erro-)\n\n   - [Se falhou na emissão da cobrança](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-se-falhou-na-emiss-o-da-cobran-a)\n\n   - [Se falhou na baixa automática (callback)](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-se-falhou-na-baixa-autom-tica-callback-)\n\n- [Pagamento por cartão de crédito (API) no Mk-Auth](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-pagamento-por-cart-o-de-cr-dito-api-no-mk-auth)\n\n   - [Testando em ambiente de desenvolvimento o pagamento por cartão](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-testando-em-ambiente-de-desenvolvimento-o-pagamento-por-cart-o)\n\n\n- [FAQ: Respostas para as Dúvidas Mais Frequentes](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-faq-respostas-para-as-d-vidas-mais-frequentes)\n\n   - [Cliente não marcado como inadimplente](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-cliente-n-o-marcado-como-inadimplente)\n\n   - [Cliente não recebe e-mail de cobrança](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-cliente-n-o-recebe-e-mail-de-cobran-a)\n\n   - [Cobranças enviadas mensalmente](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-cobran-as-enviadas-mensalmente)\n\n   - [Como gerar carnês dentro do Mk-Auth?](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-gera-o-de-carn-s)\n\n   - [Como visualizar na Gerencianet dados da tentativa de criação de cobrança no Mk-Auth](https://dev.gerencianet.com.br/docs/mk-auth#section-como-visualizar-na-gerencianet-dados-da-tentativa-de-cria-o-de-cobran-a-no-mk-auth)\n\n- [Extras: vídeos oficiais no canal do Mk-Auth no YouTube](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-extra-v-deos-oficiais-no-canal-do-mk-auth-no-youtube)\n\n- [Dúvidas ou Suporte?](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-d-vidas-ou-suporte-)\n\n<br>\n\n<hr>\n\n# Configurando a Gerencianet no Mk-Auth\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"NOTA\",\n  \"body\": \"Assista o <a href=\\\"https://vimeo.com/253160876\\\" target=\\\"_blank\\\">vídeo produzido pela equipe oficial do Mk-Auth</a> explicando e mostrando como adicionar uma conta Gerencianet dentro de seu sistema Mk-Auth.\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/488d000-mk-auth-tela-gerencianet.png\",\n        \"mk-auth-tela-gerencianet.png\",\n        991,\n        630,\n        \"#e8e8e8\"\n      ]\n    }\n  ]\n}\n[/block]\nPara facilitar a vida dos nossos clientes que realizam a integração da Gerencianet com outros sistemas, vamos postar dicas e informações sobre os módulos disponíveis na nossa plataforma. Para começar, vamos falar do Mk-Auth.\n\nA integração do Mk-Auth é realizada dentro da plataforma da API Gerencianet. Confira o passo a passo:\n\n1. Acesse o menu <code>API > Minhas Aplicações > Nova Aplicação</code>;\n\n2. Informe o nome da integração e ative o <code>Modo de Compatibilidade</code> (<a href=\"https://files.readme.io/6a8a83b-modo-compatibilidade-mk-auth.png\" target=\"_blank\" title=\"Link Externo\">veja onde</a>);\n\n3. Clique em <code>Criar nova aplicação</code>.\n\n<br>\n\nEm seguida, acesse o Mk-Auth para continuar:\n\n1. Acesse o menu <code>Provedor > Contas bancárias</code> da sua conta no Mk-Auth e clique na botão <code>+</code> (ícone de adição/mais);\n\n2. No campo <code>Escolha o Boleto e Banco</code>, selecione a opção <code>Gateway Gerencianet</code> e cole o token de integração gerado no campo <code>Token</code>;\n\n   - Caso você for utilizar **apenas emissão de boletos e carnês, não é necessário o preenchimento dos campos** <code>Client ID Produção</code>, <code>Client Secret Produção</code>, <code>Client ID Desenvolvimento</code> e <code>Client Secret Desenvolvimento</code>.\n\n<br>\n\n3. O campo <code>título inicial</code> não é obrigatório e pode ser preenchido com o número <code>0</code> (zero). Este campo representa o número da cobrança dentro do Mk-Auth, mas não altera nenhum dado de cobrança no Fortunus.\n\nPronto! A integração está completa.\n\n<img src=\"https://files.readme.io/488d000-mk-auth-tela-gerencianet.png\" alt=\"Mk-Auth Gerencianet Tela\">\n\n<br>\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"ATENÇÃO\",\n  \"body\": \"Para que a integração funcione, o Mk-Auth deve estar conectado à internet.\"\n}\n[/block]\n<br>\n\n<hr>\n\n# Como dar baixa automática (callback) no Mk-Auth?\n\nVocê ainda pode cadastrar uma URL de callback para que o Mk-Auth realize baixas automáticas sempre que a Gerencianet identificar um pagamento, e uma URL de cancelamento para que o Mk-Auth também realize uma baixa automática sempre que você fizer o cancelamento de uma cobrança na Gerencianet.\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"ATENÇÃO\",\n  \"body\": \"Se o cancelamento for realizado no Mk-Auth, a baixa automática não ocorrerá em sua conta Gerencianet.\"\n}\n[/block]\nVeja como cadastrar as URLS:\n[block:html]\n{\n  \"html\": \"<ol>\\n\\n  <li>Acesse o menu <code>API > Minhas Aplicações</code> e selecione sua aplicação;</li><br>\\n    \\n      <li>Acesse a aba <code>Callbacks</code>, ative ambos os campos (<a href=\\\"https://content.screencast.com/users/tiagogerencianet/folders/Jing/media/82315a32-fff3-4ce2-9202-0dfa701bd36d/2018-04-05_1340.png\\\" target=\\\"_blank\\\">veja onde</a>) e cadastre suas URLs seguindo o modelo:\\n\\n\\t<ul>\\n  <br>\\n  <li><code>http://SEU_IP:porta/api/fortunus_confirma.php</code>, para confirmação de pagamento;</li><br>\\n\\n  <li><code>http://SEU_IP:porta/api/fortunus_cancela.php</code>, para cancelamento;</li><br>\\n\\n  <li>O IP indicado acima deve ser da conta Mk-Auth. Ele fica disponível no menu <code>Opções > IP do Servidor</code>;</li><br>\\n\\n  <li>Se você utiliza um serviço de DNS Dinâmico (<abbr title=\\\"Dynamic Domain Name System\\\">DDNS</abbr>), é possível colocá-lo no lugar de seu IP (inclusive, é uma prática recomendada);</li><br>\\n\\n  <li>Para que a URL de cancelamento seja cadastrada com sucesso, é preciso marcar a opção <code>Cobrança Cancelada</code>, na configuração de callback de sua conta Gerencianet.</li>\\n  \\n  </ul>\\n  \\n</ol>\"\n}\n[/block]\nNeste mesmo lugar, você pode desativar a URL de notificação quando necessário.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"IMPORTANTE\",\n  \"body\": \"É importante frisar que é possível possuir uma única URL de callback para sua conta Gerencianet. Mesmo que você possua duas ou mais aplicações na API que utilizem o \\\"modo de compatibilidade\\\", ou seja, se usa token ao invés de Client_Id e Client_Secret, a URL de callback será sempre a mesma.\\n\\nPara resolver, é bem simples: em sua conta Gerencianet, acesse <code>Minha conta > Nova conta</code>.\"\n}\n[/block]\n<br>\n\n<hr>\n\n# Como verificar se a integração está funcionando?\n\nVocê pode realizar testes para verificar se a URL está funcionando perfeitamente. Para isto, clique no botão <code>Testar</code>, que fica ao lado da URL de notificação cadastrada em sua conta Gerencianet (<a href=\"https://content.screencast.com/users/tiagogerencianet/folders/Jing/media/125ac343-46cd-4f20-bec3-c1ebe4588c93/2018-04-05_1413.png\" target=\"_blank\">veja onde</a>). Ao clicar no botão, uma requisição é enviada para o Mk-Auth e você recebe uma mensagem informando se o callback está funcionando ou não.\n\nMas para que o callback e a integração funcionem perfeitamente, é importante utilizar a última versão do Mk-Auth. Caso contrário, mesmo que você receba a mensagem com a informação de que o callback está funcionando, o sistema não realizará a baixa automática.\n\nQuando a sua URL está configurada corretamente, mas por algum motivo o seu Mk-Auth parou de funcionar ou apresentou problema, sua URL é desativada e as notificações não são enviadas. Quando isso ocorre, você deve ativar novamente a sua URL, testar e, em caso de resposta com sucesso (200), você pode reenviar as notificações de confirmação de pagamento. Para isso, siga o procedimento abaixo:\n\n1. Em sua conta Gerencianet, clique no menu <code>API > Minhas Aplicações</code>, selecione sua aplicação e vá na aba <code>Callbacks</code>;\n\n2. Ao lado da URL de notificação de pagamento cadastrado, clique no botão <code>Logs</code> (<a href=\"https://content.screencast.com/users/tiagogerencianet/folders/Jing/media/0a8c0228-ef9b-44d0-abb5-51d3902c7db7/2018-04-06_0931.png\" target=\"_blank\">veja onde</a>);\n\n3. Selecionar as cobranças que estão com o status <code>Não</code>;\n\n4. Clique em <code>Reenviar callback</code>.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"IMPORTANTE\",\n  \"body\": \"É importante sempre monitorar o status da sua URL de callback.\"\n}\n[/block]\n<br>\n\n<hr>\n\n# A integração falhou. Como verificar o erro?\n\n## Se falhou na emissão da cobrança\n\nSe mesmo após a integração realizada ocorrer algum erro na emissão da cobrança ou ela não foi gerada em seu Mk-Auth, você pode:\n\n### Alternativa 1:\n\nDentro de seu Mk-Auth, acesse as configurações de sua conta Gerencianet através do menu <code>Provedor</code> e confira se a opção <code>remessa on-line</code> está definida como <code>sim</code>.\n  \nEssa opção <strong>deve estar marcada</strong> como <code>sim</code> para que seu sistema Mk-Auth envie as cobranças para o webservice da Gerencianet.\n\n### Alternativa 2:\n\nEm sua conta Gerencianet, você pode verificar a origem do erro clicando no botão <code>Logs</code> (<a href=\"https://content.screencast.com/users/tiagogerencianet/folders/Jing/media/0a8c0228-ef9b-44d0-abb5-51d3902c7db7/2018-04-06_0931.png\" target=\"_blank\">veja onde</a>), disponível na aba <code>Callbacks</code> em sua aplicação na conta Gerencianet. Os dados da entrada mostram as informações no momento da emissão e os dados de saída mostram se a cobrança foi emitida com sucesso ou, em caso de falha, o campo em que está o erro.\n\nA integração funciona para boletos e carnês. Você pode gerar quantos precisar a partir de seu Mk-Auth. **Um erro comum é tentar atrelar boletos gerados em carnês. Essa opção existe no Mk-Auth, mas não funciona para a Gerencianet.** Se deseja criar carnês, utilize a opção de <code>incluir novo carnê</code> para seu cliente.\n\nSe ocorrer algum erro na tentativa de emissão e não for gerado um log, você deve conferir as configurações do Mk-Auth. Normalmente, esse erro ocorre quando as informações não estão sendo direcionadas da sua rede para o sistema da Gerencianet. Para ter certeza que a situação é essa, você pode fazer um *traceroute* do seu terminal para o host <code>accounts.gerencianet.com.br</code>. Caso a resposta seja *Tempo limite esgotado*, as informações não estão chegando ao sistema da Gerencianet e você pode verificar o seu DNS (fazer um teste com outro DNS) e as opções de permissão da sua rede.\n\nEm seu Mikrotik, você pode ir em <code>IP > Firewall > Filter Rules</code> e verificar se o IP ou bloco de IP da Gerencianet (veja a <a href=\"https://gerencianet.com.br/artigo/quais-enderecos-de-ip-gerencianet-utiliza/\" target=\"_blank\" title=\"Link Externo\">relação das faixas de IP da Gerencianet</a>) está bloqueado e desbloqueá-lo, conforme imagem a seguir:\n\n<img src=\"https://gerencianet.com.br/wp-content/uploads/acervo/post-firewall.png\" alt=\"Firewall Mk-Auth - Gerencianet\">\n\n\n### Alternativa 3:\n\nSe mesmo após a realização dos procedimentos acima você não obter êxito, você pode acrescentar a relação do bloco de IPs utilizados pela Gerencianet. Confira em nossa central de ajuda a <a href=\"https://gerencianet.com.br/artigo/quais-enderecos-de-ip-gerencianet-utiliza/\" target=\"_blank\">relação das faixas de IP da Gerencianet</a>.\n\n\n### Alternativa 4:\n\nCaso os procedimentos acima não solucionem o problema, será necessário descobrir o IP público com o qual o servidor do Mk-Auth do cliente chega na nossa estrutura. Veja abaixo como obtê-lo:\n[block:html]\n{\n  \"html\": \"<ul>\\n  <li>Logar SSH no servidor do Mk-Auth;</li>\\n  <li>Executar o comando: <code>curl https://api.ipify.org</code></li>\\n</ul>\"\n}\n[/block]\nEm posse do IP público, <a href=\"https://gerencianet.com.br/#login\" target=\"_blank\" title=\"Link Externo\">efetue login em sua conta Gerencianet</a> e, em seguida, <a href=\"https://accounts.gerencianet.com.br/faqticket/novoTicket/pagamentos\" target=\"_blank\" title=\"Link Externo\">abra um ticket</a> informando o IP e o problema que está enfrentando em seu Mk-Auth.\n\nSe você tiver dúvidas sobre as configurações do seu Mikrotik e Mk-Auth que podem estar interferindo na integração, consulte o <a href=\"http://www.mk-auth.com.br/arquivos/manual.pdf\" target=\"_blank\" title=\"Link Externo\">manual de configuração</a>. Caso não consiga configurar as permissões necessárias, contate o suporte do Mk-Auth através do e-mail <code>suporte:::at:::mk-auth.com.br</code> ou no <a href=\"http://mk-auth.com.br/forum\" target=\"_blank\">fórum oficial do Mk-Auth</a>.\n\n### Ainda ficou com alguma dúvida?\n\nCaso não consiga configurar as permissões necessárias, contate o suporte do Mk-Auth através do e-mail <code>suporte@mk-auth.com.br</code> ou no <a href=\"http://mk-auth.com.br/forum\" target=\"_blank\">fórum oficial do Mk-Auth</a>.\n\n<br>\n\n<hr>\n\n## Se falhou na baixa automática (callback)\n\nSe após a realização do reenvio de notificação (callback) o sistema retornar que sua URL é inválida ou se seu sistema Mk-Auth não está realizando as baixas automáticas, você pode:\n\n### Alternativa 1:\n\nVocê pode fazer um teste colando a URL em seu navegador de internet e tentar acessar. Se a página não for encontrada, alguma informação está incorreta e você deve verificar os dados informados e tentar novamente.\n\nSe você não receber uma resposta de êxito (200) ou receber a resposta e mesmo assim o sistema informar que a URL está inválida, é necessário configurar a permissão na sua rede para que a Gerencianet acesse a URL e notifique o seu Mk-Auth.\n\nNa URL de confirmação de pagamento (<code>http://SEU_IP:porta/api/fortunus_confirma.php</code>) ou de cancelamento (<code>http://SEU_IP:porta/api/fortunus_cancela.php</code>) você deve informar a porta de sua escolha para o acesso da Gerencianet. Caso não saiba qual liberar, utilize a porta <code>80</code> ou <code>443</code>, que são as padrões.\n\n### Alternativa 2:\n\nDentro de seu Mk-Auth, acesse as configurações de sua conta Gerencianet através do menu <code>Provedor</code> e confira se a opção <code>auto baixar</code> está definida como <code>sim</code>.\n  \nEssa opção <strong>deve estar marcada</strong> como <code>sim</code> para que a baixa automática dos títulos em seu Mk-Auth seja realizada.\n\n### Alternativa 3:\n\nSe mesmo após a realização dos procedimentos acima você não obter êxito, você pode acrescentar a relação do bloco de IPs utilizados pela Gerencianet. Confira em nossa central de ajuda a <a href=\"https://gerencianet.com.br/artigo/quais-enderecos-de-ip-gerencianet-utiliza/\" target=\"_blank\">relação das faixas de IP da Gerencianet</a>.\n\n### Ainda ficou com alguma dúvida?\n\nCaso não consiga configurar as permissões necessárias, contate o suporte do Mk-Auth através do e-mail <code>suporte@mk-auth.com.br</code> ou no <a href=\"http://mk-auth.com.br/forum\" target=\"_blank\">fórum oficial do Mk-Auth</a>.\n\n<br>\n\n<hr>\n\n# Pagamento por cartão de crédito (API) no Mk-Auth\n\nPara que seja possível o cliente pagar com cartão de crédito na central do assinante, basta informar as chaves Client_Id e Client_Secret de sua API Gerencianet e ativar a segunda via na central do assinante.\n\n## Testando em ambiente de desenvolvimento o pagamento por cartão\n\nÉ importante frisar que não é recomendável realizar testes em ambiente de produção, mas sim, em ambiente de desenvolvimento (testes). Para tal, basta que você faça uso de algum dos cartões de crédito *fictícios* abaixo em seu Mk-Auth. Somente depois de testar e assegurar que o funcionamento está adequado, é que você deve alterar seu ambiente para \"Produção\".\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Número de cartão Visa:\\n4012001038443335\\n\\nNúmero de cartão Mastercard:\\n5453010000066167\\n\\nNúmero de cartão Amex (American Express):\\n376449047333005\\n\\nNúmero de cartão Elo:\\n6362970000457013\\n\\nNúmero de cartão Diners:\\n36490102462661\\n\\nTodos com validade até:\\n05/2018\\n\\nCódigo de Segurança (CVV):\\n123\\n\\n\\n// todos os cartões a seguir são fictícios e usados exclusivamente para que seu Mk-Auth trabalhe com o ambiente de testes da API Gerencianet\\n\\n// fonte das informações: http://mk-auth.com.br/forum/topics/duvida-sobre-conta-de-cart-o\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\n<br>\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"IMPORTANTE\",\n  \"body\": \"É necessário ter internet no servidor do Mk-Auth. Importante lembrar que transações por cartão de crédito na internet passam por uma série de verificações e análises de mecanismos anti-fraude.\"\n}\n[/block]\nA equipe do suporte do Mk-Auth gravou um vídeo e disponibilizou no YouTube ensinando a configurar o Mk-Auth de forma a permitir o pagamento de clientes por cartão de crédito. <a href=\"https://www.youtube.com/watch?v=duZMxFhzcjA\" target=\"_blank\" title=\"Link Externo\">Confira o vídeo através deste link</a> ou assista abaixo:\n[block:html]\n{\n  \"html\": \"<iframe width=\\\"560\\\" height=\\\"315\\\" src=\\\"https://www.youtube.com/embed/duZMxFhzcjA\\\" frameborder=\\\"0\\\" allow=\\\"autoplay; encrypted-media\\\" allowfullscreen></iframe>\"\n}\n[/block]\n<br>\n\n<hr>\n\n# FAQ: Respostas para as Dúvidas Mais Frequentes\n\nConfira as respostas para as perguntas e dúvidas mais frequentes apontadas por nossos clientes que fazem uso do sistema Mk-Auth.\n\n## Cliente não marcado como inadimplente\n\nAlguns usuários questionam que seus clientes não estão em dia com a mensalidade, mas não estão marcados como inadimplentes no sistema. Isso pode acontecer se o boleto for enviado com o recurso “contra-apresentação”. Esse recurso é utilizado para que o boleto não tenha uma data de pagamento específica, ou seja, o cliente nunca estará inadimplente. Da mesma forma, não será cobrado juros e multas dessa cobrança. Veja como conferir se a opção está marcada:\n\n1. Entre no menu <code>Provedor</code> da sua conta Mk-Auth;\n\n2. Na opção <code>Contas Bancárias</code>, escolha a conta que deseja alterar e clique em <code>Alterar</code>;\n\n3. Verifique se a opção <code>Contra Apresentação</code> está marcada como <code>Sim</code>. Para desativar, basta mudar a chave para a opção <code>Não</code>.\n\n<img src=\"https://gerencianet.com.br/wp-content/uploads/2016/04/imagem-post-mkauth-2.png\" alt=\"Mk-Auth Gerencianet - Cliente não marcado como inadimplente\">\n\n<br>\n\nÉ preciso verificar a configuração antes da emissão da cobrança. Caso esteja marcada como <code>Sim</code>, o boleto será enviado sem data de vencimento e poderá ser pago a qualquer momento e em qualquer local sem a cobrança de juros e multas.\n\n<br>\n\n<hr>\n\n## Cliente não recebe e-mail de cobrança\n\nSe você está gerando um boleto, mas seu cliente não recebe por e-mail, pode ser:\n\n### Alternativa 1:\n\nPode ser que a tag <code>e-mail</code> da sua conta Gerencianet esteja vazia. Para verificar se o e-mail está sendo enviado pelo Mk-Auth e atualizar as configurações, siga os passos abaixo:\n\n1. No menu <code>Boletos e Carnês</code> da sua conta Gerencianet, acesse <code>Integrações</code>;\n\n2. No campo <code>Token de Integração</code>, clique no <code>Log</code> referente à integração do Mk-Auth;\n\n3. Clique na cobrança que deseja verificar;\n\n4. Em <code>Dados de Entrada</code>, verifique se o campo <code>tag e-mail</code> está preenchido corretamente.\n\n\n### Alternativa 2:\n\nCaso o e-mail do cliente não esteja especificado, acesse sua conta Mk-Auth para liberar a informação do e-mail do cliente:\n\n1. Acesse <code>Configurar Recursos</code> do menu <code>Opções</code> da conta Mk-Auth;\n\n2. Em <code>repassar o e-mail do clientes</code>, escolha o campo <code>Sim</code>.\n\n<img src=\"https://gerencianet.com.br/wp-content/uploads/2016/04/post-mk-auth-imagem-e-mail-e1461152647425-1024x520.png\" alt=\"Mk-Auth Gerencianet - Cliente não recebe e-mail de cobrança\">\n\n<br>\n\nPronto! Todas as cobranças enviadas após o ajuste na configuração serão enviados para o e-mail do cliente.\n\n### Alternativa 3:\n\nAlguns clientes finais têm problema para receber e-mail da Gerencianet. Isso acontece, na maioria das vezes, por filtros criados pelo próprio destinatário. Devido a isso, listamos os principais motivos que podem prejudicar a entrega de e-mails e como evitá-los. Confira abaixo dois artigos em nosso blog que poderão ajudá-lo:\n\n- <a href=\"https://gerencianet.com.br/blog/cliente-tem-problema-para-receber-e-mails-da-gerencianet/\" target=\"_blank\">Seu cliente tem problema para receber e-mails da Gerencianet? Veja o que fazer</a>\n\n- <a href=\"https://gerencianet.com.br/blog/marcar-e-mail-da-gerencianet-confiavel/\" target=\"_blank\">Como marcar o e-mail da Gerencianet como confiável?</a>\n\n### Ainda ficou com alguma dúvida?\n\nCaso não consiga configurar as permissões necessárias, contate o suporte do Mk-Auth através do e-mail <code>suporte@mk-auth.com.br</code> ou no <a href=\"http://mk-auth.com.br/forum\" target=\"_blank\">fórum oficial do Mk-Auth</a>.\n\n<br>\n\n<hr>\n\n## Cobranças enviadas mensalmente\n\nMuitos clientes emitem uma cobrança no Mk-Auth e não reparam que a opção <code>Auto-lançamento</code> está ativada. Dessa forma, o cliente final passa a receber o boleto mensalmente. Veja como conferir se a opção está ativada:\n\n1. Acesse o menu <code>Opções</code> e, em seguida, clique em <code>Configurar Recursos</code>;\n\n2. Em <code>Gerador de Títulos</code>, verifique se no campo <code>Auto Lançamento</code> contém o número <code>1</code>;\n\n3. Em seguida, confira se a opção <code>Manter Títulos</code> está marcada como <code>Sim</code>.\n\n<img src=\"https://gerencianet.com.br/wp-content/uploads/2016/04/imagem-post-mkauth.png\" alt=\"Mk-Auth Gerencianet - Cobranças enviadas mensalmente\">\n\n<br>\n\nQuando você mantem a opção de manter títulos marcada como <code>Sim</code>, o sistema já cria a próxima cobrança assim que recebe a anterior e envia para seu cliente com antecedência. Para enviar apenas uma cobrança, é importante marcar a opção <code>Não</code>.\n\n<br>\n\n<hr>\n\n## Como gerar carnês dentro do Mk-Auth?\n\nVeja como gerar carnês diretamente do MK-Auth:\n\n1. Acesse o menu <code>Clientes</code>;\n\n2. Em seguida, clique na seção <code>Detalhes</code>;\n\n3. Em <code>Emissão de carnês</code>, clique no botão <code>+</code>;\n\n4. Informe os dados para geração do carnê.\n\n<img src=\"https://gerencianet.com.br/wp-content/uploads/2016/04/blog-mk-auth-2.png\" alt=\"Mk-Auth Gerencianet - Geração de carnês\">\n\n### Ainda ficou com alguma dúvida?\n\nCaso não consiga configurar as permissões necessárias, contate o suporte do Mk-Auth através do e-mail <code>suporte@mk-auth.com.br</code> ou no <a href=\"http://mk-auth.com.br/forum\" target=\"_blank\">fórum oficial do Mk-Auth</a>.\n\n<br>\n\n<hr>\n\n## Como visualizar na Gerencianet dados da tentativa de criação de cobrança no Mk-Auth\n\nUm recurso de extrema importância é o *\"Histórico de Requisições\",* que permite ao cliente Gerencianet visualizar todas as requisições realizadas pelo seu Mk-Auth à nossa API.\n\nIremos mostrar como interpretar os retornos da API Gerencianet de uma maneira bem simples. Assim, você mesmo terá plenas condições de corrigir rapidamente possíveis erros de validação de dados ou outros similares.\n\nA API da Gerencianet efetua a validação dos dados contidos na requisição que seu sistema Mk-Auth envia aos nossos webservices. Dessa forma, não será possível, por exemplo, emitir cobrança para um CPF inválido, para um endereço de e-mail não válido, para um cliente \"sem nome\", etc.\n[block:html]\n{\n  \"html\": \"<p>Para acessar o <em>\\\"Histórico de Requisições\\\"</em>, <a href=\\\"https://gerencianet.com.br/#login\\\" target=\\\"_blank\\\" title=\\\"Link Externo\\\">efetue login</a> em sua conta Gerencianet, acesse o menu superior <code>API</code>, depois clique em <code>Minhas Aplicações > Sua Aplicação</code>. <abbr title=\\\"Produção (ambiente real) e Desenvolvimento (ambiente de testes)\\\">Escolha o ambiente</abbr> (<a href=\\\"https://dev.gerencianet.com.br/docs/glossario\\\" target=\\\"_blank\\\" title=\\\"Link Interno\\\">?</a>) que estiver utilizando (aba <code>Produção</code> ou <code>Desenvolvimento</code>), desça a barra de rolagem e confira a sub-aba <code>Histórico de Requisições</code>.</p>\\n\\n<p>Por fim, basta focar nas requisições que estão com o status \\\"Falha\\\" e cujo webservice (veja na 1ª coluna) termina com a palavra <code>/pay</code> (veja um exemplo <a href=\\\"https://files.readme.io/2249842-02-interpretando-mk-auth.png\\\" alt=\\\"Mk-Auth Gerencianet Histórico de Requisições\\\">nesta imagem</a>). Nestes, clique no ícone de um \\\"olho\\\" (presente na última coluna) para conferir os detalhes.</p>\"\n}\n[/block]\nVamos aos erros mais comuns que observamos, bem como suas devidas explicações:\n\n### Exemplo 1: emissão para CPF incorreto\n\nAo tentar gerar um boleto, os dados cadastrais do cliente cadastrado no Mk-Auth está com o CPF <code>12345678901</code>, porém, este não é um CPF válido e, portanto, a cobrança não será gerada.\n\nEm suma, funciona da seguinte forma: nossa API recebe essa requisição de seu sistema, tentamos processar, mas como é um CPF inválido, não conseguimos emitir a cobrança e a API retorna uma mensagem que pode ser vista justamente no *\"Histórico de Requisições\",* conforme imagem a seguir:\n\n<img src=\"https://files.readme.io/17cf437-01-interpretando-mk-auth.png\" alt=\"Mk-Auth Gerencianet Histórico de Requisições CPF Incorreto\">\n\n<br>\n\nPara corrigir, basta corrigir o CPF de seu cliente dentro do sistema Mk-Auth e tentar novamente gerar a cobrança.\n\n\n### Exemplo 2: mesma emissão para mais de um endereço de e-mail\n\nToda cobrança gerada e que contém o endereço do e-mail do cliente final, a Gerencianet dispara automaticamente para o e-mail informado uma mensagem com a cobrança gerada.\n\nNossa API receberá a requisição de seu sistema, mas deverá conter apenas 1 (um) único endereço de e-mail do cliente final, e não múltiplos e-mails. Caso informe mais de um e-mail, a API retorna uma mensagem que pode ser vista no *\"Histórico de Requisições\",* conforme imagem a seguir:\n\n<img src=\"https://files.readme.io/c24bc43-03-interpretando-mk-auth.png\" alt=\"Mk-Auth Gerencianet Histórico de Requisições CPF Incorreto\">\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c24bc43-03-interpretando-mk-auth.png\",\n        \"03-interpretando-mk-auth.png\",\n        1136,\n        177,\n        \"#dee3e1\"\n      ]\n    }\n  ]\n}\n[/block]\n<br>\n\n# Extras: vídeos oficiais no canal do Mk-Auth no YouTube\n\nOs vídeos abaixo foram extraídos diretamente do <a href=\"https://www.youtube.com/channel/UCn_erBNBVuplfl0Fem7Sdvw/feed\" target=\"_blank\">canal oficial do Mk-Auth no YouTube</a>. O intuito é direcionar os usuários do Mk-Auth para vídeos ensinando a configurar a Gerencianet dentro do sistema, dentre outras especificidades próprias do sistema Mk-Auth.\n\n- <a href=\"https://vimeo.com/253160876\" target=\"_blank\">Como adicionar uma conta Gerencianet dentro de seu sistema Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=duZMxFhzcjA&t=1s\" target=\"_blank\">Configurando conta cartão Gerencianet no Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=qrvKvciBW2c&t=1s\" target=\"_blank\">Alterando layout da central do assinante no Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=mDddmOgU_nY\" target=\"_blank\">Usando leitor de códigos de barras no sistema Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=aU9TPvJy08M\" target=\"_blank\">Configurando a ferramenta de backup no Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=PzF4Li_b6-4\" target=\"_blank\">Instalação do sistema Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=Ye7tVLFt3go\" target=\"_blank\">Registrando o sistema Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=bEhdyKQ1WOg\" target=\"_blank\">Gerando notas fiscais no sistema Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=DXydq_BZS2E\" target=\"_blank\">Configurando os dados da empresa no Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=zpJQbJ_h5Ao\" target=\"_blank\">Configurando servidores externos para envio de SMS no Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=0ZelcgjSwnA\" target=\"_blank\">Configurando páginas de aviso no sistema Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=3fVV_UcWu3M\" target=\"_blank\">Configurando a opção Mensagens Enviadas no sistema Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=HpjD7zki0kE\" target=\"_blank\">Cadastrando clientes no sistema Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=_P5x0hFticI\" target=\"_blank\">Configurando servidores externos para envio de e-mail no Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=Y8SQWdKBu-Y\" target=\"_blank\">Criando plano de internet no sistema Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=6Y3s3a6dAeA\" target=\"_blank\">Update manual no sistema Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=rjjiNwbH6GY\" target=\"_blank\">PPPoE com Mk-Auth</a>\n\n- <a href=\"https://www.youtube.com/watch?v=zkJNUktfG5Y\" target=\"_blank\">Configurar hotspot com radius</a>\n\n<br>\n\n<hr>\n\n# Dúvidas ou Suporte?\n\nMesmo após este tutorial, sua dúvida ainda persiste? Está enfrentando algum problema?\n\nSe o seu problema for relacionado à Gerencianet, <a href=\"https://dev.gerencianet.com.br/docs/fale-conosco\" target=\"_blank\">fale conosco</a> através dos meios oficiais de contato.\n\nCaso seu problema seja relacionado a configurações no Mk-Auth ou algum comportamento inesperado dentro do seu Mk-Auth, sugerimos que entre em contato diretamente com o suporte do Mk-Auth através do fórum oficial no endereço a seguir: <a href=\"http://mk-auth.com.br/forum\" target=\"_blank\">http://mk-auth.com.br/forum</a>","excerpt":"Você está em: *\"Sistemas Integrados > Mk-Auth\"*","slug":"mk-auth","type":"basic","title":"Mk-Auth"}

Mk-Auth

Você está em: *"Sistemas Integrados > Mk-Auth"*

<img src="https://gerencianet.com.br/wp-content/uploads/2015/08/post-1-integra----o-mkauth.jpg" alt="Mk-Auth"> <br> Vá direto ao ponto ­- utilize o índice abaixo e veja diretamente o que você precisa: - [Configurando a Gerencianet no Mk-Auth](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-configurando-a-gerencianet-no-mk-auth) - [Como dar baixa automática (callback) no Mk-Auth?](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-como-dar-baixa-autom-tica-callback-no-mk-auth-) - [Como verificar se a integração está funcionando?](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-como-verificar-se-a-integra-o-est-funcionando-) - [A integração falhou. Como verificar o erro?](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-a-integra-o-falhou-como-verificar-o-erro-) - [Se falhou na emissão da cobrança](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-se-falhou-na-emiss-o-da-cobran-a) - [Se falhou na baixa automática (callback)](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-se-falhou-na-baixa-autom-tica-callback-) - [Pagamento por cartão de crédito (API) no Mk-Auth](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-pagamento-por-cart-o-de-cr-dito-api-no-mk-auth) - [Testando em ambiente de desenvolvimento o pagamento por cartão](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-testando-em-ambiente-de-desenvolvimento-o-pagamento-por-cart-o) - [FAQ: Respostas para as Dúvidas Mais Frequentes](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-faq-respostas-para-as-d-vidas-mais-frequentes) - [Cliente não marcado como inadimplente](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-cliente-n-o-marcado-como-inadimplente) - [Cliente não recebe e-mail de cobrança](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-cliente-n-o-recebe-e-mail-de-cobran-a) - [Cobranças enviadas mensalmente](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-cobran-as-enviadas-mensalmente) - [Como gerar carnês dentro do Mk-Auth?](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-gera-o-de-carn-s) - [Como visualizar na Gerencianet dados da tentativa de criação de cobrança no Mk-Auth](https://dev.gerencianet.com.br/docs/mk-auth#section-como-visualizar-na-gerencianet-dados-da-tentativa-de-cria-o-de-cobran-a-no-mk-auth) - [Extras: vídeos oficiais no canal do Mk-Auth no YouTube](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-extra-v-deos-oficiais-no-canal-do-mk-auth-no-youtube) - [Dúvidas ou Suporte?](https://dev.gerencianet.com.br/v1/docs/mk-auth#section-d-vidas-ou-suporte-) <br> <hr> # Configurando a Gerencianet no Mk-Auth [block:callout] { "type": "info", "title": "NOTA", "body": "Assista o <a href=\"https://vimeo.com/253160876\" target=\"_blank\">vídeo produzido pela equipe oficial do Mk-Auth</a> explicando e mostrando como adicionar uma conta Gerencianet dentro de seu sistema Mk-Auth." } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/488d000-mk-auth-tela-gerencianet.png", "mk-auth-tela-gerencianet.png", 991, 630, "#e8e8e8" ] } ] } [/block] Para facilitar a vida dos nossos clientes que realizam a integração da Gerencianet com outros sistemas, vamos postar dicas e informações sobre os módulos disponíveis na nossa plataforma. Para começar, vamos falar do Mk-Auth. A integração do Mk-Auth é realizada dentro da plataforma da API Gerencianet. Confira o passo a passo: 1. Acesse o menu <code>API > Minhas Aplicações > Nova Aplicação</code>; 2. Informe o nome da integração e ative o <code>Modo de Compatibilidade</code> (<a href="https://files.readme.io/6a8a83b-modo-compatibilidade-mk-auth.png" target="_blank" title="Link Externo">veja onde</a>); 3. Clique em <code>Criar nova aplicação</code>. <br> Em seguida, acesse o Mk-Auth para continuar: 1. Acesse o menu <code>Provedor > Contas bancárias</code> da sua conta no Mk-Auth e clique na botão <code>+</code> (ícone de adição/mais); 2. No campo <code>Escolha o Boleto e Banco</code>, selecione a opção <code>Gateway Gerencianet</code> e cole o token de integração gerado no campo <code>Token</code>; - Caso você for utilizar **apenas emissão de boletos e carnês, não é necessário o preenchimento dos campos** <code>Client ID Produção</code>, <code>Client Secret Produção</code>, <code>Client ID Desenvolvimento</code> e <code>Client Secret Desenvolvimento</code>. <br> 3. O campo <code>título inicial</code> não é obrigatório e pode ser preenchido com o número <code>0</code> (zero). Este campo representa o número da cobrança dentro do Mk-Auth, mas não altera nenhum dado de cobrança no Fortunus. Pronto! A integração está completa. <img src="https://files.readme.io/488d000-mk-auth-tela-gerencianet.png" alt="Mk-Auth Gerencianet Tela"> <br> [block:callout] { "type": "danger", "title": "ATENÇÃO", "body": "Para que a integração funcione, o Mk-Auth deve estar conectado à internet." } [/block] <br> <hr> # Como dar baixa automática (callback) no Mk-Auth? Você ainda pode cadastrar uma URL de callback para que o Mk-Auth realize baixas automáticas sempre que a Gerencianet identificar um pagamento, e uma URL de cancelamento para que o Mk-Auth também realize uma baixa automática sempre que você fizer o cancelamento de uma cobrança na Gerencianet. [block:callout] { "type": "danger", "title": "ATENÇÃO", "body": "Se o cancelamento for realizado no Mk-Auth, a baixa automática não ocorrerá em sua conta Gerencianet." } [/block] Veja como cadastrar as URLS: [block:html] { "html": "<ol>\n\n <li>Acesse o menu <code>API > Minhas Aplicações</code> e selecione sua aplicação;</li><br>\n \n <li>Acesse a aba <code>Callbacks</code>, ative ambos os campos (<a href=\"https://content.screencast.com/users/tiagogerencianet/folders/Jing/media/82315a32-fff3-4ce2-9202-0dfa701bd36d/2018-04-05_1340.png\" target=\"_blank\">veja onde</a>) e cadastre suas URLs seguindo o modelo:\n\n\t<ul>\n <br>\n <li><code>http://SEU_IP:porta/api/fortunus_confirma.php</code>, para confirmação de pagamento;</li><br>\n\n <li><code>http://SEU_IP:porta/api/fortunus_cancela.php</code>, para cancelamento;</li><br>\n\n <li>O IP indicado acima deve ser da conta Mk-Auth. Ele fica disponível no menu <code>Opções > IP do Servidor</code>;</li><br>\n\n <li>Se você utiliza um serviço de DNS Dinâmico (<abbr title=\"Dynamic Domain Name System\">DDNS</abbr>), é possível colocá-lo no lugar de seu IP (inclusive, é uma prática recomendada);</li><br>\n\n <li>Para que a URL de cancelamento seja cadastrada com sucesso, é preciso marcar a opção <code>Cobrança Cancelada</code>, na configuração de callback de sua conta Gerencianet.</li>\n \n </ul>\n \n</ol>" } [/block] Neste mesmo lugar, você pode desativar a URL de notificação quando necessário. [block:callout] { "type": "warning", "title": "IMPORTANTE", "body": "É importante frisar que é possível possuir uma única URL de callback para sua conta Gerencianet. Mesmo que você possua duas ou mais aplicações na API que utilizem o \"modo de compatibilidade\", ou seja, se usa token ao invés de Client_Id e Client_Secret, a URL de callback será sempre a mesma.\n\nPara resolver, é bem simples: em sua conta Gerencianet, acesse <code>Minha conta > Nova conta</code>." } [/block] <br> <hr> # Como verificar se a integração está funcionando? Você pode realizar testes para verificar se a URL está funcionando perfeitamente. Para isto, clique no botão <code>Testar</code>, que fica ao lado da URL de notificação cadastrada em sua conta Gerencianet (<a href="https://content.screencast.com/users/tiagogerencianet/folders/Jing/media/125ac343-46cd-4f20-bec3-c1ebe4588c93/2018-04-05_1413.png" target="_blank">veja onde</a>). Ao clicar no botão, uma requisição é enviada para o Mk-Auth e você recebe uma mensagem informando se o callback está funcionando ou não. Mas para que o callback e a integração funcionem perfeitamente, é importante utilizar a última versão do Mk-Auth. Caso contrário, mesmo que você receba a mensagem com a informação de que o callback está funcionando, o sistema não realizará a baixa automática. Quando a sua URL está configurada corretamente, mas por algum motivo o seu Mk-Auth parou de funcionar ou apresentou problema, sua URL é desativada e as notificações não são enviadas. Quando isso ocorre, você deve ativar novamente a sua URL, testar e, em caso de resposta com sucesso (200), você pode reenviar as notificações de confirmação de pagamento. Para isso, siga o procedimento abaixo: 1. Em sua conta Gerencianet, clique no menu <code>API > Minhas Aplicações</code>, selecione sua aplicação e vá na aba <code>Callbacks</code>; 2. Ao lado da URL de notificação de pagamento cadastrado, clique no botão <code>Logs</code> (<a href="https://content.screencast.com/users/tiagogerencianet/folders/Jing/media/0a8c0228-ef9b-44d0-abb5-51d3902c7db7/2018-04-06_0931.png" target="_blank">veja onde</a>); 3. Selecionar as cobranças que estão com o status <code>Não</code>; 4. Clique em <code>Reenviar callback</code>. [block:callout] { "type": "warning", "title": "IMPORTANTE", "body": "É importante sempre monitorar o status da sua URL de callback." } [/block] <br> <hr> # A integração falhou. Como verificar o erro? ## Se falhou na emissão da cobrança Se mesmo após a integração realizada ocorrer algum erro na emissão da cobrança ou ela não foi gerada em seu Mk-Auth, você pode: ### Alternativa 1: Dentro de seu Mk-Auth, acesse as configurações de sua conta Gerencianet através do menu <code>Provedor</code> e confira se a opção <code>remessa on-line</code> está definida como <code>sim</code>. Essa opção <strong>deve estar marcada</strong> como <code>sim</code> para que seu sistema Mk-Auth envie as cobranças para o webservice da Gerencianet. ### Alternativa 2: Em sua conta Gerencianet, você pode verificar a origem do erro clicando no botão <code>Logs</code> (<a href="https://content.screencast.com/users/tiagogerencianet/folders/Jing/media/0a8c0228-ef9b-44d0-abb5-51d3902c7db7/2018-04-06_0931.png" target="_blank">veja onde</a>), disponível na aba <code>Callbacks</code> em sua aplicação na conta Gerencianet. Os dados da entrada mostram as informações no momento da emissão e os dados de saída mostram se a cobrança foi emitida com sucesso ou, em caso de falha, o campo em que está o erro. A integração funciona para boletos e carnês. Você pode gerar quantos precisar a partir de seu Mk-Auth. **Um erro comum é tentar atrelar boletos gerados em carnês. Essa opção existe no Mk-Auth, mas não funciona para a Gerencianet.** Se deseja criar carnês, utilize a opção de <code>incluir novo carnê</code> para seu cliente. Se ocorrer algum erro na tentativa de emissão e não for gerado um log, você deve conferir as configurações do Mk-Auth. Normalmente, esse erro ocorre quando as informações não estão sendo direcionadas da sua rede para o sistema da Gerencianet. Para ter certeza que a situação é essa, você pode fazer um *traceroute* do seu terminal para o host <code>accounts.gerencianet.com.br</code>. Caso a resposta seja *Tempo limite esgotado*, as informações não estão chegando ao sistema da Gerencianet e você pode verificar o seu DNS (fazer um teste com outro DNS) e as opções de permissão da sua rede. Em seu Mikrotik, você pode ir em <code>IP > Firewall > Filter Rules</code> e verificar se o IP ou bloco de IP da Gerencianet (veja a <a href="https://gerencianet.com.br/artigo/quais-enderecos-de-ip-gerencianet-utiliza/" target="_blank" title="Link Externo">relação das faixas de IP da Gerencianet</a>) está bloqueado e desbloqueá-lo, conforme imagem a seguir: <img src="https://gerencianet.com.br/wp-content/uploads/acervo/post-firewall.png" alt="Firewall Mk-Auth - Gerencianet"> ### Alternativa 3: Se mesmo após a realização dos procedimentos acima você não obter êxito, você pode acrescentar a relação do bloco de IPs utilizados pela Gerencianet. Confira em nossa central de ajuda a <a href="https://gerencianet.com.br/artigo/quais-enderecos-de-ip-gerencianet-utiliza/" target="_blank">relação das faixas de IP da Gerencianet</a>. ### Alternativa 4: Caso os procedimentos acima não solucionem o problema, será necessário descobrir o IP público com o qual o servidor do Mk-Auth do cliente chega na nossa estrutura. Veja abaixo como obtê-lo: [block:html] { "html": "<ul>\n <li>Logar SSH no servidor do Mk-Auth;</li>\n <li>Executar o comando: <code>curl https://api.ipify.org</code></li>\n</ul>" } [/block] Em posse do IP público, <a href="https://gerencianet.com.br/#login" target="_blank" title="Link Externo">efetue login em sua conta Gerencianet</a> e, em seguida, <a href="https://accounts.gerencianet.com.br/faqticket/novoTicket/pagamentos" target="_blank" title="Link Externo">abra um ticket</a> informando o IP e o problema que está enfrentando em seu Mk-Auth. Se você tiver dúvidas sobre as configurações do seu Mikrotik e Mk-Auth que podem estar interferindo na integração, consulte o <a href="http://www.mk-auth.com.br/arquivos/manual.pdf" target="_blank" title="Link Externo">manual de configuração</a>. Caso não consiga configurar as permissões necessárias, contate o suporte do Mk-Auth através do e-mail <code>suporte@mk-auth.com.br</code> ou no <a href="http://mk-auth.com.br/forum" target="_blank">fórum oficial do Mk-Auth</a>. ### Ainda ficou com alguma dúvida? Caso não consiga configurar as permissões necessárias, contate o suporte do Mk-Auth através do e-mail <code>suporte@mk-auth.com.br</code> ou no <a href="http://mk-auth.com.br/forum" target="_blank">fórum oficial do Mk-Auth</a>. <br> <hr> ## Se falhou na baixa automática (callback) Se após a realização do reenvio de notificação (callback) o sistema retornar que sua URL é inválida ou se seu sistema Mk-Auth não está realizando as baixas automáticas, você pode: ### Alternativa 1: Você pode fazer um teste colando a URL em seu navegador de internet e tentar acessar. Se a página não for encontrada, alguma informação está incorreta e você deve verificar os dados informados e tentar novamente. Se você não receber uma resposta de êxito (200) ou receber a resposta e mesmo assim o sistema informar que a URL está inválida, é necessário configurar a permissão na sua rede para que a Gerencianet acesse a URL e notifique o seu Mk-Auth. Na URL de confirmação de pagamento (<code>http://SEU_IP:porta/api/fortunus_confirma.php</code>) ou de cancelamento (<code>http://SEU_IP:porta/api/fortunus_cancela.php</code>) você deve informar a porta de sua escolha para o acesso da Gerencianet. Caso não saiba qual liberar, utilize a porta <code>80</code> ou <code>443</code>, que são as padrões. ### Alternativa 2: Dentro de seu Mk-Auth, acesse as configurações de sua conta Gerencianet através do menu <code>Provedor</code> e confira se a opção <code>auto baixar</code> está definida como <code>sim</code>. Essa opção <strong>deve estar marcada</strong> como <code>sim</code> para que a baixa automática dos títulos em seu Mk-Auth seja realizada. ### Alternativa 3: Se mesmo após a realização dos procedimentos acima você não obter êxito, você pode acrescentar a relação do bloco de IPs utilizados pela Gerencianet. Confira em nossa central de ajuda a <a href="https://gerencianet.com.br/artigo/quais-enderecos-de-ip-gerencianet-utiliza/" target="_blank">relação das faixas de IP da Gerencianet</a>. ### Ainda ficou com alguma dúvida? Caso não consiga configurar as permissões necessárias, contate o suporte do Mk-Auth através do e-mail <code>suporte@mk-auth.com.br</code> ou no <a href="http://mk-auth.com.br/forum" target="_blank">fórum oficial do Mk-Auth</a>. <br> <hr> # Pagamento por cartão de crédito (API) no Mk-Auth Para que seja possível o cliente pagar com cartão de crédito na central do assinante, basta informar as chaves Client_Id e Client_Secret de sua API Gerencianet e ativar a segunda via na central do assinante. ## Testando em ambiente de desenvolvimento o pagamento por cartão É importante frisar que não é recomendável realizar testes em ambiente de produção, mas sim, em ambiente de desenvolvimento (testes). Para tal, basta que você faça uso de algum dos cartões de crédito *fictícios* abaixo em seu Mk-Auth. Somente depois de testar e assegurar que o funcionamento está adequado, é que você deve alterar seu ambiente para "Produção". [block:code] { "codes": [ { "code": "Número de cartão Visa:\n4012001038443335\n\nNúmero de cartão Mastercard:\n5453010000066167\n\nNúmero de cartão Amex (American Express):\n376449047333005\n\nNúmero de cartão Elo:\n6362970000457013\n\nNúmero de cartão Diners:\n36490102462661\n\nTodos com validade até:\n05/2018\n\nCódigo de Segurança (CVV):\n123\n\n\n// todos os cartões a seguir são fictícios e usados exclusivamente para que seu Mk-Auth trabalhe com o ambiente de testes da API Gerencianet\n\n// fonte das informações: http://mk-auth.com.br/forum/topics/duvida-sobre-conta-de-cart-o", "language": "text" } ] } [/block] <br> [block:callout] { "type": "warning", "title": "IMPORTANTE", "body": "É necessário ter internet no servidor do Mk-Auth. Importante lembrar que transações por cartão de crédito na internet passam por uma série de verificações e análises de mecanismos anti-fraude." } [/block] A equipe do suporte do Mk-Auth gravou um vídeo e disponibilizou no YouTube ensinando a configurar o Mk-Auth de forma a permitir o pagamento de clientes por cartão de crédito. <a href="https://www.youtube.com/watch?v=duZMxFhzcjA" target="_blank" title="Link Externo">Confira o vídeo através deste link</a> ou assista abaixo: [block:html] { "html": "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/duZMxFhzcjA\" frameborder=\"0\" allow=\"autoplay; encrypted-media\" allowfullscreen></iframe>" } [/block] <br> <hr> # FAQ: Respostas para as Dúvidas Mais Frequentes Confira as respostas para as perguntas e dúvidas mais frequentes apontadas por nossos clientes que fazem uso do sistema Mk-Auth. ## Cliente não marcado como inadimplente Alguns usuários questionam que seus clientes não estão em dia com a mensalidade, mas não estão marcados como inadimplentes no sistema. Isso pode acontecer se o boleto for enviado com o recurso “contra-apresentação”. Esse recurso é utilizado para que o boleto não tenha uma data de pagamento específica, ou seja, o cliente nunca estará inadimplente. Da mesma forma, não será cobrado juros e multas dessa cobrança. Veja como conferir se a opção está marcada: 1. Entre no menu <code>Provedor</code> da sua conta Mk-Auth; 2. Na opção <code>Contas Bancárias</code>, escolha a conta que deseja alterar e clique em <code>Alterar</code>; 3. Verifique se a opção <code>Contra Apresentação</code> está marcada como <code>Sim</code>. Para desativar, basta mudar a chave para a opção <code>Não</code>. <img src="https://gerencianet.com.br/wp-content/uploads/2016/04/imagem-post-mkauth-2.png" alt="Mk-Auth Gerencianet - Cliente não marcado como inadimplente"> <br> É preciso verificar a configuração antes da emissão da cobrança. Caso esteja marcada como <code>Sim</code>, o boleto será enviado sem data de vencimento e poderá ser pago a qualquer momento e em qualquer local sem a cobrança de juros e multas. <br> <hr> ## Cliente não recebe e-mail de cobrança Se você está gerando um boleto, mas seu cliente não recebe por e-mail, pode ser: ### Alternativa 1: Pode ser que a tag <code>e-mail</code> da sua conta Gerencianet esteja vazia. Para verificar se o e-mail está sendo enviado pelo Mk-Auth e atualizar as configurações, siga os passos abaixo: 1. No menu <code>Boletos e Carnês</code> da sua conta Gerencianet, acesse <code>Integrações</code>; 2. No campo <code>Token de Integração</code>, clique no <code>Log</code> referente à integração do Mk-Auth; 3. Clique na cobrança que deseja verificar; 4. Em <code>Dados de Entrada</code>, verifique se o campo <code>tag e-mail</code> está preenchido corretamente. ### Alternativa 2: Caso o e-mail do cliente não esteja especificado, acesse sua conta Mk-Auth para liberar a informação do e-mail do cliente: 1. Acesse <code>Configurar Recursos</code> do menu <code>Opções</code> da conta Mk-Auth; 2. Em <code>repassar o e-mail do clientes</code>, escolha o campo <code>Sim</code>. <img src="https://gerencianet.com.br/wp-content/uploads/2016/04/post-mk-auth-imagem-e-mail-e1461152647425-1024x520.png" alt="Mk-Auth Gerencianet - Cliente não recebe e-mail de cobrança"> <br> Pronto! Todas as cobranças enviadas após o ajuste na configuração serão enviados para o e-mail do cliente. ### Alternativa 3: Alguns clientes finais têm problema para receber e-mail da Gerencianet. Isso acontece, na maioria das vezes, por filtros criados pelo próprio destinatário. Devido a isso, listamos os principais motivos que podem prejudicar a entrega de e-mails e como evitá-los. Confira abaixo dois artigos em nosso blog que poderão ajudá-lo: - <a href="https://gerencianet.com.br/blog/cliente-tem-problema-para-receber-e-mails-da-gerencianet/" target="_blank">Seu cliente tem problema para receber e-mails da Gerencianet? Veja o que fazer</a> - <a href="https://gerencianet.com.br/blog/marcar-e-mail-da-gerencianet-confiavel/" target="_blank">Como marcar o e-mail da Gerencianet como confiável?</a> ### Ainda ficou com alguma dúvida? Caso não consiga configurar as permissões necessárias, contate o suporte do Mk-Auth através do e-mail <code>suporte@mk-auth.com.br</code> ou no <a href="http://mk-auth.com.br/forum" target="_blank">fórum oficial do Mk-Auth</a>. <br> <hr> ## Cobranças enviadas mensalmente Muitos clientes emitem uma cobrança no Mk-Auth e não reparam que a opção <code>Auto-lançamento</code> está ativada. Dessa forma, o cliente final passa a receber o boleto mensalmente. Veja como conferir se a opção está ativada: 1. Acesse o menu <code>Opções</code> e, em seguida, clique em <code>Configurar Recursos</code>; 2. Em <code>Gerador de Títulos</code>, verifique se no campo <code>Auto Lançamento</code> contém o número <code>1</code>; 3. Em seguida, confira se a opção <code>Manter Títulos</code> está marcada como <code>Sim</code>. <img src="https://gerencianet.com.br/wp-content/uploads/2016/04/imagem-post-mkauth.png" alt="Mk-Auth Gerencianet - Cobranças enviadas mensalmente"> <br> Quando você mantem a opção de manter títulos marcada como <code>Sim</code>, o sistema já cria a próxima cobrança assim que recebe a anterior e envia para seu cliente com antecedência. Para enviar apenas uma cobrança, é importante marcar a opção <code>Não</code>. <br> <hr> ## Como gerar carnês dentro do Mk-Auth? Veja como gerar carnês diretamente do MK-Auth: 1. Acesse o menu <code>Clientes</code>; 2. Em seguida, clique na seção <code>Detalhes</code>; 3. Em <code>Emissão de carnês</code>, clique no botão <code>+</code>; 4. Informe os dados para geração do carnê. <img src="https://gerencianet.com.br/wp-content/uploads/2016/04/blog-mk-auth-2.png" alt="Mk-Auth Gerencianet - Geração de carnês"> ### Ainda ficou com alguma dúvida? Caso não consiga configurar as permissões necessárias, contate o suporte do Mk-Auth através do e-mail <code>suporte@mk-auth.com.br</code> ou no <a href="http://mk-auth.com.br/forum" target="_blank">fórum oficial do Mk-Auth</a>. <br> <hr> ## Como visualizar na Gerencianet dados da tentativa de criação de cobrança no Mk-Auth Um recurso de extrema importância é o *"Histórico de Requisições",* que permite ao cliente Gerencianet visualizar todas as requisições realizadas pelo seu Mk-Auth à nossa API. Iremos mostrar como interpretar os retornos da API Gerencianet de uma maneira bem simples. Assim, você mesmo terá plenas condições de corrigir rapidamente possíveis erros de validação de dados ou outros similares. A API da Gerencianet efetua a validação dos dados contidos na requisição que seu sistema Mk-Auth envia aos nossos webservices. Dessa forma, não será possível, por exemplo, emitir cobrança para um CPF inválido, para um endereço de e-mail não válido, para um cliente "sem nome", etc. [block:html] { "html": "<p>Para acessar o <em>\"Histórico de Requisições\"</em>, <a href=\"https://gerencianet.com.br/#login\" target=\"_blank\" title=\"Link Externo\">efetue login</a> em sua conta Gerencianet, acesse o menu superior <code>API</code>, depois clique em <code>Minhas Aplicações > Sua Aplicação</code>. <abbr title=\"Produção (ambiente real) e Desenvolvimento (ambiente de testes)\">Escolha o ambiente</abbr> (<a href=\"https://dev.gerencianet.com.br/docs/glossario\" target=\"_blank\" title=\"Link Interno\">?</a>) que estiver utilizando (aba <code>Produção</code> ou <code>Desenvolvimento</code>), desça a barra de rolagem e confira a sub-aba <code>Histórico de Requisições</code>.</p>\n\n<p>Por fim, basta focar nas requisições que estão com o status \"Falha\" e cujo webservice (veja na 1ª coluna) termina com a palavra <code>/pay</code> (veja um exemplo <a href=\"https://files.readme.io/2249842-02-interpretando-mk-auth.png\" alt=\"Mk-Auth Gerencianet Histórico de Requisições\">nesta imagem</a>). Nestes, clique no ícone de um \"olho\" (presente na última coluna) para conferir os detalhes.</p>" } [/block] Vamos aos erros mais comuns que observamos, bem como suas devidas explicações: ### Exemplo 1: emissão para CPF incorreto Ao tentar gerar um boleto, os dados cadastrais do cliente cadastrado no Mk-Auth está com o CPF <code>12345678901</code>, porém, este não é um CPF válido e, portanto, a cobrança não será gerada. Em suma, funciona da seguinte forma: nossa API recebe essa requisição de seu sistema, tentamos processar, mas como é um CPF inválido, não conseguimos emitir a cobrança e a API retorna uma mensagem que pode ser vista justamente no *"Histórico de Requisições",* conforme imagem a seguir: <img src="https://files.readme.io/17cf437-01-interpretando-mk-auth.png" alt="Mk-Auth Gerencianet Histórico de Requisições CPF Incorreto"> <br> Para corrigir, basta corrigir o CPF de seu cliente dentro do sistema Mk-Auth e tentar novamente gerar a cobrança. ### Exemplo 2: mesma emissão para mais de um endereço de e-mail Toda cobrança gerada e que contém o endereço do e-mail do cliente final, a Gerencianet dispara automaticamente para o e-mail informado uma mensagem com a cobrança gerada. Nossa API receberá a requisição de seu sistema, mas deverá conter apenas 1 (um) único endereço de e-mail do cliente final, e não múltiplos e-mails. Caso informe mais de um e-mail, a API retorna uma mensagem que pode ser vista no *"Histórico de Requisições",* conforme imagem a seguir: <img src="https://files.readme.io/c24bc43-03-interpretando-mk-auth.png" alt="Mk-Auth Gerencianet Histórico de Requisições CPF Incorreto"> [block:image] { "images": [ { "image": [ "https://files.readme.io/c24bc43-03-interpretando-mk-auth.png", "03-interpretando-mk-auth.png", 1136, 177, "#dee3e1" ] } ] } [/block] <br> # Extras: vídeos oficiais no canal do Mk-Auth no YouTube Os vídeos abaixo foram extraídos diretamente do <a href="https://www.youtube.com/channel/UCn_erBNBVuplfl0Fem7Sdvw/feed" target="_blank">canal oficial do Mk-Auth no YouTube</a>. O intuito é direcionar os usuários do Mk-Auth para vídeos ensinando a configurar a Gerencianet dentro do sistema, dentre outras especificidades próprias do sistema Mk-Auth. - <a href="https://vimeo.com/253160876" target="_blank">Como adicionar uma conta Gerencianet dentro de seu sistema Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=duZMxFhzcjA&t=1s" target="_blank">Configurando conta cartão Gerencianet no Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=qrvKvciBW2c&t=1s" target="_blank">Alterando layout da central do assinante no Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=mDddmOgU_nY" target="_blank">Usando leitor de códigos de barras no sistema Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=aU9TPvJy08M" target="_blank">Configurando a ferramenta de backup no Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=PzF4Li_b6-4" target="_blank">Instalação do sistema Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=Ye7tVLFt3go" target="_blank">Registrando o sistema Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=bEhdyKQ1WOg" target="_blank">Gerando notas fiscais no sistema Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=DXydq_BZS2E" target="_blank">Configurando os dados da empresa no Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=zpJQbJ_h5Ao" target="_blank">Configurando servidores externos para envio de SMS no Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=0ZelcgjSwnA" target="_blank">Configurando páginas de aviso no sistema Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=3fVV_UcWu3M" target="_blank">Configurando a opção Mensagens Enviadas no sistema Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=HpjD7zki0kE" target="_blank">Cadastrando clientes no sistema Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=_P5x0hFticI" target="_blank">Configurando servidores externos para envio de e-mail no Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=Y8SQWdKBu-Y" target="_blank">Criando plano de internet no sistema Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=6Y3s3a6dAeA" target="_blank">Update manual no sistema Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=rjjiNwbH6GY" target="_blank">PPPoE com Mk-Auth</a> - <a href="https://www.youtube.com/watch?v=zkJNUktfG5Y" target="_blank">Configurar hotspot com radius</a> <br> <hr> # Dúvidas ou Suporte? Mesmo após este tutorial, sua dúvida ainda persiste? Está enfrentando algum problema? Se o seu problema for relacionado à Gerencianet, <a href="https://dev.gerencianet.com.br/docs/fale-conosco" target="_blank">fale conosco</a> através dos meios oficiais de contato. Caso seu problema seja relacionado a configurações no Mk-Auth ou algum comportamento inesperado dentro do seu Mk-Auth, sugerimos que entre em contato diretamente com o suporte do Mk-Auth através do fórum oficial no endereço a seguir: <a href="http://mk-auth.com.br/forum" target="_blank">http://mk-auth.com.br/forum</a>