{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Joomla (VirtueMart)","type":"basic","slug":"joomla-virtuemart","excerpt":"Saiba onde, como baixar e instalar nosso módulo/plugin Joomla (VirtueMart) com as formas de pagamento: Boleto bancário e cartão de crédito","body":"**Módulo de Integração Gerencianet para VirtueMart Oficial - Versão 0.2.1**\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[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Caso você tenha ativado o Bolix em sua conta Gerencianet, as cobranças geradas pelo nosso módulo/plugin já vão vir com o pix no boleto.\\nMais detalhes sobre o Bolix e como ativá-lo <a href=\\\"https://dev.gerencianet.com.br/docs/bolix-boleto-carne\\\" target=\\\"_blank\\\" title=\\\"Saiba mais sobre o Bolix\\\">aqui</a>\",\n  \"title\": \"Bolix\"\n}\n[/block]\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/archive/master.zip\" 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 Homologação</code>: em sua conta Gerencianet, acesse <code>API > Minhas Aplicações</code>, selecione sua aplicação e clique na aba <code>Homologação</code>;\n\n- <code>Client Secret Homologação</code> Conta Gerencianet > API > Aplicações > Sua Aplicação > Client Secret Homologação\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\n- Campo Logradouro (do endereço)\n- Campo Bairro\n- Campo Número (do endereço)\n- Campo Complemento (do endereço)\n- Campo Telefone (do cliente)\n- Campo CPF (do cliente)\n- Campo Data de Nascimento (do cliente)\n\n\n## Configurações de Pagamento\n\n- Ativar Boleto (Sim ou Não)\n- Ativar Cartões de Crédito (Sim ou Não)\n\n## Configurações do Boleto Bancário\n\n- Dias para vencimento\n- Desconto para pagamento no Boleto\n\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[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"ATENÇÃO\",\n  \"body\": \"Importante salientar que **os boletos gerados em sandbox não são válidos e não podem ser pagos**, possuem a linha digitável \\\"zerada\\\" e uma marca d'água ao fundo informando ser um boleto de teste.\\n\\n**Os pagamentos de cobranças de sandbox utilizando cartão de crédito são fictícios, mesmo se utilizar um cartão \\\"real\\\".** Todos os pagamentos de cartão neste ambiente terão o pagamento confirmado automaticamente, mas é apenas uma alteração de status para \\\"Pago\\\". Este recurso permite que você teste a notificação do status <code>paid</code>.\\n\\n**Isso significa que todos os pagamentos realizados em sandbox não são reais e, portanto, não há cobrança de nenhuma importância financeira.** \\n\\nÉ importante saber que as palavras **Playground, Sandbox e Ambiente de Homologação**, no contexto da Gerencianet, são sinônimos no sentido de fazerem referência ao local de testes que oferecemos em que você pode testar à vontade sua integração com a API.\"\n}\n[/block]\n<br>\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>\".","updates":[],"order":10,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"606f2ca7c5ba910078783471","createdAt":"2016-07-26T17:41:05.141Z","project":"575aeffae12cf20e002f306c","user":"57601a13af3e090e00108059","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Módulos e Plugins","slug":"módulos","order":18,"from_sync":false,"reference":false,"_id":"606f2ca6c5ba91007878342e","__v":0,"createdAt":"2016-06-14T16:28:00.991Z","project":"575aeffae12cf20e002f306c","version":"606f2ca7c5ba9100787834c6"},"version":{"version":"1.1.0","version_clean":"1.1.0","codename":"2021","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["606f2ca6c5ba91007878342b","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","606f2ca6c5ba91007878342c","606f2ca6c5ba91007878342d","606f2ca6c5ba91007878342e","606f2ca6c5ba91007878342f","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","606f2ca6c5ba910078783430","606f2ca6c5ba910078783431","5783f78c5cbce30e0074e2b7","606f2ca6c5ba910078783432","606f2ca6c5ba910078783433","606f2ca6c5ba910078783434","606f2ca6c5ba910078783435","606f2ca6c5ba910078783436","606f2ca6c5ba910078783437","578529f887c9280e0090394b","606f2ca6c5ba910078783438","606f2ca6c5ba910078783439","606f2ca6c5ba91007878343a","606f2ca6c5ba91007878343b","606f2ca6c5ba91007878343c","606f2ca6c5ba91007878343d","606f2ca6c5ba91007878343e","606f2ca6c5ba91007878343f","606f2ca6c5ba910078783440","606f2ca6c5ba910078783441","60d61f026ddc3901a32ee5f1","60ec37c637005f015e54174e","61473375119247002a9c14d7"],"_id":"606f2ca7c5ba9100787834c6","project":"575aeffae12cf20e002f306c","createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","__v":3,"forked_from":"575aeffae12cf20e002f306f"},"githubsync":"","parentDoc":null,"__v":1}

Joomla (VirtueMart)

Saiba onde, como baixar e instalar nosso módulo/plugin Joomla (VirtueMart) com as formas de pagamento: Boleto bancário e cartão de crédito

**Módulo de Integração Gerencianet para VirtueMart Oficial - Versão 0.2.1** 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. [block:callout] { "type": "warning", "body": "Caso você tenha ativado o Bolix em sua conta Gerencianet, as cobranças geradas pelo nosso módulo/plugin já vão vir com o pix no boleto.\nMais detalhes sobre o Bolix e como ativá-lo <a href=\"https://dev.gerencianet.com.br/docs/bolix-boleto-carne\" target=\"_blank\" title=\"Saiba mais sobre o Bolix\">aqui</a>", "title": "Bolix" } [/block] # 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/archive/master.zip" 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 Homologação</code>: em sua conta Gerencianet, acesse <code>API > Minhas Aplicações</code>, selecione sua aplicação e clique na aba <code>Homologação</code>; - <code>Client Secret Homologação</code> Conta Gerencianet > API > Aplicações > Sua Aplicação > Client Secret Homologação - <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. [block:callout] { "type": "danger", "title": "ATENÇÃO", "body": "Importante salientar que **os boletos gerados em sandbox não são válidos e não podem ser pagos**, possuem a linha digitável \"zerada\" e uma marca d'água ao fundo informando ser um boleto de teste.\n\n**Os pagamentos de cobranças de sandbox utilizando cartão de crédito são fictícios, mesmo se utilizar um cartão \"real\".** Todos os pagamentos de cartão neste ambiente terão o pagamento confirmado automaticamente, mas é apenas uma alteração de status para \"Pago\". Este recurso permite que você teste a notificação do status <code>paid</code>.\n\n**Isso significa que todos os pagamentos realizados em sandbox não são reais e, portanto, não há cobrança de nenhuma importância financeira.** \n\nÉ importante saber que as palavras **Playground, Sandbox e Ambiente de Homologação**, no contexto da Gerencianet, são sinônimos no sentido de fazerem referência ao local de testes que oferecemos em que você pode testar à vontade sua integração com a API." } [/block] <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>".