{"_id":"5797a0b1c8c9cb0e009885e2","project":"575aeffae12cf20e002f306c","user":"57601a13af3e090e00108059","category":{"_id":"576030909b1a9a220067ca40","__v":0,"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"},"version":{"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","__v":30,"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"},"parentDoc":null,"__v":1,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-26T17:41:05.141Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"**Módulo de Integração Gerencianet para VirtueMart Oficial - Versão 0.1.0**\n\nO módulo Gerencianet para Joomla (VirtueMart) permite receber pagamentos por meio do <strong>checkout transparente da nossa API</strong>. Compatível com o Virtuemart 3 e Joomla! 2.5.\n\nEste é o Módulo Oficial de integração fornecido pela Gerencianet para VirtueMart. Com ele, o proprietário da loja pode optar por receber pagamentos por boleto bancário e/ou cartão de crédito. Todo processo é realizado por meio do checkout transparente. Com isso, o comprador não precisa sair do site da loja para efetuar o pagamento.\n\nAlgumas informações como \"CPF\", \"número do endereço\", \"bairro\" e \"data de nascimento\" poderão ser solicitados no momento do pagamento, caso os campos não sejam configurados conforme indicado.\n\nCaso você tenha alguma dúvida ou sugestão, entre em contato conosco pelo site Gerencianet.\n\n## 1. Requisitos\n\n- Versão mínima do PHP: <code>5.4.0</code>\n- Versão mínima do VirtueMart: <code>3.0</code>\n- Versão mínima do Joomla!: <code>2.5</code>\n\n## 2. Instalação\n\n1. Faça o download da <a href=\"https://github.com/gerencianet/gn-api-virtuemart\" target=\"_blank\">última versão do plugin</a>;\n\n2. Acesse o link em sua loja <code>Extensions > Manage > Install</code> e envie o arquivo <code>gn-api-virtuemart.zip</code> ou extraia o conteúdo do arquivo dentro do diretório de plugins da loja;\n\n3. Configure o plugin conforme instruções abaixo e comece a receber pagamentos com a Gerencianet.\n\n\n## 3. Configuração\n\n1. Primeiramente, <a href=\"https://gerencianet.com.br/#abrirconta\" target=\"_blank\" title=\"Cadastro ao nosso sistema, seja nosso cliente\">crie gratuitamente sua conta Gerencianet</a>;\n\n2. Crie 3 campos extras no Virtuemart: <code>numero</code>, <code>bairro</code> e <code>data_nascimento</code>. O número da residência, bairro e data de nascimento são dados obrigatórios para pagamento com cartão de crédito. Se não for informado no formulário de cadastro ou no carrinho, será solicitado no ato do pagamento;\n\n3. Habilite o plugin em <code>Administrar Plugins</code>;\n\n4. Instale nosso plugin através da tela <code>Métodos de pagamento</code>;\n\n5. Clique em <code>Novo Método de Pagamento</code> e preencha as seguintes informações:\n  - <code>Nome do Pagamento:</code> Cartões de crédito ou Boleto Bancário ( Gerencianet );\n  - <code>Publicado:</code> Sim;\n  - <code>Descrição do pagamento:</code> Pague com Cartão de Crédito ou Boleto Bancário;\n  - <code>Método de pagamento:</code> Gerencianet;\n  - <code>Grupo de Compradores:</code> -default-\n<br>\n6. Clique em <code>Salvar</code>;\n\n7. Na aba <code>Configurações</code>, preencha os seguintes dados:\n\n### Configurações do Plugin de Pagamento\n\n- <code>Modo de teste:</code> Sim ou Não;\n\n- <code>Client ID Desenvolvimento</code>: em sua conta Gerencianet, acesse <code>API > Minhas Aplicações</code>, selecione sua aplicação e clique na aba <code>Desenvolvimento</code>;\n\n- <code>Client Secret Desenvolvimento</code> Conta Gerencianet > API > Aplicações > Sua Aplicação > Client Secret Desenvolvimento\n\n- <code>Client ID Produção</code> Conta Gerencianet > API > Aplicações > Sua Aplicação > Client ID Produção\n\n- <code>Client Secret Produção</code> Conta Gerencianet > API > Aplicações > Sua Aplicação > Client Secret Produção As credenciais devem ser da sua Aplicação na Gerencianet. Para criar uma nova Aplicação, entre em sua conta Gerencianet, acesse o menu \"API\" e clique em \"Minhas Aplicações\" -> \"Nova aplicação\".\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Para criar sua aplicação, logue em sua conta Gerencianet, acesse o menu superior \\\"API\\\", depois clique em *\\\"Minhas Aplicações > Nova Aplicação\\\"* e defina um nome para a sua aplicação.\",\n  \"title\": \"Observação:\"\n}\n[/block]\n### Campos Extras Obrigatórios\n\nCampo Logradouro ( do endereço )\nCampo Bairro\nCampo Número ( do endereço )\nCampo Complemento ( do endereço )\nCampo Telefone ( do cliente )\nCampo CPF ( do cliente )\nCampo Data de Nascimento ( do cliente )\nConfigurações de Pagamento\n\n\n### Ativar Boleto (Sim ou Não)\n\nAtivar Cartões de Crédito (Sim ou Não)\nConfigurações do Boleto Bancário\n\n\n### Dias para vencimento\n\nDesconto para pagamento no Boleto\nRecomendamos que antes de disponibilizar pagamentos pela Gerencianet, o lojista realize testes de cobrança com o sandbox(ambiente de testes) ativado para verificar se o procedimento de pagamento está acontecendo conforme esperado.\n\n\n## 4. Erros Comuns de Integração:\n\nAinda que nenhum destes erros de validação sejam retornados, a API Gerencianet poderá retornar erros referentes à geração da cobrança. Para interpretar os retornos da API e, claro, corrigir possíveis erros de validação de dados ou outros similares, acesse a página \"<a href=\"https://dev.gerencianet.com.br/docs/interpretando-erros-api\" target=\"_blank\">Interpretando Erros da API</a>\".","excerpt":"Você está em: *\"Módulos > Joomla (VirtueMart)\"*","slug":"joomla-virtuemart","type":"basic","title":"Joomla (VirtueMart)"}

