{"_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","githubsync":"","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-02-08T13:02:19.941Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":11,"body":"<img src=\"https://files.readme.io/4472138-mkauth_preview.png\" alt=\"Mk-Auth\">\n\nA utilização da Gerencianet dentro do sistema Mk-Auth pode ser realizada por meio de duas modalidades: Fortunus (solução antiga e em desuso) e API (solução atual). Confira as características:\n\n1. **Através do Fortunus:** integração por \"token único\". Solução mais antiga da Gerencianet para a emissão de boletos e carnês, cujos consumos dos webservices são realizados a partir do envio de um XML via post. **Está em desuso e recomenda-se a utilização da API. Caso necessite da documentação de uso da Gerencianet no Mk-Auth com versões anteriores a <code>18.01</code>, <a href=\"https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/09/13131431/Mk-Auth_Documentacao_Anterior.pdf\" target=\"_blank\">consulte este link</a>.**\n\n2. **Através da API:** integração via API com chaves \"Client_Id\" e \"Client_Secret\". Esta é a solução indicada para uso no Mk-Auth a partir da versão <code>18.01</code>. **Indicada para toda utilização no Mk-Auth. Permite gerar boletos e carnês, além da possibilidade de pagamentos com cartão de crédito.**\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"IMPORTANTE\",\n  \"body\": \"**Recomenda-se o uso da API no Mk-Auth.** Para utilizá-la, acesse em seu Mk-Auth a opção <code>Provedor > Contas Bancárias</code> e, em <code>Banco / Gateway</code>, selecione <code>GERENCIANET.API BOLETO</code> (<a href=\\\"https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13165827/Mk-Auth_Gerencianet-API-Boleto.png\\\" target=\\\"_blank\\\">veja onde</a>).\\n\\nImportante ressaltar que a API da Gerencianet é RESTful e as requisições/respostas são em JSON, que é um padrão tecnológico de ponta utilizado no mercado. Além disso, novos endpoints (serviços) são oferecidos apenas na API.\"\n}\n[/block]\n<hr>\n\nVá direto ao ponto - utilize o índice para encontrar a resposta de maneira mais eficiente:\n\n1. [Configurando o Mk-Auth com a API Gerencianet](https://dev.gerencianet.com.br/docs/mk-auth#section-1-configurando-o-mk-auth-com-a-api-gerencianet)\n\n2. [Criar títulos avulsos no Mk-Auth utilizando a API Gerencianet](https://dev.gerencianet.com.br/docs/mk-auth#section-2-criar-t-tulos-avulsos-no-mk-auth-utilizando-a-api-gerencianet)\n\n3. [Criar carnês no Mk-Auth utilizando a API Gerencianet](https://dev.gerencianet.com.br/docs/mk-auth#section-3-criar-carn-s-no-mk-auth-utilizando-a-api-gerencianet)\n\n4. [Como dar baixa automática (callback) no Mk-Auth?](https://dev.gerencianet.com.br/docs/mk-auth#section-4-como-dar-baixa-autom-tica-callback-no-mk-auth-)\n\n5. [Respostas para as dúvidas mais comuns](https://dev.gerencianet.com.br/docs/mk-auth#section-5-respostas-para-as-d-vidas-mais-comuns)\n\n    - 5.1) [A integração falhou na emissão da cobrança](https://dev.gerencianet.com.br/docs/mk-auth#section-5-1-a-integra-o-falhou-na-emiss-o-da-cobran-a)\n\n    - 5.2) [A integração falhou na baixa automática (callback)](https://dev.gerencianet.com.br/docs/mk-auth#section-5-2-a-integra-o-falhou-na-baixa-autom-tica-callback-)\n\n    - 5.3) [No Histórico de Notificações da API Gerencianet está exibindo \"Falha\"](https://dev.gerencianet.com.br/docs/mk-auth#section-5-3-no-hist-rico-de-notifica-es-da-api-gerencianet-est-exibindo-falha-)\n\n    - 5.4) [Pagamento por cartão de crédito no Mk-Auth](https://dev.gerencianet.com.br/docs/mk-auth#section-5-4-pagamento-por-cart-o-de-cr-dito-no-mk-auth)\n\n    - 5.5) [Cliente não marcado como inadimplente](https://dev.gerencianet.com.br/docs/mk-auth#section-5-5-cliente-n-o-marcado-como-inadimplente)\n\n    - 5.6) [Cliente não recebe e-mail de cobrança da Gerencianet](https://dev.gerencianet.com.br/docs/mk-auth#section-5-6-cliente-n-o-recebe-e-mail-de-cobran-a-da-gerencianet)\n\n    - 5.7) [Resolvendo problemas em requisições Mk-Auth para a API](https://dev.gerencianet.com.br/docs/mk-auth#section-5-7-resolvendo-problemas-em-requisi-es-mk-auth-para-a-api)\n\n6. [Extras: vídeos oficiais no canal do Mk-Auth no YouTube](https://dev.gerencianet.com.br/docs/mk-auth#section-6-extras-v-deos-oficiais-no-canal-do-mk-auth-no-youtube)\n\n7. [Dúvidas ou Suporte?](https://dev.gerencianet.com.br/docs/mk-auth#section-7-d-vidas-ou-suporte-)\n\n<hr>\n\n# 1. Configurando o Mk-Auth com a API Gerencianet\n\nPara auxiliar os clientes que desejam utilizar a Gerencianet no sistema Mk-Auth, disponibilizamos explicações sobre como configurar seu sistema Mk-Auth para emitir cobranças registradas pela API da Gerencianet.\n\nConfira o passo a passo:\n\n1. Faça login em sua conta Gerencianet, acesse o menu <code>API > Minhas Aplicações</code> e clique em <code>Nova Aplicação</code>;\n\n2. Informe o nome da integração (exemplo: <code>Mk-Auth</code>) e clique em <code>Criar nova aplicação</code> (<a href=\"https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13162036/Mk-Auth-Nova-Aplicacao.png\" target=\"_blank\">veja onde</a>).\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"ATENÇÃO\",\n  \"body\": \"Ao criar sua aplicação, deixe o \\\"modo de compatibilidade\\\" como **DESATIVADO**.\"\n}\n[/block]\nAgora, vamos acessar o Mk-Auth para realizar algumas configurações:\n\n<br>\n\n<img src=\"https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/09/12195516/mk-auth-contas-bancarias.png\" alt=\"Configurações Gerencianet no sistema Mk-Auth 18.01\"><br>\n\nVamos configurar as credenciais de sua conta Gerencianet dentro do seu sistema Mk-Auth. Veja a seguir a explicação de campo a campo:\n\n1. Acesse o menu <code>Provedor > Contas bancárias</code> em seu Mk-Auth e clique no botão <code>+</code> (<a href=\"https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13165435/provedor_contas_Mk-Auth_Gerencianet.png\" target=\"_blank\">veja onde</a>);\n\n2. No campo <code>Banco / Gateway</code>, selecione a opção <code>GERENCIANET.API BOLETO</code> (<a href=\"https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13165827/Mk-Auth_Gerencianet-API-Boleto.png\" target=\"_blank\">veja onde</a>) e preencha os campos abaixo:\n\n- <code>Nome da conta</code>: informe um nome para que você possa identificar em seu Mk-Auth (será listado em *Provedor > Contas Bancárias*). Escreva, por exemplo, <code>Boletos Gerencianet</code>;\n\n- <code>Identificador da conta</code>: código identificador da conta Gerencianet, único por conta. Confira onde localizá-lo, de acordo com o layout de sua plataforma - <a href=\"https://gerencianet.com.br/wp-content/uploads/2017/10/payee_code_n.png\" target=\"_blank\">opção 1</a> ou <a href=\"https://gerencianet.com.br/wp-content/uploads/2017/10/payee_code_p.png\" target=\"_blank\">opção 2</a>;\n\n- <code>Client ID Produção</code>: informe sua chave <code>Client_Id</code> do ambiente de produção. Para localizar, acesse *API > Minhas Aplicações > Sua Aplicação*, e copie na íntegra a chave <code>Client_Id</code> da aba <code>Produção</code> (<a href=\"https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13171115/Mk-Auth_Client-ID-Producao.png\" target=\"_blank\">veja onde</a>);\n\n- <code>Client Secret Produção</code>: informe sua chave <code>Client_Secret</code> do ambiente de produção. Para localizar, acesse *API > Minhas Aplicações > Sua Aplicação*, e copie na íntegra a chave <code>Client_Secret</code> da aba <code>Produção</code> (<a href=\"https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13171841/Mk-Auth_Client-Secret-Producao.png\" target=\"_blank\">veja onde</a>);\n\n- <code>Client ID Desenvolvimento</code>: informe sua chave <code>Client_Id</code> do ambiente de desenvolvimento. Para localizar, acesse *API > Minhas Aplicações > Sua Aplicação*, e copie na íntegra a chave <code>Client_Id</code> da aba <code>Desenvolvimento</code> (<a href=\"https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13172308/Mk-Auth_Client-ID-Desenvolvimento.png\" target=\"_blank\">veja onde</a>);\n\n- <code>Client Secret Desenvolvimento</code>: informe sua chave <code>Client_Secret</code> do ambiente de desenvolvimento. Para localizar, acesse *API > Minhas Aplicações > Sua Aplicação*, e copie na íntegra a chave <code>Client_Secret</code> da aba <code>Desenvolvimento</code> (<a href=\"https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13172518/Mk-Auth_Client-Secret-Desenvolvimento.png\" target=\"_blank\">veja onde</a>);\n\n- <code>URL de retorno</code>: refere-se ao endereço (URL) de callback/notificação. Deve ser informado no formato <code>http://url.do.mk-auth/retorno/gerencianet_confirma.php</code>, alterando <code>url.do.mk-auth</code> para o IP ou host de seu servidor. O IP deve ser da conta Mk-Auth, disponível em <code>Opções > IP do Servidor</code>. Se você utiliza um serviço de DNS Dinâmico (DDNS), é possível colocá-lo no lugar de seu IP (inclusive, é uma prática recomendada). Não se esqueça de informar o protocolo *http* ou *https* antes do endereço, além da porta (caso utilizar);\n\n- <code>Repassar e-mail do cliente</code>: indica se o Mk-Auth deverá associar o e-mail do cliente final na emissão da cobrança para a Gerencianet. Se marcado como <code>Sim</code>, a Gerencianet enviará automaticamente o e-mail com a cobrança e aviso de inadimplência; se marcado como <code>Não</code>, a Gerencianet não irá disparar nenhum e-mail ao cliente final.\n\n<br>\n\nPor fim, vamos prosseguir definindo as configurações de multa e juros por dia se pago após o vencimento. Em seu Mk-Auth, você pode preencher os dois campos a seguir:\n\n- <code>Percentual multa</code>: refere-se a valor da multa se pago após o vencimento. Geralmente este valor é configurado como <code>2,00</code>, que equivale a 2%. O valor não pode ser superior a <code>1000</code> (10%);\n\n- <code>Percentual juros dia</code>: refere-se aos juros por dia de atraso se pago após o vencimento. Geralmente este valor é configurado como <code>0,03</code>, que equivale a 0,003%. O valor não pode ser superior a <code>330</code> (0,33%).\n\n<br>\n\nPronto! A integração está realizada. Os demais campos são relacionados a configurações específicas que você pode definir em seu sistema Mk-Auth.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"IMPORTANTE\",\n  \"body\": \"- Para que a integração funcione, o Mk-Auth deve estar conectado à internet. Além disso, o serviço de DNS deve estar configurado e funcionando em seu Mk-Auth.\\n\\n- Caso queira, 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- Estas explicações foram baseadas na versão 18.01 do sistema Mk-Auth.\"\n}\n[/block]\n<br>\n<hr>\n\n# 2. Criar títulos avulsos no Mk-Auth utilizando a API Gerencianet\n\nPara emitir boletos avulsos para seus clientes, você precisará definir em seu Mk-Auth os clientes que deseja que os títulos sejam cobranças avulsas, e não carnês. Isso será realizado em seu Mk-Auth, dentro do financeiro do cliente.\n\n### Para alterar individualmente por cliente:\n\n1. Em seu Mk-Auth, acesse <code>Clientes > Listar Todos Clientes</code>;\n\n2. Escolha o cliente que deseja alterar para cobrança avulsa e clique em <code>Alterar</code>;\n\n3. Acesse a aba <code>Financeiro</code> e, no campo <code>Tipo de cobrança</code>, selecione <code>Título</code> e clique em <code>Gravar</code>.\n\n### Para alterar em massa para vários clientes:\n\n1. Em seu Mk-Auth, acesse <code>Clientes > Listar Todos Clientes</code>;\n\n2. Selecione os checkboxes dos clientes que deseja alterar para cobrança avulsa, clique no ícone azul de <em>alterar clientes</em> e, por fim, clique em <code>Ok</code>;\n\n3. Desça a barra de rolagem e no campo <code>Tipo de cobrança</code>, selecione <code>Título</code> e clique em <code>Enviar</code>.\n\n### Ao cadastrar o cliente no Mk-Auth:\n\n1. Em seu Mk-Auth, acesse <code>Clientes > Inserir Novo Cliente</code>;\n\n    - Você também pode ir em <code>Clientes > Listar Todos Clientes</code> e clicar no botão <code>+</code>\n<br>\n2. Informe os dados cadastrais do cliente e clique na aba <code>Financeiro</code>;\n\n3. No campo <code>Tipo de cobrança</code>, selecione <code>Título</code> e clique em <code>Gravar</code>.\n\n<br>\n\nNote que o sistema Mk-Auth oferece uma série de opções nesta aba <code>Financeiro</code> que você pode explorar e utilizar.\n\n<br>\n\n**Por fim, para emitir cobranças avulsas em seu Mk-Auth, siga as instruções:**\n\n1. Em seu Mk-Auth, acesse <code>Clientes > Listar Todos Clientes</code>;\n\n2. Abaixo do nome do cliente, clique em <code>Detalhes</code>;\n\n3. Para emitir cobranças avulsas, clique no botão <code>+</code> logo abaixo do título <code>Titulos avulsos</code>.\n\n<br>\n<hr>\n\n# 3. Criar carnês no Mk-Auth utilizando a API Gerencianet\n\nPara emitir carnês para seus clientes, você precisará definir em seu Mk-Auth os clientes que deseja que os títulos sejam carnês, e não boletos avulsos. Isso será realizado em seu Mk-Auth, dentro do financeiro do cliente.\n\n### Para alterar individualmente por cliente:\n\n1. Em seu Mk-Auth, acesse <code>Clientes > Listar Todos Clientes</code>;\n\n2. Escolha o cliente que deseja alterar para carnê e clique em <code>Alterar</code>;\n\n3. Acesse a aba <code>Financeiro</code> e, no campo <code>Tipo de cobrança</code>, selecione <code>Carnê</code> e clique em <code>Gravar</code>.\n\n### Para alterar em massa para vários clientes:\n\n1. Em seu Mk-Auth, acesse <code>Clientes > Listar Todos Clientes</code>;\n\n2. Selecione os checkboxes dos clientes que deseja alterar para carnê, clique no ícone azul de <em>alterar clientes</em> e, por fim, clique em <code>Ok</code>;\n\n3. Desça a barra de rolagem e no campo <code>Tipo de cobrança</code>, selecione <code>Carnê</code> e clique em <code>Enviar</code>.\n\n### Ao cadastrar o cliente no Mk-Auth:\n\n1. Em seu Mk-Auth, acesse <code>Clientes > Inserir Novo Cliente</code>;\n\n    - Você também pode ir em <code>Clientes > Listar Todos Clientes</code> e clicar no botão <code>+</code>\n<br>\n2. Informe os dados cadastrais do cliente e clique na aba <code>Financeiro</code>;\n\n3. No campo <code>Tipo de cobrança</code>, selecione <code>Carnê</code> e clique em <code>Gravar</code>.\n\n<br>\n\nNote que o sistema Mk-Auth oferece uma série de opções nesta aba <code>Financeiro</code> que você pode explorar e utilizar.\n\n<br>\n\n**Por fim, para emitir carnês em seu Mk-Auth, siga as instruções:**\n\n1. Em seu Mk-Auth, acesse <code>Clientes > Listar Todos Clientes</code>;\n\n2. Abaixo do nome do cliente, clique em <code>Detalhes</code>;\n\n3. Para emitir cobranças avulsas, clique no botão <code>+</code>, localizado mais abaixo do título <code>Carnê atual</code>.\n\n<br>\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"ATENÇÃO, ESTEJA CIENTE\",\n  \"body\": \"O sistema Mk-Auth (versão 18.01) utiliza o endpoint <code>POST /charge/:id/pay</code> como sendo de carnês. Isso significa que, por exemplo, se você gera um carnê de 12 parcelas, seu sistema enviará 12 requisições <code>POST</code> para a rota <code>/charge/:id/pay</code> para que a Gerencianet retorne as 12 cobranças.\\n\\nConsiderando que cada requisição realizada equivale a 1 consumo, o limite de emissões para um mesmo cliente é 13 requisições diárias e/ou 30 mensais. Neste caso, **restará apenas 1 cobrança que poderá ser gerada no mesmo dia para este cliente.**\\n\\n(+) Para saber mais sobre o limite de emissões diárias e/ou mensais excedido, <a href=\\\"https://gerencianet.com.br/artigo/apos-emitir-algumas-cobrancas-esta-retornando-limite-de-emissoes-diarias-excedido-como-resolver/\\\" target=\\\"_blank\\\" title=\\\"Link Externo\\\">veja em nossa FAQ</a>.\"\n}\n[/block]\n<br>\n<hr>\n\n# 4. Como dar baixa automática (callback) no Mk-Auth?\n\nA partir da versão 18.01, o Mk-Auth incluiu o recurso \"URL de notificação\" oferecido pela API Gerencianet. Uma das vantagens deste recurso é que o integrador **passa a ser notificado em seu Mk-Auth sobre qualquer mudança no status da cobrança** (se ela foi paga, cancelada, se está inadimplente, etc).\n\nPara utilizar este recurso, você deverá informar uma URL válida ao cadastrar a conta Gerencianet dentro de seu Mk-Auth. Isto é realizado no campo <code>URL de retorno</code> e deverá estar no formato <code>http://url.do.mk-auth/retorno/gerencianet_confirma.php</code>, alterando <code>url.do.mk-auth</code> para o IP ou host de seu servidor.\n\nO IP deve ser da conta Mk-Auth, disponível em <code>Opções > IP do Servidor</code>. Se você utiliza um serviço de DNS Dinâmico (DDNS), é possível colocá-lo no lugar de seu IP **(inclusive, é uma prática recomendada).**\n\nNão se esqueça de informar o protocolo http ou https antes do endereço, além da porta (caso utilize).\n\nPara saber detalhes, veja em [Configurando a API Gerencianet no Mk-Auth](https://dev.gerencianet.com.br/docs/mk-auth#section-1-configurando-o-mk-auth-com-a-api-gerencianet).\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"IMPORTANTE\",\n  \"body\": \"Algumas aplicações e serviços filtram nossas comunicações por meio dos nossos endereços de IP.\\nConfira <a href=\\\"https://gerencianet.com.br/artigo/quais-enderecos-de-ip-gerencianet-utiliza/\\\" target=\\\"_blank\\\" title=\\\"Link Externo\\\">a lista dos endereços utilizados pela Gerencianet</a>.\"\n}\n[/block]\n\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**Caso você cancele/exclua em seu Mk-Auth,** recomendamos que acesse sua conta Gerencianet e vá em <code>Cobranças > Gerenciar Cobranças</code>, buscando pelo boleto ou carnê que deseja cancelar.\"\n}\n[/block]\n<br>\n<hr>\n\n# 5. Respostas para as dúvidas mais comuns\n\nMuitos clientes do Mk-Auth que utilizam a Gerencianet para realizar as cobranças de suas mensalidades têm dúvidas sobre algumas situações e configurações do sistema. Para ajudar os clientes que possuem dificuldades em algumas questões, preparamos estas respostas para as dúvidas mais comuns:\n\n## 5.1) A integração falhou na emissão da cobrança\n\nInúmeras razões podem ocasionar falhas ao emitir cobranças, como por exemplo, um CPF inválido, o Mk-Auth está sem Internet ou o serviço de DNS não está resolvendo corretamente, regras de firewall, etc. Por isso, você pode:\n\n### Alternativa 1:\n\nEm sua conta Gerencianet, você pode verificar a origem do erro acessando o menu <code>API > Minhas Aplicações > Sua Aplicação</code>. Desça a barra de rolagem e clique na subaba <code>Histórico de Requisições</code>. Se existirem requisições com o status <code>Falha</code>, clique no ícone similar a um \"olho\" para conferir os detalhes.\n\nO conteúdo de <code>Dados de Entrada</code> representa as informações que seu sistema nos enviou na requisição, e os \"Dados de Saída\" apresenta o resultado com base no que você nos enviou. Veja que neste local podem ser exibidos os motivos causadores do erro. \n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"<a href=\\\"https://dev.gerencianet.com.br/docs/interpretando-erros-api\\\" title=\\\"Link Interno\\\">Saiba mais</a> como utilizar o \\\"Histórico de Requisições\\\" para visualizar como foram enviadas as requisições originadas de seu sistema.\",\n  \"title\": \"NOTA\"\n}\n[/block]\nA integração funciona para boletos e carnês. **Um erro comum é tentar atrelar boletos gerados em carnês. Essa opção existe no Mk-Auth, mas não é aplicável no contexto da Gerencianet. ** Se deseja criar carnês, utilize a opção de <code>incluir novo carnê</code> para seu cliente. Caso queira, confira os tópicos [Geração de títulos avulsos](https://dev.gerencianet.com.br/docs/mk-auth#section-2-criar-t-tulos-avulsos-no-mk-auth-utilizando-a-api-gerencianet) e também [Geração de carnês](https://dev.gerencianet.com.br/docs/mk-auth#section-3-criar-carn-s-no-mk-auth-utilizando-a-api-gerencianet) no Mk-Auth utilizando a API Gerencianet.\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 o Mk-Auth está sem internet ou com o serviço de DNS não configurado ou incorreto, fazendo com que as informações não sejam direcionadas da sua rede para o sistema da Gerencianet.\n\nPara 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 - por isso, verifique seu DNS (faça um teste com outro DNS) e revise as opções de permissões da sua rede.\n\nEm seu Mikrotik, você pode ir em <code>IP > Firewall > Filter Rules</code> e verificar se o IP ou o <a href=\"https://gerencianet.com.br/artigo/quais-enderecos-de-ip-gerencianet-utiliza/\" target=\"_blank\" title=\"Link Externo\">bloco de IPs 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### Alternativa 2:\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 relação das faixas de IP da Gerencianet</a>.\n\n### Alternativa 3:\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 do Usuário Mk-Auth</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<hr>\n\n## 5.2) A integração falhou na baixa automática (callback)\n\nSe você percebeu que alguma cobrança não foi baixada de forma automática, possivelmente a URL de notificação atrelada à transação está incorreta e requer atenção. Por isso, você pode:\n\n### Alternativa 1:\n\nIdentifique se a URL de notificação setada está correta. Para isso, acesse sua conta Gerencianet e vá em <code>API > Minhas Aplicações > Sua Aplicação</code>. Desça a barra de rolagem, clique em <code>Histórico de Notificações</code> e busque pelo número da cobrança desejada. Ao localizá-la, confira se a URL associada está correta.\n\nPara que você possa interpretar os cenários pertinentes a notificações (callbacks), como em situações em que uma cobrança em seu sistema não foi baixada, o callback foi disparado para uma URL que você definiu previamente mas que não é mais válida, etc, recomendamos que veja o tópico <a href=\"https://dev.gerencianet.com.br/docs/entendendo-fluxo-notificacoes\" title=\"Link Interno\">Entendendo o fluxo das notificações</a>.\n\n### Alternativa 2:\n\nSe mesmo após a realização dos procedimentos acima você não obter êxito, você pode acrescentar a <a href=\"https://gerencianet.com.br/artigo/quais-enderecos-de-ip-gerencianet-utiliza/\" target=\"_blank\" title=\"Link Externo\">relação do bloco de IPs utilizados pela 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<hr>\n\n## 5.3) No Histórico de Notificações da API Gerencianet está exibindo \"Falha\"\n\nA Gerencianet utiliza respostas HTTP para indicar sucesso ou falha nas requisições.\n\nNa sua conta Gerencianet, em <code>API > Minhas Aplicações > Sua Aplicação</code>, na sub-aba <code>Histórico de Notificações</code>, são exibidos os POSTs (notificações) que a Gerencianet enviou para a sua URL de notificação.\n\nComumente, quando uma notificação está com o status \"Falha\", significa que seu servidor nos respondeu com um código de status. Considere que: respostas com status <code>2xx</code> significa que houve sucesso na requisição; status <code>3xx</code> indicam redirecionamento; status <code>4xx</code> indicam falhas no envio de dados por parte do cliente; status <code>5xx</code> indicam erros internos de servidor.\n\nCom o intuito de auxiliar os clientes, disponibilizamos a página [Entendendo o fluxo das notificações](https://dev.gerencianet.com.br/docs/entendendo-fluxo-notificacoes) que contém explicações relacionadas ao tema. Ao término da leitura da [referida página](https://dev.gerencianet.com.br/docs/entendendo-fluxo-notificacoes), espera-se que você consiga interpretar os cenários pertinentes a notificações (callbacks), como em situações em que uma cobrança em seu sistema não foi baixada, o callback foi disparado para uma URL que você definiu previamente mas que não é mais válida, etc.\n\n<br>\n<hr>\n\n## 5.4) Pagamento por cartão de crédito 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      \"name\": \"Cartões de teste para usar em sandbox no Mk-Auth\"\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<hr>\n\n## 5.5) 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. Em seu Mk-Auth, entre em <code>Provedor > Contas Bancárias</code>;\n\n2. Escolha a conta que deseja alterar e clique em <code>Alterar</code>;\n\n3. Por fim, verifique se a opção <code>Contra-Apresentação</code> está marcada como <code>Sim</code>. Para desativar, basta mudar para a opção <code>Não</code>.\n\n<img src=\"https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/09/13144211/mk-auth_contra_apresentacao.png\" alt=\"Mk-Auth - Contra Apresentação - Gerencianet\">\n\n<br>\n<hr>\n\n## 5.6) Cliente não recebe e-mail de cobrança da Gerencianet\n\nSe você está gerando uma cobrança, pelo fato do atributo <code>email</code> da API não ser obrigatório, pode ser que seu cliente não recebeu a cobrança pois a requisição enviada pelo seu Mk-Auth não contém o endereço de e-mail do cliente final, ou ele foi informado incorretamente.\n\n### Alternativa 1:\n\nPode ser que o atributo <code>email</code> da requisição que o Mk-Auth enviou para a API esteja como <code>null</code>, não tenha sido informado na emissão ou o endereço de e-mail fornecido é incorreto. \n\nPara verificar se o e-mail está sendo enviado pelo Mk-Auth para a API Gerencianet, siga os passos:\n\n1. Em sua conta Gerencianet, acesse <code>API > Minhas Aplicações > Sua Aplicação</code> e clique na subaba <code>Histórico de Requisições</code>;\n\n2. Localize a linha que contém <code>POST /charge/:id/pay</code>, onde <code>:id</code> é o número da cobrança que você deseja verificar e clique no ícone da última coluna (similar a um \"olho\");\n\n3. Por fim, em <code>Dados de Entrada</code>, verifique se o atributo \"email\" está presente, se está como <code>null</code> ou se o endereço de e-mail fornecido está correto.\n\n### Alternativa 2:\n\nCaso no cadastro do cliente o endereço de e-mail esteja especificado, é preciso que você confira em seu Mk-Auth se a opção para repasse do e-mail do cliente está configurada corretamente:\n\n1. Em seu Mk-Auth, entre em <code>Provedor > Contas Bancárias</code>;\n\n2. Escolha a conta que deseja alterar e clique em <code>Alterar</code>;\n\n3. Por fim, verifique se a opção <code>repassar e-mail do cliente</code> está marcada como <code>Sim</code> e clique no botão <code>Gravar</code>.\n\n<img src=\"https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/09/13150746/mk-auth-repassar-email-cliente.png\" alt=\"Mk-Auth - Gerencianet - Repassar email do cliente\">\n\n### Alternativa 3:\n\nAlguns clientes finais têm problema para receber e-mails 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<hr>\n\n## 5.7) Resolvendo problemas em requisições Mk-Auth para a API\n\nUm recurso de extrema importância na API Gerencianet é o *\"Histórico de Requisições\",* que permite ao integrador visualizar todas as requisições realizadas pelo seu Mk-Auth à nossa API.\n\nIremos mostrar como visualizar o conteúdo da requisição que seu sistema Mk-Auth enviou à API, assim como ensinaremos a interpretar os retornos da API 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 Gerencianet efetua a validação dos dados contidos na requisição que seu sistema Mk-Auth envia para nós. 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\nPara acessar o \"Histórico de Requisições\", efetue login em sua conta Gerencianet, acesse o menu <code>API > Minhas Aplicações > Sua Aplicação</code>. Desça a barra de rolagem e clique na subaba <code>Histórico de Requisições</code>.\n\nPor fim, basta focar nas linhas que contém o status como <code>Falha</code>. Ao localizar, clique no ícone da última coluna (similar a um \"olho\") para visualizar maiores detalhes.\n\nConfira o vídeo em que ensinamos a utilizar o \"Histórico de Requisições\", extraído da página [Interpretando Erros na API](https://dev.gerencianet.com.br/docs/interpretando-erros-api):\n[block:html]\n{\n  \"html\": \"<iframe width=\\\"560\\\" height=\\\"315\\\" src=\\\"https://www.youtube.com/embed/ad0SYoeGAZs\\\" frameborder=\\\"0\\\" allowfullscreen></iframe>\"\n}\n[/block]\n<br>\n<hr>\n\n# 6. 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<hr>\n\n# 7. 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://files.readme.io/4472138-mkauth_preview.png" alt="Mk-Auth"> A utilização da Gerencianet dentro do sistema Mk-Auth pode ser realizada por meio de duas modalidades: Fortunus (solução antiga e em desuso) e API (solução atual). Confira as características: 1. **Através do Fortunus:** integração por "token único". Solução mais antiga da Gerencianet para a emissão de boletos e carnês, cujos consumos dos webservices são realizados a partir do envio de um XML via post. **Está em desuso e recomenda-se a utilização da API. Caso necessite da documentação de uso da Gerencianet no Mk-Auth com versões anteriores a <code>18.01</code>, <a href="https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/09/13131431/Mk-Auth_Documentacao_Anterior.pdf" target="_blank">consulte este link</a>.** 2. **Através da API:** integração via API com chaves "Client_Id" e "Client_Secret". Esta é a solução indicada para uso no Mk-Auth a partir da versão <code>18.01</code>. **Indicada para toda utilização no Mk-Auth. Permite gerar boletos e carnês, além da possibilidade de pagamentos com cartão de crédito.** [block:callout] { "type": "warning", "title": "IMPORTANTE", "body": "**Recomenda-se o uso da API no Mk-Auth.** Para utilizá-la, acesse em seu Mk-Auth a opção <code>Provedor > Contas Bancárias</code> e, em <code>Banco / Gateway</code>, selecione <code>GERENCIANET.API BOLETO</code> (<a href=\"https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13165827/Mk-Auth_Gerencianet-API-Boleto.png\" target=\"_blank\">veja onde</a>).\n\nImportante ressaltar que a API da Gerencianet é RESTful e as requisições/respostas são em JSON, que é um padrão tecnológico de ponta utilizado no mercado. Além disso, novos endpoints (serviços) são oferecidos apenas na API." } [/block] <hr> Vá direto ao ponto - utilize o índice para encontrar a resposta de maneira mais eficiente: 1. [Configurando o Mk-Auth com a API Gerencianet](https://dev.gerencianet.com.br/docs/mk-auth#section-1-configurando-o-mk-auth-com-a-api-gerencianet) 2. [Criar títulos avulsos no Mk-Auth utilizando a API Gerencianet](https://dev.gerencianet.com.br/docs/mk-auth#section-2-criar-t-tulos-avulsos-no-mk-auth-utilizando-a-api-gerencianet) 3. [Criar carnês no Mk-Auth utilizando a API Gerencianet](https://dev.gerencianet.com.br/docs/mk-auth#section-3-criar-carn-s-no-mk-auth-utilizando-a-api-gerencianet) 4. [Como dar baixa automática (callback) no Mk-Auth?](https://dev.gerencianet.com.br/docs/mk-auth#section-4-como-dar-baixa-autom-tica-callback-no-mk-auth-) 5. [Respostas para as dúvidas mais comuns](https://dev.gerencianet.com.br/docs/mk-auth#section-5-respostas-para-as-d-vidas-mais-comuns) - 5.1) [A integração falhou na emissão da cobrança](https://dev.gerencianet.com.br/docs/mk-auth#section-5-1-a-integra-o-falhou-na-emiss-o-da-cobran-a) - 5.2) [A integração falhou na baixa automática (callback)](https://dev.gerencianet.com.br/docs/mk-auth#section-5-2-a-integra-o-falhou-na-baixa-autom-tica-callback-) - 5.3) [No Histórico de Notificações da API Gerencianet está exibindo "Falha"](https://dev.gerencianet.com.br/docs/mk-auth#section-5-3-no-hist-rico-de-notifica-es-da-api-gerencianet-est-exibindo-falha-) - 5.4) [Pagamento por cartão de crédito no Mk-Auth](https://dev.gerencianet.com.br/docs/mk-auth#section-5-4-pagamento-por-cart-o-de-cr-dito-no-mk-auth) - 5.5) [Cliente não marcado como inadimplente](https://dev.gerencianet.com.br/docs/mk-auth#section-5-5-cliente-n-o-marcado-como-inadimplente) - 5.6) [Cliente não recebe e-mail de cobrança da Gerencianet](https://dev.gerencianet.com.br/docs/mk-auth#section-5-6-cliente-n-o-recebe-e-mail-de-cobran-a-da-gerencianet) - 5.7) [Resolvendo problemas em requisições Mk-Auth para a API](https://dev.gerencianet.com.br/docs/mk-auth#section-5-7-resolvendo-problemas-em-requisi-es-mk-auth-para-a-api) 6. [Extras: vídeos oficiais no canal do Mk-Auth no YouTube](https://dev.gerencianet.com.br/docs/mk-auth#section-6-extras-v-deos-oficiais-no-canal-do-mk-auth-no-youtube) 7. [Dúvidas ou Suporte?](https://dev.gerencianet.com.br/docs/mk-auth#section-7-d-vidas-ou-suporte-) <hr> # 1. Configurando o Mk-Auth com a API Gerencianet Para auxiliar os clientes que desejam utilizar a Gerencianet no sistema Mk-Auth, disponibilizamos explicações sobre como configurar seu sistema Mk-Auth para emitir cobranças registradas pela API da Gerencianet. Confira o passo a passo: 1. Faça login em sua conta Gerencianet, acesse o menu <code>API > Minhas Aplicações</code> e clique em <code>Nova Aplicação</code>; 2. Informe o nome da integração (exemplo: <code>Mk-Auth</code>) e clique em <code>Criar nova aplicação</code> (<a href="https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13162036/Mk-Auth-Nova-Aplicacao.png" target="_blank">veja onde</a>). [block:callout] { "type": "danger", "title": "ATENÇÃO", "body": "Ao criar sua aplicação, deixe o \"modo de compatibilidade\" como **DESATIVADO**." } [/block] Agora, vamos acessar o Mk-Auth para realizar algumas configurações: <br> <img src="https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/09/12195516/mk-auth-contas-bancarias.png" alt="Configurações Gerencianet no sistema Mk-Auth 18.01"><br> Vamos configurar as credenciais de sua conta Gerencianet dentro do seu sistema Mk-Auth. Veja a seguir a explicação de campo a campo: 1. Acesse o menu <code>Provedor > Contas bancárias</code> em seu Mk-Auth e clique no botão <code>+</code> (<a href="https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13165435/provedor_contas_Mk-Auth_Gerencianet.png" target="_blank">veja onde</a>); 2. No campo <code>Banco / Gateway</code>, selecione a opção <code>GERENCIANET.API BOLETO</code> (<a href="https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13165827/Mk-Auth_Gerencianet-API-Boleto.png" target="_blank">veja onde</a>) e preencha os campos abaixo: - <code>Nome da conta</code>: informe um nome para que você possa identificar em seu Mk-Auth (será listado em *Provedor > Contas Bancárias*). Escreva, por exemplo, <code>Boletos Gerencianet</code>; - <code>Identificador da conta</code>: código identificador da conta Gerencianet, único por conta. Confira onde localizá-lo, de acordo com o layout de sua plataforma - <a href="https://gerencianet.com.br/wp-content/uploads/2017/10/payee_code_n.png" target="_blank">opção 1</a> ou <a href="https://gerencianet.com.br/wp-content/uploads/2017/10/payee_code_p.png" target="_blank">opção 2</a>; - <code>Client ID Produção</code>: informe sua chave <code>Client_Id</code> do ambiente de produção. Para localizar, acesse *API > Minhas Aplicações > Sua Aplicação*, e copie na íntegra a chave <code>Client_Id</code> da aba <code>Produção</code> (<a href="https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13171115/Mk-Auth_Client-ID-Producao.png" target="_blank">veja onde</a>); - <code>Client Secret Produção</code>: informe sua chave <code>Client_Secret</code> do ambiente de produção. Para localizar, acesse *API > Minhas Aplicações > Sua Aplicação*, e copie na íntegra a chave <code>Client_Secret</code> da aba <code>Produção</code> (<a href="https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13171841/Mk-Auth_Client-Secret-Producao.png" target="_blank">veja onde</a>); - <code>Client ID Desenvolvimento</code>: informe sua chave <code>Client_Id</code> do ambiente de desenvolvimento. Para localizar, acesse *API > Minhas Aplicações > Sua Aplicação*, e copie na íntegra a chave <code>Client_Id</code> da aba <code>Desenvolvimento</code> (<a href="https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13172308/Mk-Auth_Client-ID-Desenvolvimento.png" target="_blank">veja onde</a>); - <code>Client Secret Desenvolvimento</code>: informe sua chave <code>Client_Secret</code> do ambiente de desenvolvimento. Para localizar, acesse *API > Minhas Aplicações > Sua Aplicação*, e copie na íntegra a chave <code>Client_Secret</code> da aba <code>Desenvolvimento</code> (<a href="https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/08/13172518/Mk-Auth_Client-Secret-Desenvolvimento.png" target="_blank">veja onde</a>); - <code>URL de retorno</code>: refere-se ao endereço (URL) de callback/notificação. Deve ser informado no formato <code>http://url.do.mk-auth/retorno/gerencianet_confirma.php</code>, alterando <code>url.do.mk-auth</code> para o IP ou host de seu servidor. O IP deve ser da conta Mk-Auth, disponível em <code>Opções > IP do Servidor</code>. Se você utiliza um serviço de DNS Dinâmico (DDNS), é possível colocá-lo no lugar de seu IP (inclusive, é uma prática recomendada). Não se esqueça de informar o protocolo *http* ou *https* antes do endereço, além da porta (caso utilizar); - <code>Repassar e-mail do cliente</code>: indica se o Mk-Auth deverá associar o e-mail do cliente final na emissão da cobrança para a Gerencianet. Se marcado como <code>Sim</code>, a Gerencianet enviará automaticamente o e-mail com a cobrança e aviso de inadimplência; se marcado como <code>Não</code>, a Gerencianet não irá disparar nenhum e-mail ao cliente final. <br> Por fim, vamos prosseguir definindo as configurações de multa e juros por dia se pago após o vencimento. Em seu Mk-Auth, você pode preencher os dois campos a seguir: - <code>Percentual multa</code>: refere-se a valor da multa se pago após o vencimento. Geralmente este valor é configurado como <code>2,00</code>, que equivale a 2%. O valor não pode ser superior a <code>1000</code> (10%); - <code>Percentual juros dia</code>: refere-se aos juros por dia de atraso se pago após o vencimento. Geralmente este valor é configurado como <code>0,03</code>, que equivale a 0,003%. O valor não pode ser superior a <code>330</code> (0,33%). <br> Pronto! A integração está realizada. Os demais campos são relacionados a configurações específicas que você pode definir em seu sistema Mk-Auth. [block:callout] { "type": "warning", "title": "IMPORTANTE", "body": "- Para que a integração funcione, o Mk-Auth deve estar conectado à internet. Além disso, o serviço de DNS deve estar configurado e funcionando em seu Mk-Auth.\n\n- Caso queira, 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- Estas explicações foram baseadas na versão 18.01 do sistema Mk-Auth." } [/block] <br> <hr> # 2. Criar títulos avulsos no Mk-Auth utilizando a API Gerencianet Para emitir boletos avulsos para seus clientes, você precisará definir em seu Mk-Auth os clientes que deseja que os títulos sejam cobranças avulsas, e não carnês. Isso será realizado em seu Mk-Auth, dentro do financeiro do cliente. ### Para alterar individualmente por cliente: 1. Em seu Mk-Auth, acesse <code>Clientes > Listar Todos Clientes</code>; 2. Escolha o cliente que deseja alterar para cobrança avulsa e clique em <code>Alterar</code>; 3. Acesse a aba <code>Financeiro</code> e, no campo <code>Tipo de cobrança</code>, selecione <code>Título</code> e clique em <code>Gravar</code>. ### Para alterar em massa para vários clientes: 1. Em seu Mk-Auth, acesse <code>Clientes > Listar Todos Clientes</code>; 2. Selecione os checkboxes dos clientes que deseja alterar para cobrança avulsa, clique no ícone azul de <em>alterar clientes</em> e, por fim, clique em <code>Ok</code>; 3. Desça a barra de rolagem e no campo <code>Tipo de cobrança</code>, selecione <code>Título</code> e clique em <code>Enviar</code>. ### Ao cadastrar o cliente no Mk-Auth: 1. Em seu Mk-Auth, acesse <code>Clientes > Inserir Novo Cliente</code>; - Você também pode ir em <code>Clientes > Listar Todos Clientes</code> e clicar no botão <code>+</code> <br> 2. Informe os dados cadastrais do cliente e clique na aba <code>Financeiro</code>; 3. No campo <code>Tipo de cobrança</code>, selecione <code>Título</code> e clique em <code>Gravar</code>. <br> Note que o sistema Mk-Auth oferece uma série de opções nesta aba <code>Financeiro</code> que você pode explorar e utilizar. <br> **Por fim, para emitir cobranças avulsas em seu Mk-Auth, siga as instruções:** 1. Em seu Mk-Auth, acesse <code>Clientes > Listar Todos Clientes</code>; 2. Abaixo do nome do cliente, clique em <code>Detalhes</code>; 3. Para emitir cobranças avulsas, clique no botão <code>+</code> logo abaixo do título <code>Titulos avulsos</code>. <br> <hr> # 3. Criar carnês no Mk-Auth utilizando a API Gerencianet Para emitir carnês para seus clientes, você precisará definir em seu Mk-Auth os clientes que deseja que os títulos sejam carnês, e não boletos avulsos. Isso será realizado em seu Mk-Auth, dentro do financeiro do cliente. ### Para alterar individualmente por cliente: 1. Em seu Mk-Auth, acesse <code>Clientes > Listar Todos Clientes</code>; 2. Escolha o cliente que deseja alterar para carnê e clique em <code>Alterar</code>; 3. Acesse a aba <code>Financeiro</code> e, no campo <code>Tipo de cobrança</code>, selecione <code>Carnê</code> e clique em <code>Gravar</code>. ### Para alterar em massa para vários clientes: 1. Em seu Mk-Auth, acesse <code>Clientes > Listar Todos Clientes</code>; 2. Selecione os checkboxes dos clientes que deseja alterar para carnê, clique no ícone azul de <em>alterar clientes</em> e, por fim, clique em <code>Ok</code>; 3. Desça a barra de rolagem e no campo <code>Tipo de cobrança</code>, selecione <code>Carnê</code> e clique em <code>Enviar</code>. ### Ao cadastrar o cliente no Mk-Auth: 1. Em seu Mk-Auth, acesse <code>Clientes > Inserir Novo Cliente</code>; - Você também pode ir em <code>Clientes > Listar Todos Clientes</code> e clicar no botão <code>+</code> <br> 2. Informe os dados cadastrais do cliente e clique na aba <code>Financeiro</code>; 3. No campo <code>Tipo de cobrança</code>, selecione <code>Carnê</code> e clique em <code>Gravar</code>. <br> Note que o sistema Mk-Auth oferece uma série de opções nesta aba <code>Financeiro</code> que você pode explorar e utilizar. <br> **Por fim, para emitir carnês em seu Mk-Auth, siga as instruções:** 1. Em seu Mk-Auth, acesse <code>Clientes > Listar Todos Clientes</code>; 2. Abaixo do nome do cliente, clique em <code>Detalhes</code>; 3. Para emitir cobranças avulsas, clique no botão <code>+</code>, localizado mais abaixo do título <code>Carnê atual</code>. <br> [block:callout] { "type": "info", "title": "ATENÇÃO, ESTEJA CIENTE", "body": "O sistema Mk-Auth (versão 18.01) utiliza o endpoint <code>POST /charge/:id/pay</code> como sendo de carnês. Isso significa que, por exemplo, se você gera um carnê de 12 parcelas, seu sistema enviará 12 requisições <code>POST</code> para a rota <code>/charge/:id/pay</code> para que a Gerencianet retorne as 12 cobranças.\n\nConsiderando que cada requisição realizada equivale a 1 consumo, o limite de emissões para um mesmo cliente é 13 requisições diárias e/ou 30 mensais. Neste caso, **restará apenas 1 cobrança que poderá ser gerada no mesmo dia para este cliente.**\n\n(+) Para saber mais sobre o limite de emissões diárias e/ou mensais excedido, <a href=\"https://gerencianet.com.br/artigo/apos-emitir-algumas-cobrancas-esta-retornando-limite-de-emissoes-diarias-excedido-como-resolver/\" target=\"_blank\" title=\"Link Externo\">veja em nossa FAQ</a>." } [/block] <br> <hr> # 4. Como dar baixa automática (callback) no Mk-Auth? A partir da versão 18.01, o Mk-Auth incluiu o recurso "URL de notificação" oferecido pela API Gerencianet. Uma das vantagens deste recurso é que o integrador **passa a ser notificado em seu Mk-Auth sobre qualquer mudança no status da cobrança** (se ela foi paga, cancelada, se está inadimplente, etc). Para utilizar este recurso, você deverá informar uma URL válida ao cadastrar a conta Gerencianet dentro de seu Mk-Auth. Isto é realizado no campo <code>URL de retorno</code> e deverá estar no formato <code>http://url.do.mk-auth/retorno/gerencianet_confirma.php</code>, alterando <code>url.do.mk-auth</code> para o IP ou host de seu servidor. O IP deve ser da conta Mk-Auth, disponível em <code>Opções > IP do Servidor</code>. Se você utiliza um serviço de DNS Dinâmico (DDNS), é possível colocá-lo no lugar de seu IP **(inclusive, é uma prática recomendada).** Não se esqueça de informar o protocolo http ou https antes do endereço, além da porta (caso utilize). Para saber detalhes, veja em [Configurando a API Gerencianet no Mk-Auth](https://dev.gerencianet.com.br/docs/mk-auth#section-1-configurando-o-mk-auth-com-a-api-gerencianet). [block:callout] { "type": "warning", "title": "IMPORTANTE", "body": "Algumas aplicações e serviços filtram nossas comunicações por meio dos nossos endereços de IP.\nConfira <a href=\"https://gerencianet.com.br/artigo/quais-enderecos-de-ip-gerencianet-utiliza/\" target=\"_blank\" title=\"Link Externo\">a lista dos endereços utilizados pela Gerencianet</a>." } [/block] [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.**\n\n**Caso você cancele/exclua em seu Mk-Auth,** recomendamos que acesse sua conta Gerencianet e vá em <code>Cobranças > Gerenciar Cobranças</code>, buscando pelo boleto ou carnê que deseja cancelar." } [/block] <br> <hr> # 5. Respostas para as dúvidas mais comuns Muitos clientes do Mk-Auth que utilizam a Gerencianet para realizar as cobranças de suas mensalidades têm dúvidas sobre algumas situações e configurações do sistema. Para ajudar os clientes que possuem dificuldades em algumas questões, preparamos estas respostas para as dúvidas mais comuns: ## 5.1) A integração falhou na emissão da cobrança Inúmeras razões podem ocasionar falhas ao emitir cobranças, como por exemplo, um CPF inválido, o Mk-Auth está sem Internet ou o serviço de DNS não está resolvendo corretamente, regras de firewall, etc. Por isso, você pode: ### Alternativa 1: Em sua conta Gerencianet, você pode verificar a origem do erro acessando o menu <code>API > Minhas Aplicações > Sua Aplicação</code>. Desça a barra de rolagem e clique na subaba <code>Histórico de Requisições</code>. Se existirem requisições com o status <code>Falha</code>, clique no ícone similar a um "olho" para conferir os detalhes. O conteúdo de <code>Dados de Entrada</code> representa as informações que seu sistema nos enviou na requisição, e os "Dados de Saída" apresenta o resultado com base no que você nos enviou. Veja que neste local podem ser exibidos os motivos causadores do erro. [block:callout] { "type": "info", "body": "<a href=\"https://dev.gerencianet.com.br/docs/interpretando-erros-api\" title=\"Link Interno\">Saiba mais</a> como utilizar o \"Histórico de Requisições\" para visualizar como foram enviadas as requisições originadas de seu sistema.", "title": "NOTA" } [/block] A integração funciona para boletos e carnês. **Um erro comum é tentar atrelar boletos gerados em carnês. Essa opção existe no Mk-Auth, mas não é aplicável no contexto da Gerencianet. ** Se deseja criar carnês, utilize a opção de <code>incluir novo carnê</code> para seu cliente. Caso queira, confira os tópicos [Geração de títulos avulsos](https://dev.gerencianet.com.br/docs/mk-auth#section-2-criar-t-tulos-avulsos-no-mk-auth-utilizando-a-api-gerencianet) e também [Geração de carnês](https://dev.gerencianet.com.br/docs/mk-auth#section-3-criar-carn-s-no-mk-auth-utilizando-a-api-gerencianet) no Mk-Auth utilizando a API Gerencianet. 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 o Mk-Auth está sem internet ou com o serviço de DNS não configurado ou incorreto, fazendo com que as informações não sejam 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 - por isso, verifique seu DNS (faça um teste com outro DNS) e revise as opções de permissões da sua rede. Em seu Mikrotik, você pode ir em <code>IP > Firewall > Filter Rules</code> e verificar se o IP ou o <a href="https://gerencianet.com.br/artigo/quais-enderecos-de-ip-gerencianet-utiliza/" target="_blank" title="Link Externo">bloco de IPs 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 2: 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 relação das faixas de IP da Gerencianet</a>. ### Alternativa 3: 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 do Usuário Mk-Auth</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> ## 5.2) A integração falhou na baixa automática (callback) Se você percebeu que alguma cobrança não foi baixada de forma automática, possivelmente a URL de notificação atrelada à transação está incorreta e requer atenção. Por isso, você pode: ### Alternativa 1: Identifique se a URL de notificação setada está correta. Para isso, acesse sua conta Gerencianet e vá em <code>API > Minhas Aplicações > Sua Aplicação</code>. Desça a barra de rolagem, clique em <code>Histórico de Notificações</code> e busque pelo número da cobrança desejada. Ao localizá-la, confira se a URL associada está correta. Para que você possa interpretar os cenários pertinentes a notificações (callbacks), como em situações em que uma cobrança em seu sistema não foi baixada, o callback foi disparado para uma URL que você definiu previamente mas que não é mais válida, etc, recomendamos que veja o tópico <a href="https://dev.gerencianet.com.br/docs/entendendo-fluxo-notificacoes" title="Link Interno">Entendendo o fluxo das notificações</a>. ### Alternativa 2: Se mesmo após a realização dos procedimentos acima você não obter êxito, você pode acrescentar a <a href="https://gerencianet.com.br/artigo/quais-enderecos-de-ip-gerencianet-utiliza/" target="_blank" title="Link Externo">relação do bloco de IPs utilizados pela 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> ## 5.3) No Histórico de Notificações da API Gerencianet está exibindo "Falha" A Gerencianet utiliza respostas HTTP para indicar sucesso ou falha nas requisições. Na sua conta Gerencianet, em <code>API > Minhas Aplicações > Sua Aplicação</code>, na sub-aba <code>Histórico de Notificações</code>, são exibidos os POSTs (notificações) que a Gerencianet enviou para a sua URL de notificação. Comumente, quando uma notificação está com o status "Falha", significa que seu servidor nos respondeu com um código de status. Considere que: respostas com status <code>2xx</code> significa que houve sucesso na requisição; status <code>3xx</code> indicam redirecionamento; status <code>4xx</code> indicam falhas no envio de dados por parte do cliente; status <code>5xx</code> indicam erros internos de servidor. Com o intuito de auxiliar os clientes, disponibilizamos a página [Entendendo o fluxo das notificações](https://dev.gerencianet.com.br/docs/entendendo-fluxo-notificacoes) que contém explicações relacionadas ao tema. Ao término da leitura da [referida página](https://dev.gerencianet.com.br/docs/entendendo-fluxo-notificacoes), espera-se que você consiga interpretar os cenários pertinentes a notificações (callbacks), como em situações em que uma cobrança em seu sistema não foi baixada, o callback foi disparado para uma URL que você definiu previamente mas que não é mais válida, etc. <br> <hr> ## 5.4) Pagamento por cartão de crédito 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", "name": "Cartões de teste para usar em sandbox no Mk-Auth" } ] } [/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> ## 5.5) 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. Em seu Mk-Auth, entre em <code>Provedor > Contas Bancárias</code>; 2. Escolha a conta que deseja alterar e clique em <code>Alterar</code>; 3. Por fim, verifique se a opção <code>Contra-Apresentação</code> está marcada como <code>Sim</code>. Para desativar, basta mudar para a opção <code>Não</code>. <img src="https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/09/13144211/mk-auth_contra_apresentacao.png" alt="Mk-Auth - Contra Apresentação - Gerencianet"> <br> <hr> ## 5.6) Cliente não recebe e-mail de cobrança da Gerencianet Se você está gerando uma cobrança, pelo fato do atributo <code>email</code> da API não ser obrigatório, pode ser que seu cliente não recebeu a cobrança pois a requisição enviada pelo seu Mk-Auth não contém o endereço de e-mail do cliente final, ou ele foi informado incorretamente. ### Alternativa 1: Pode ser que o atributo <code>email</code> da requisição que o Mk-Auth enviou para a API esteja como <code>null</code>, não tenha sido informado na emissão ou o endereço de e-mail fornecido é incorreto. Para verificar se o e-mail está sendo enviado pelo Mk-Auth para a API Gerencianet, siga os passos: 1. Em sua conta Gerencianet, acesse <code>API > Minhas Aplicações > Sua Aplicação</code> e clique na subaba <code>Histórico de Requisições</code>; 2. Localize a linha que contém <code>POST /charge/:id/pay</code>, onde <code>:id</code> é o número da cobrança que você deseja verificar e clique no ícone da última coluna (similar a um "olho"); 3. Por fim, em <code>Dados de Entrada</code>, verifique se o atributo "email" está presente, se está como <code>null</code> ou se o endereço de e-mail fornecido está correto. ### Alternativa 2: Caso no cadastro do cliente o endereço de e-mail esteja especificado, é preciso que você confira em seu Mk-Auth se a opção para repasse do e-mail do cliente está configurada corretamente: 1. Em seu Mk-Auth, entre em <code>Provedor > Contas Bancárias</code>; 2. Escolha a conta que deseja alterar e clique em <code>Alterar</code>; 3. Por fim, verifique se a opção <code>repassar e-mail do cliente</code> está marcada como <code>Sim</code> e clique no botão <code>Gravar</code>. <img src="https://s3-sa-east-1.amazonaws.com/pe85007/portal/wp-content/uploads/2018/09/13150746/mk-auth-repassar-email-cliente.png" alt="Mk-Auth - Gerencianet - Repassar email do cliente"> ### Alternativa 3: Alguns clientes finais têm problema para receber e-mails 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> ## 5.7) Resolvendo problemas em requisições Mk-Auth para a API Um recurso de extrema importância na API Gerencianet é o *"Histórico de Requisições",* que permite ao integrador visualizar todas as requisições realizadas pelo seu Mk-Auth à nossa API. Iremos mostrar como visualizar o conteúdo da requisição que seu sistema Mk-Auth enviou à API, assim como ensinaremos a interpretar os retornos da API 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 Gerencianet efetua a validação dos dados contidos na requisição que seu sistema Mk-Auth envia para nós. 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. Para acessar o "Histórico de Requisições", efetue login em sua conta Gerencianet, acesse o menu <code>API > Minhas Aplicações > Sua Aplicação</code>. Desça a barra de rolagem e clique na subaba <code>Histórico de Requisições</code>. Por fim, basta focar nas linhas que contém o status como <code>Falha</code>. Ao localizar, clique no ícone da última coluna (similar a um "olho") para visualizar maiores detalhes. Confira o vídeo em que ensinamos a utilizar o "Histórico de Requisições", extraído da página [Interpretando Erros na API](https://dev.gerencianet.com.br/docs/interpretando-erros-api): [block:html] { "html": "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/ad0SYoeGAZs\" frameborder=\"0\" allowfullscreen></iframe>" } [/block] <br> <hr> # 6. 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> # 7. 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>