Documentação Módulo de Pagamento Wirecard (Moip) Opencart Checkout

Felipo Antonoff
Postado em 08 de novembro de 2018
Editado 8 meses atrás
# Documentação Módulo de Pagamento Wirecard (Moip) Opencart Checkout Neste artigo vamos ensinar a configurar o módulo de Pagamento Wirecard (Moip) Opencart Checkout, criado pela nossa equipe da Codemarket em parceria oficial com a Wirecard (Moip), para você poder usar esse excelente intermediador em sua Loja, contando com o suporte e qualidade dos produtos da Codemarket com anos em desenvolvimento Premium e inovador para Opencart e E-commerce. ## Indíce * [Instalação](https://www.codemarket.com.br/blog/post/documentacao-modulo-de-pagamento-wirecard-moip-opencart-checkout#instala%C3%A7%C3%A3o) * [Configuração do Módulo](https://www.codemarket.com.br/blog/post/documentacao-modulo-de-pagamento-wirecard-moip-opencart-checkout#configura%C3%A7%C3%A3o-do-m%C3%B3dulo) * [FAQ](https://www.codemarket.com.br/blog/post/documentacao-modulo-de-pagamento-wirecard-moip-opencart-checkout#faq) * [Suporte Codemarket](https://www.codemarket.com.br/blog/post/documentacao-modulo-de-pagamento-wirecard-moip-opencart-checkout#suporte-codemarket) ## Instalação Primeiro, precisamentos instalar o Painel Codemarket na Loja e validar ele em Minha Conta -> Lojas. **Veja o artigo abaixo ensinando a fazer isso:** [Como instalar o Painel Codemarket no Opencart?](https://www.codemarket.com.br/blog/post/como-instalar-o-painel-codemarket-no-opencart) Vamos agora aos passos da Instalação do Módulo: * Baixar o módulo em Minha Conta -> Licenças -> Baixar (ícone para o Download), só pode baixar após ter feito a etapa anterior de instalação do nosso Painel Codemarket e sua validação * Subir os arquivos do módulo pelo FTP/SFTP **Exemplo loja FTP:** ![Exemplo básico FTP de uma loja Openart](https://docs.codemarket.com.br/moip/img/loja-ftp.png) * Ir em Extensões -> Modificações -> Clicar em Limpar Cache (ícone azul) **Tela de Modificações :** ![Tela modificações Opencart](https://docs.codemarket.com.br/moip/img/Modificacao-Opencart.png) Na nova versão do nosso Painel Codemarket, ele fica em Extensões -> Extensões ou Extensões -> Módulos dependendo da versão, para mais detalhes veja no artigo [Utilizando o Painel Codemarket em sua Loja](https://www.codemarket.com.br/blog/post/utilizando-o-painel-codemarket-em-sua-loja). * Configurar o módulo conforme informado nas etapas abaixo e salvar, lembre-se principalmente da etapa de Permissão explicada com detalhes na Configuração do Módulo * Pronto, agora é só testar e usar, recomendo verificar o FAQ nesse artigo e as outras partes logo abaixo, boas vendas ## Configuração do Módulo Vamos ensinar nesta etapa a realizar a configuração do módulo e o que significa cada campo a ser configurado, fundamental que seja feita corretamente a configuração, para um bom funcionamento do módulo ### Permissão Clique na Tab Permissão para ir até essa etapa fundamental, que iremos definir as permissões da para o modo de Produção e Teste. **Passos produção:** 1) Precisa ter um cadastro aprovado na Wirecard (Moip), depois disso informe o tipo de conta ao lado 2) Clique no botão Solicitar Permissão 3) Você será encaminhado para a página da Wirecard (Moip), faça o Login caso não tenha feito 4) Clique em Permitir Conexão 5) Feche o Modal dessa configuração e clique em Limpar Cache na linha do módulo Pronto, agora vai aparecer as configurações do módulo **Passos teste:** 1) Crie uma conta de teste, clicando aqui. 2) Repita o passo 2) em diante dos passos de produção, clicando no botão Solicitar Permissão Teste **Observação:** pode levar alguns segundos, pois é criado também o Webhook para as notificações de Pagamentos, devido testes de URLs para achar a URL correta sem redirecionamento . Tempo estimado de 5-10s e se for loja Opencart 2.x abaixo da 2.3.x pode levar um pouco mais. ### Cartão de Crédito #### Cartão - Configuração básica * **Parcela máxima:** Informe o máximo de parcela que deseja que apareça para o cliente selecionar, exemplo: 8, neste caso no máximo será exibido até no máximo 8 parcelas. * **Ordem na Listagem de Pagamento:** Informe a ordem que deseja que aparece na listagem de Pagamento, quanto menor, primeiro fica na ordem, exemplo Cartão de Crédito 1 e Boleto 2, neste caso o Cartão de Crédito aparece antes do Boleto * **Região Geográfica:** Informe a região que deseja habilitar o módulo, se não definir, vai funcionar para todas * **Habilitar Modo de Teste:** Informe se deseja ativar o modo de teste, recomendado apenas para teste, acima das tabs, aparece se o Cartão está no modo de teste ou não também para facilitar. Sim ou Não, se escolher Sim, vai ativar o modo de teste e Não vai ativar o modo de Produção. * **Habilitar:** Informe se deseja ativar o Cartão de Crédito, fazendo o mesmo aparecer na listagem de Pagamentos se todas as condições forem atendidas, como a região geográfica. Sim ou Não, se escolher Sim, vai ativar o módulo e Não desativar. **Exemplo de configuração:** ![Moip Exemplo Configuração básica](https://docs.codemarket.com.br/moip/img/moip1.png) #### Cartão Personalização * **Título Cartão de Crédito:** Informe o título do Cartão de Crédito, ele vai aparecer na listagem dos Pagamentos e também no Pedido * **Título Botão Confirmar Pedido:** Informe o título do Botão Confirmar Pedido, que aparece junto da tela de Pagamento, para o cliente processar o Pagamento e mudar o histórico do Pedido para Em Análise * **Informação Pagamento:** Informe o texto que ira aparecer acima dos dados do Cartão de crédito, opcional para exibir alguma mensagem para o seu cliente, como informar que a compra é segura ou algum procedimento, pode ser usado vários coringas para personalizar essa informação, como: * {cartao} Últimos dígitos do Cartão e Bandeira * {desconto_reais} Valor de desconto * {juros} Valor do juros * {parcelamento} Quantidade de parcelas e valor * {total} Valor total pago no Cartão com os descontos e juros do parcelamento * **Mensagem Histórico:** Informe o texto que ira aparecer no histórico, no Status inicial em Análise, pode ser usado vários coringas para personalizar essa informação, como: * {cartao} Últimos dígitos do Cartão e Bandeira * {desconto_reais} Valor de desconto * {juros} Valor do juros * {parcelamento} Quantidade de parcelas e valor * {total} Valor total pago no Cartão com os descontos e juros do parcelamento #### Cartão Parcelas Nesta etapa, pode informar a configuração de cada parcela do Cartão, como o valor mínimo do Pedido para Habilitar elas e o juros de cada parcela. Já para a 1x, pode definir o desconto em porcentagem, um número de 0-100. **Parcela 1x** * **Desconto à vista % (0-100):** Informe o valor de Desconto à vista % (0-100), um número de 0 até 100, para o desconto em porcentagem para pagamento em 1x, exemplo: 5, logo o sub total vai ter 5% de desconto se o cliente escolher 1x, caso custe 100 reais, vai ficar em 95 reais. **Parcela 2x até 12x** * **Pedido mínimo:** Informe o valor para habilitar a parcela, ela só vai ser exibida, quando o valor do pedido for igual ou maior ao valor informado. Use sempre ponto no lugar da vírgula ou valor inteiro, exemplo 350.80 ou 350. * **Juros % (0 até 100):** Informe o valor de Juros a % (0-100), um número de 0 até 100, para o juros de pagamento, exemplo: 4x juros de 10, se o pedido custa 100 reais, vai ficar 110 reais o total com o juros. ### Boleto #### Boleto - Configuração básica * **Instrução Boleto Linha 1 (até 60 caracteres):** Texto de Instrução que ira aparecer no Boleto Linha 1 * **Instrução Boleto Linha 2 (até 60 caracteres):** Texto de Instrução que ira aparecer no Boleto Linha 2 * **Instrução Boleto Linha 3 (até 60 caracteres):** Texto de Instrução que ira aparecer no Boleto Linha 3 * **Desconto % (0 até 100):** Informe o valor de Desconto % (0-100), um número de 0 até 100, para o desconto em porcentagem para pagamento em 1x, exemplo: 5, logo o sub total vai ter 5% de desconto se o cliente escolher 1x, caso custe 100 reais, vai ficar em 95 reais. * **Ordem na Listagem de Pagamento:** Informe a ordem que deseja que aparece na listagem de Pagamento, quanto menor, primeiro fica na ordem, exemplo Cartão de Crédito 1 e Boleto 2, neste caso o Cartão de Crédito aparece antes do Boleto * **Habilitar Modo de Teste:** Informe se deseja ativar o modo de teste, recomendado apenas para teste, acima das tabs, aparece se o Cartão está no modo de teste ou não também para facilitar. Sim ou Não, se escolher Sim, vai ativar o modo de teste e Não vai ativar o modo de Produção. * **Prazo vencimento em dias:** Informe o prazo para Vencimento do Boleto em dias * **Região Geográfica:** Informe a região que deseja habilitar o módulo, se não definir, vai funcionar para todas * **Habilitar:** Informe se deseja ativar o Boleto, fazendo o mesmo aparecer na listagem de Pagamentos se todas as condições forem atendidas, como a região geográfica. Sim ou Não, se escolher Sim, vai ativar o módulo e Não desativar. #### Boleto Personalização * **Informação Pagamento:** Informe o texto que ira aparecer acima dos dados do Boleto, opcional para exibir alguma mensagem para o seu cliente, como informar que a compra é segura ou algum procedimento, pode ser usado vários coringas para personalizar essa informação, como: * {desconto_reais} Valor em reais do desconto por Boleto * {total} Valor de desconto: Valor total do Pagamento por Boleto * **Mensagem Histórico:** Informe o texto que ira aparecer no histórico, no Status inicial em Aguardando Pagamento, pode ser usado vários coringas para personalizar essa informação, como: * {desconto_reais} Valor em reais do desconto por Boleto * {total} Valor de desconto: Valor total do Pagamento por Boleto * {botao} Botão gerado com o Link do Boleto * {link} URL do Boleto, pode ser usado para criar um Link ou Botão por exemplo * {linha_digital} Exibe os números do Boleto para Pagamento * **Modal - Conteúdo:** Informe o texto que ira aparecer no Conteúdo do Modal,, pode ser usado os mesmos coringas da Mensagem Histórico para esse conteúdo, exemplo {linha_digital} para informar os números do Boleto * **Título Boleto:** Informe o título do Boleto, ele vai aparecer na listagem dos Pagamentos e também no Pedido * **Título Botão Confirmar Pedido:** Informe o título do Botão Confirmar Pedido, que aparece junto da tela de Pagamento, para o cliente processar o Pagamento e mudar o histórico do Pedido para Aguardando Pagamento * **Modal Título:** Informe o título do Modal aberto após gerado o Boleto * **Modal - Título Botão Direito:** Informe o título do Botão do lado direito do modal, esse botão abre o Boleto gerado e vai para a página de sucesso * **Modal - Título Botão Esquerdo:** Informe o título do Botão do lado esquerdo do modal, esse botão fecha o Modal e vai para a página de sucesso ### Geral #### Status Pedidos Nesta etapa, você vai definir os Status de sua loja, relacionados com os Status dos Pedidos na Wirecard, basta relacionar entre ambos, caso não tenha o Status correto em sua loja, crie o mesmo, que ira aparecer para relacionar. * **Status aguardando confirmação de pagamento (Boleto):** Pedido aguardando confirmação de pagamento. Indica que há um boleto que ainda não foi confirmado pelo banco, mas foi criado * **Status em análise (Cartão):** Pedido aguardando confirmação de pagamento. Indica que há um pagamento de cartão em análise. * **Status Pago:** Pedido pago. O pagamento criado neste pedido foi autorizado. * **Status Não Pago:** Pedido não pago. O pagamento criado neste pedido foi cancelado (Pagamentos com cartão podem ser cancelados pela Wirecard ou pelo emissor do cartão, boletos são cancelados 5 dias após vencimento, débito bancário é cancelado em caso de falha). * **Status Revertido:** Pedido revertido. Sofreu um chargeback ou foi completamente reembolsado. * **Alertar sobre mudança no status do Pedido:** Informe se deseja enviar um E-mail para o cliente sobre a mudança no histórico do pedido, Sim caso deseje enviar e Não caso prefira não enviar. #### Configuração Nesta etapa, você vai definir a relação dos Campos Extras e nome na Fatura do Cartão É essencial a criação e relação dos campos extras criados, pois são dados obrigatórios para a Wirecard, por isso recomendamos que use máscara e validação nesses campos e outros do cadastro do cliente, para evitar erros neles. Para Máscaras e validação do CPF/CNPJ, recomendamos esse módulo de nosso equipe: [Validar e Máscara (Cep, CPF, CNPJ e Telefone) - Cadastro e Checkout para Opencart 2 e 3 ](https://www.codemarket.com.br/produto/validar-e-mascara-cep-cpf-cnpj-e-telefone-cadastro-e-checkout-para-opencart "Validar e Máscara (Cep, CPF, CNPJ e Telefone) - Cadastro e Checkout para Opencart 2 e 3") , já acompanha instalação e adaptação ao tema * **Nome na Fatura (máximo 13 caracteres):** Informe o nome para aparecer na Fatura * **Campo Extra CPF:** Relacione com o Campo Extra CPF da Loja , usado nos dados do cliente para pessoa física, recomendado uso de máscara nesse campo para evitar erros de cadastro e que seja obrigatório * **Campo Extra CNPJ:** Relacione com o Campo Extra CNPJ da Loja, usado nos dados do cliente, para pessoa jurídica, recomendado uso de máscara nesse campo para evitar erros de cadastro e que seja obrigatório * **Campo Extra Número:** Relacione com o Campo Extra Número da Loja, usado no endereço, recomendado que seja um campo obrigatório * **Campo Extra Complemento:** Relacione com o Campo Complemento da Loja, usado no endereço * **Campo Extra Data de Nascimento:** Relacione com o Campo Extra Data de Nascimento da Loja , usado nos dados do cliente para pessoa física, recomendado uso de máscara nesse campo para evitar erros de cadastro e que seja obrigatório ### Configuração Exemplo Nesta etapa, vamos mostrar alguns exemplos de Configuração base #### Cartão Personalização **Mensagem Histórico:** Pagamento por Cartão de Crédito {cartao} Valor de Desconto: {desconto_reais} Valor juros do parcelamento: {juros} {parcelamento} Valor total: {total} #### Boleto Personalização **Informação Pagamento:**