Joomla (VirtueMart)

Você está em: *"Módulos > Joomla (VirtueMart)"*

**Módulo de Integração Gerencianet para VirtueMart Oficial - Versão 0.1.0** O módulo Gerencianet para Joomla (VirtueMart) permite receber pagamentos por meio do <strong>checkout transparente da nossa API</strong>. Compatível com o Virtuemart 3 e Joomla! 2.5. Este é o Módulo Oficial de integração fornecido pela Gerencianet para VirtueMart. Com ele, o proprietário da loja pode optar por receber pagamentos por boleto bancário e/ou cartão de crédito. Todo processo é realizado por meio do checkout transparente. Com isso, o comprador não precisa sair do site da loja para efetuar o pagamento. Algumas informações como "CPF", "número do endereço", "bairro" e "data de nascimento" poderão ser solicitados no momento do pagamento, caso os campos não sejam configurados conforme indicado. Caso você tenha alguma dúvida ou sugestão, entre em contato conosco pelo site Gerencianet. ## 1. Requisitos - Versão mínima do PHP: <code>5.4.0</code> - Versão mínima do VirtueMart: <code>3.0</code> - Versão mínima do Joomla!: <code>2.5</code> ## 2. Instalação 1. Faça o download da <a href="https://github.com/gerencianet/gn-api-virtuemart" target="_blank">última versão do plugin</a>; 2. Acesse o link em sua loja <code>Extensions > Manage > Install</code> e envie o arquivo <code>gn-api-virtuemart.zip</code> ou extraia o conteúdo do arquivo dentro do diretório de plugins da loja; 3. Configure o plugin conforme instruções abaixo e comece a receber pagamentos com a Gerencianet. ## 3. Configuração 1. Primeiramente, <a href="https://gerencianet.com.br/#abrirconta" target="_blank" title="Cadastro ao nosso sistema, seja nosso cliente">crie gratuitamente sua conta Gerencianet</a>; 2. Crie 3 campos extras no Virtuemart: <code>numero</code>, <code>bairro</code> e <code>data_nascimento</code>. O número da residência, bairro e data de nascimento são dados obrigatórios para pagamento com cartão de crédito. Se não for informado no formulário de cadastro ou no carrinho, será solicitado no ato do pagamento; 3. Habilite o plugin em <code>Administrar Plugins</code>; 4. Instale nosso plugin através da tela <code>Métodos de pagamento</code>; 5. Clique em <code>Novo Método de Pagamento</code> e preencha as seguintes informações: - <code>Nome do Pagamento:</code> Cartões de crédito ou Boleto Bancário ( Gerencianet ); - <code>Publicado:</code> Sim; - <code>Descrição do pagamento:</code> Pague com Cartão de Crédito ou Boleto Bancário; - <code>Método de pagamento:</code> Gerencianet; - <code>Grupo de Compradores:</code> -default- <br> 6. Clique em <code>Salvar</code>; 7. Na aba <code>Configurações</code>, preencha os seguintes dados: ### Configurações do Plugin de Pagamento - <code>Modo de teste:</code> Sim ou Não; - <code>Client ID Desenvolvimento</code>: em sua conta Gerencianet, acesse <code>API > Minhas Aplicações</code>, selecione sua aplicação e clique na aba <code>Desenvolvimento</code>; - <code>Client Secret Desenvolvimento</code> Conta Gerencianet > API > Aplicações > Sua Aplicação > Client Secret Desenvolvimento - <code>Client ID Produção</code> Conta Gerencianet > API > Aplicações > Sua Aplicação > Client ID Produção - <code>Client Secret Produção</code> Conta Gerencianet > API > Aplicações > Sua Aplicação > Client Secret Produção As credenciais devem ser da sua Aplicação na Gerencianet. Para criar uma nova Aplicação, entre em sua conta Gerencianet, acesse o menu "API" e clique em "Minhas Aplicações" -> "Nova aplicação". [block:callout] { "type": "info", "body": "Para criar sua aplicação, logue em sua conta Gerencianet, acesse o menu superior \"API\", depois clique em *\"Minhas Aplicações > Nova Aplicação\"* e defina um nome para a sua aplicação.", "title": "Observação:" } [/block] ### Campos Extras Obrigatórios Campo Logradouro ( do endereço ) Campo Bairro Campo Número ( do endereço ) Campo Complemento ( do endereço ) Campo Telefone ( do cliente ) Campo CPF ( do cliente ) Campo Data de Nascimento ( do cliente ) Configurações de Pagamento ### Ativar Boleto (Sim ou Não) Ativar Cartões de Crédito (Sim ou Não) Configurações do Boleto Bancário ### Dias para vencimento Desconto para pagamento no Boleto Recomendamos que antes de disponibilizar pagamentos pela Gerencianet, o lojista realize testes de cobrança com o sandbox(ambiente de testes) ativado para verificar se o procedimento de pagamento está acontecendo conforme esperado. ## 4. Erros Comuns de Integração: Ainda que nenhum destes erros de validação sejam retornados, a API Gerencianet poderá retornar erros referentes à geração da cobrança. Para interpretar os retornos da API e, claro, corrigir possíveis erros de validação de dados ou outros similares, acesse a página "<a href="https://dev.gerencianet.com.br/docs/interpretando-erros-api" target="_blank">Interpretando Erros da API</a>".