{"__v":0,"_id":"583591043165a52f00877528","category":{"__v":0,"_id":"576030909b1a9a220067ca40","project":"575aeffae12cf20e002f306c","version":"575aeffae12cf20e002f306f","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-06-14T16:28:00.991Z","from_sync":false,"order":11,"slug":"módulos","title":"Módulos"},"parentDoc":null,"project":"575aeffae12cf20e002f306c","user":"57601a13af3e090e00108059","version":{"__v":30,"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","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"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"2016","version_clean":"1.0.0","version":"1"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-11-23T12:52:20.594Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":5,"body":"**Módulo de Integração Gerencianet para Boxbilling Oficial - Versão 0.1.0 (Beta)**\n\n**O módulo Gerencianet para o Boxbilling permite gerar boletos com registro por meio da nossa API.** Compatível com as versões superiores a versão 4.19 do Boxbilling.\n\nEste é uma versão Beta do Módulo Oficial de integração fornecido pela Gerencianet para **Boxbilling**. Com ele, o responsável pela conta **Box Billing** pode receber pagamentos por boleto bancário e, assim que a cobrança tem uma confirmação de pagamento ou é cancelada, a Gerencianet envia uma notificação automática para o Boxbilling.\n\nCaso você tenha alguma dúvida ou sugestão, entre em contato conosco pelo site Gerencianet.\n\n\n## Requisitos:\n<hr>\n\n- Versão mínima do PHP: <code>5.4.39</code>\n- Versão mínima do Boxbilling: <code>4.19</code>\n\n\n## Instalação:\n<hr>\n\n1. Faça o <a href=\"https://codeload.github.com/gerencianet/gn-api-boxbilling/zip/master\" target=\"_blank\" title=\"Efetuar Download\">download da última versão do módulo</a>;\n\n2. Descompacte o arquivo baixado;\n\n3. Copie o arquivo <code>gerencianetcharge.php</code> e a pasta <code>gerencianet_lib</code> (disponíveis na pasta <code>gn-api-boxbilling</code>) e cole no diretório <code>/bb-library/Payment/Adapter/</code> da instalação do Box Billing;\n\n4. Copie a imagem <code>gerencianetcharge.png</code> (disponível no diretório <code>gn-api-boxbilling</code>) e cole no diretório <code>/bb-themes/huraga/assets/img/gateway_logos</code>;\n\n5. No final do arquivo <code>logos.css</code>, localizado no diretório <code>/bb-themes/huraga/assets/css/</code>, cole o seguinte trecho de código:\n\n<pre>.logo-gerencianetcharge{\n   background: transparent url(\"../img/gateway_logos/gerencianetcharge.png\") no-repeat scroll 0% 0%;\n    background-size: contain;\n    width:135px;\n    height: 25px;\n    border: 0;\n    margin: 10px;\n}</pre>\n<br>\nOs arquivos do módulo Gerencianet devem estar com a seguinte estrutura no Box Billing:\n\n<pre>/bb-library/Payment/Adapter/\n  |  gerencianet_lib/\n  |  gerencianetcharge.php\n</pre>\n\n<br>\n## Configurações do Módulo:\n<hr>\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/af10055-parametros_configuracao1.png\",\n        \"parametros_configuracao[1].png\",\n        1152,\n        981,\n        \"#f7f7f7\"\n      ]\n    }\n  ]\n}\n[/block]\nDentro do painel administrativo do Boxbilling, acesse o menu <code>Configuration > Payment Gateways</code>. Clique para editar as configurações do módulo <code>gerencianetcharge</code>. A tela mostrada acima será exibida. Dentro do formulário, você deverá preencher os seguintes campos:\n\n**1. Client_Id Produção:** Deve ser preenchido com o <code>Client_Id</code> de produção de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu <code>API > Minhas Aplicações</code>. Em seguida, selecione sua aplicação criada, conforme é mostrado <a href=\"http://image.prntscr.com/image/7dc272063bb74dccba91739701a0478b.png\" target=\"_blank\">neste link</a>;\n\n**2. Client_Secret Produção:** Deve ser preenchido com o <code>Client_Secret</code> de produção de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu <code>API > Minhas Aplicações</code>. Em seguida, selecione sua aplicação criada, conforme é mostrado <a href=\"http://image.prntscr.com/image/7dc272063bb74dccba91739701a0478b.png\" target=\"_blank\">neste link</a>;\n\n**3. Client_Id Desenvolvimento:** Deve ser preenchido com o <code>Client_Id</code> de desenvolvimento de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu <code>API > Minhas Aplicações</code>. Em seguida, selecione sua aplicação criada, conforme é mostrado <a href=\"http://image.prntscr.com/image/447be4bc64644a35bcf5eaecd1125f5d.png\" target=\"_blank\">neste link</a>;\n\n**4. Client_Secret Desenvolvimento:** Deve ser preenchido com o <code>Client_Secret</code> de desenvolvimento de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu <code>API > Minhas Aplicações</code>. Em seguida, selecione sua aplicação criada, conforme é mostrado <a href=\"http://image.prntscr.com/image/447be4bc64644a35bcf5eaecd1125f5d.png\" target=\"_blank\">neste link</a>;\n\n**5. Identificador da Conta:** Deve ser preenchido com o identificador de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu <code>API</code>, na tela principal e no canto superior esquerdo, conforme é mostrado <a href=\"http://image.prntscr.com/image/cabe13e1e5b64449b942cf31139150ba.png\" target=\"_blank\">neste link</a>;\n\n**6. E-mail de cobrança - Gerencianet:** Caso seja de seu interesse, habilite o envio de emails de cobrança da Gerencianet para o cliente final;\n\n**7. Sandbox:** Caso seja de seu interesse, habilite o ambiente de testes da API Gerencianet;\n\n**8. Moeda:** Escolha a opção <code>R$ Real</code> (a mesma deve estar definida no seu Boxbilling);\n\n**9. Enabled:** Escolha a opção <code>Yes</code> para ativar o módulo da Gerencianet;\n\n**10. Allow one time payments:** Marque a opção <code>Yes</code>;\n\n**11. Allow subscription payments:** Marque a opção <code>No</code> (o módulo Gerencianet não suporta transações por assinatura);\n\nPor fim, clique em <code>UPDATE</code>.\n\n\n## Erros Comuns de Integração:\n<hr>\n\nA API Gerencianet poderá retornar erros referentes à geração da cobrança. Para mais informações sobre os códigos de erros retornados pela API Gerencianet, <a href=\"https://docs.gerencianet.com.br/codigos-de-erros\" target=\"_blank\" title=\"Link Externo\">clique aqui</a>.","excerpt":"Você está em: *\"Módulos > Box Billing\"*","slug":"box-billing","type":"basic","title":"Box Billing"}

Box Billing

Você está em: *"Módulos > Box Billing"*

**Módulo de Integração Gerencianet para Boxbilling Oficial - Versão 0.1.0 (Beta)** **O módulo Gerencianet para o Boxbilling permite gerar boletos com registro por meio da nossa API.** Compatível com as versões superiores a versão 4.19 do Boxbilling. Este é uma versão Beta do Módulo Oficial de integração fornecido pela Gerencianet para **Boxbilling**. Com ele, o responsável pela conta **Box Billing** pode receber pagamentos por boleto bancário e, assim que a cobrança tem uma confirmação de pagamento ou é cancelada, a Gerencianet envia uma notificação automática para o Boxbilling. Caso você tenha alguma dúvida ou sugestão, entre em contato conosco pelo site Gerencianet. ## Requisitos: <hr> - Versão mínima do PHP: <code>5.4.39</code> - Versão mínima do Boxbilling: <code>4.19</code> ## Instalação: <hr> 1. Faça o <a href="https://codeload.github.com/gerencianet/gn-api-boxbilling/zip/master" target="_blank" title="Efetuar Download">download da última versão do módulo</a>; 2. Descompacte o arquivo baixado; 3. Copie o arquivo <code>gerencianetcharge.php</code> e a pasta <code>gerencianet_lib</code> (disponíveis na pasta <code>gn-api-boxbilling</code>) e cole no diretório <code>/bb-library/Payment/Adapter/</code> da instalação do Box Billing; 4. Copie a imagem <code>gerencianetcharge.png</code> (disponível no diretório <code>gn-api-boxbilling</code>) e cole no diretório <code>/bb-themes/huraga/assets/img/gateway_logos</code>; 5. No final do arquivo <code>logos.css</code>, localizado no diretório <code>/bb-themes/huraga/assets/css/</code>, cole o seguinte trecho de código: <pre>.logo-gerencianetcharge{ background: transparent url("../img/gateway_logos/gerencianetcharge.png") no-repeat scroll 0% 0%; background-size: contain; width:135px; height: 25px; border: 0; margin: 10px; }</pre> <br> Os arquivos do módulo Gerencianet devem estar com a seguinte estrutura no Box Billing: <pre>/bb-library/Payment/Adapter/ | gerencianet_lib/ | gerencianetcharge.php </pre> <br> ## Configurações do Módulo: <hr> [block:image] { "images": [ { "image": [ "https://files.readme.io/af10055-parametros_configuracao1.png", "parametros_configuracao[1].png", 1152, 981, "#f7f7f7" ] } ] } [/block] Dentro do painel administrativo do Boxbilling, acesse o menu <code>Configuration > Payment Gateways</code>. Clique para editar as configurações do módulo <code>gerencianetcharge</code>. A tela mostrada acima será exibida. Dentro do formulário, você deverá preencher os seguintes campos: **1. Client_Id Produção:** Deve ser preenchido com o <code>Client_Id</code> de produção de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu <code>API > Minhas Aplicações</code>. Em seguida, selecione sua aplicação criada, conforme é mostrado <a href="http://image.prntscr.com/image/7dc272063bb74dccba91739701a0478b.png" target="_blank">neste link</a>; **2. Client_Secret Produção:** Deve ser preenchido com o <code>Client_Secret</code> de produção de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu <code>API > Minhas Aplicações</code>. Em seguida, selecione sua aplicação criada, conforme é mostrado <a href="http://image.prntscr.com/image/7dc272063bb74dccba91739701a0478b.png" target="_blank">neste link</a>; **3. Client_Id Desenvolvimento:** Deve ser preenchido com o <code>Client_Id</code> de desenvolvimento de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu <code>API > Minhas Aplicações</code>. Em seguida, selecione sua aplicação criada, conforme é mostrado <a href="http://image.prntscr.com/image/447be4bc64644a35bcf5eaecd1125f5d.png" target="_blank">neste link</a>; **4. Client_Secret Desenvolvimento:** Deve ser preenchido com o <code>Client_Secret</code> de desenvolvimento de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu <code>API > Minhas Aplicações</code>. Em seguida, selecione sua aplicação criada, conforme é mostrado <a href="http://image.prntscr.com/image/447be4bc64644a35bcf5eaecd1125f5d.png" target="_blank">neste link</a>; **5. Identificador da Conta:** Deve ser preenchido com o identificador de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu <code>API</code>, na tela principal e no canto superior esquerdo, conforme é mostrado <a href="http://image.prntscr.com/image/cabe13e1e5b64449b942cf31139150ba.png" target="_blank">neste link</a>; **6. E-mail de cobrança - Gerencianet:** Caso seja de seu interesse, habilite o envio de emails de cobrança da Gerencianet para o cliente final; **7. Sandbox:** Caso seja de seu interesse, habilite o ambiente de testes da API Gerencianet; **8. Moeda:** Escolha a opção <code>R$ Real</code> (a mesma deve estar definida no seu Boxbilling); **9. Enabled:** Escolha a opção <code>Yes</code> para ativar o módulo da Gerencianet; **10. Allow one time payments:** Marque a opção <code>Yes</code>; **11. Allow subscription payments:** Marque a opção <code>No</code> (o módulo Gerencianet não suporta transações por assinatura); Por fim, clique em <code>UPDATE</code>. ## Erros Comuns de Integração: <hr> A API Gerencianet poderá retornar erros referentes à geração da cobrança. Para mais informações sobre os códigos de erros retornados pela API Gerencianet, <a href="https://docs.gerencianet.com.br/codigos-de-erros" target="_blank" title="Link Externo">clique aqui</a>.