Pague de forma segura por Boleto

Desconto de {desconto_reais}

Valor total {total} **Mensagem Histórico:** Pagamento por Boleto Valor de Desconto: {desconto_reais} Valor total: {total} Clique no botão abaixo para abrir o Boleto {botao} Pagamento, clique aqui **Modal - Conteúdo:**

O boleto foi gerado com sucesso, você pode optar por visualizar o boleto clicando em "Visualizar boleto"

{linha_digitavel} ## FAQ Nessa página, iremos explicar algumas dúvidas gerais de forma resumida e pequenas dicas ### Qual versão do Opencart que o módulo funciona e requisitos? * O módulo funciona para Opencart 2.x até 3.x, para todas as versões deles * Precisa do PHP 5.6 ou mais atual * Painel Codemarket * Checkout Padrão da plataforma Opencart de preferência * Cadastro ativo na Wirecard (Moip) ### Protocolo TSL 1.2 obrigatório É obrigatório o uso de SSL e da versão TSL 1.2 do protocolo de SSL, pode verificar em sua hospedagem, a maioria hoje já suporta essa versão, ela é altamente recomendada por questão de segurança. Segue a informação da Wirecard (Moip) sobre isso: "Temos um protocolo que é responsável pela transmissão de informações do seu site para o Moip com segurança. Esse protocolo é chamado TLS e a partir do dia 30/06/2018 ele será atualizado para a versão 1.2 e todas as versões anteriores (1.0 e 1.1) serão desativadas. Não esqueça de verificar o seu sistema e garantir que ele está pronto para o TLS 1.2, caso contrário o Moip poderá parar de funcionar no seu site." Para mais detalhes da informação no [Moip](https://dev.moip.com.br/page/atualização-do-protocolo-de-segurança-tls-12) Para realizar um teste, use o SSL Labs, endereço: https://www.ssllabs.com/ssltest/analyze.html?d=codemarket.com.br&latest Troque codemarket.com.br para o endereço do seu site, ele vai avaliar o SSL em seu site, informar a pontuação, recomendados A ou A+ e também informa a versão do TLS suportado. Vá até Configuration -> Protocols e veja em TLS 1.2 se aparece Yes, se sim, está tudo certo com o seu protocolo de SSL Veja como deve aparecer: ![Moip Exemplo Configuração básica](https://docs.codemarket.com.br/moip/img/ssl-teste.png) ### Ele funciona em qualquer Checkout? O funcionamento em Checkout fora do padrão da plataforma Opencart, vai depender basicamente da qualidade do Checkout e compatibilidade do mesmo Temos instalado em algumas lojas com Checkouts fora do padrão da plataforma e alguns até não indicados funcionou normalmente, porém não tem como garantirmos que vai funcionar em qualquer Checkout, por isso recomendamos sempre que use o padrão ou um bem feito. ### Como deve ser o cadastro da Loja? Recomendamos que a loja valide bem os campos do cadastro, use máscara e os campos extras obrigatórios, para o melhor funcionamento do módulo e usabilidade do cliente, que só precisa informar alguns dados no Cadastro e não no Pagamento novamente. Fundamental também o uso de máscara nos campos CEP, Telefone, Data de Nascimento e outros, para evitar erros de digitação do cliente. ### Módulo recomendado para o Cadastro e Checkout? Recomendamos os seguintes módulos para ajudar na validação e usabilidade do Cadastro e Checkout de sua loja * [Validar e Máscara (Cep, CPF, CNPJ e Telefone) - Cadastro e Checkout para Opencart 2 e 3 ](https://www.codemarket.com.br/produto/validar-e-mascara-cep-cpf-cnpj-e-telefone-cadastro-e-checkout-para-opencart "Validar e Máscara (Cep, CPF, CNPJ e Telefone) - Cadastro e Checkout para Opencart 2 e 3") * [Completar Endereço pelo CEP Premium para Opencart](https://www.codemarket.com.br/produto/completar-endereco-pelo-cep-e-campos-extras-para-opencart "Completar Endereço pelo CEP Premium para Opencart ") ### Qual versão do Opencart mais recomendada atualmente? Recomendamos o Opencart 3.0.2.0 e o 2.3.0.2, para mais detalhes veja o artigo [Qual versão do Opencart usar?](https://www.codemarket.com.br/blog/post/qual-versao-do-opencart-usar). Evite usar versões antigas do Opencart 2.x ou 3.x. ### A licença é realmente gratuita, não pago nada? Isso mesmo, a licença de uso é totalmente gratuita e sem custo, incluso o suporte de 3 meses e atualizações sem custo. ### Posso usar em mais de uma loja? Sim, para usar em mais de uma loja, precisa fazer um pedido com uma nova licença, para poder gerar a Licença para a loja desejada. ## Suporte Codemarket Vamos ensinar nesta etapa, como entrar em contato conosco para Suporte ou Dúvida. ### E-mail Esse é o Canal no qual preferimos, devido a facilidade do seu uso por ambas as partes, poder enviar imagens, vídeos e ficar tudo registrado, uma excelente forma de comunicação e também muito útil para suporte. **Para abrir um suporte por e-mail, envie um e-mail para:** **contato@codemarket.com.br** **Assunto:** Suporte Pagamento Wirecard (Moip) Opencart Checkout - Resumo do problema **Conteúdo:** Tente informar de forma resumida e completa sobre o motivo do suporte, para agilizar o atendimento do mesmo, segue os dados importantes no conteúdo do e-mail: **E-mail usado em nosso site para o Pedido:** Nome da Loja: URL da Loja: Versão do Opencart: Checkout nativo: Sistema de Cache na Loja ou Hospedagem: Resumo do motivo do suporte ou dúvida: **Opcional:** Dados do FTP da loja: Dados da administração da loja: ### Prazo estimado do suporte Nosso suporte é feito de segunda a sexta feira, entre 11:00 e 17:00, o prazo estimado é de 2-3 dias úteis para um retorno, para resolver o suporte, o prazo varia conforme a complexidade do mesmo e agilidade nas informações dos dados necessários para podermos verificar, normalmente é resolvido entre 3-5 dias úteis.