{"_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 e Plugins"},"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\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<br>\n\n<hr>\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<br>\n\n<hr>\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<br>\n\n<hr>\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 e Plugins > Joomla (VirtueMart)\"*","slug":"joomla-virtuemart","type":"basic","title":"Joomla (VirtueMart)"}

Joomla (VirtueMart)

Você está em: *"Módulos e Plugins > 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. # 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> <br> <hr> # 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. <br> <hr> # 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. <br> <hr> # 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>".