Versão: WooCommerce 8.0.2
Versão: Wordpress 6.3.x
Plugin iPag Versão: Principal v2.11.0
Download:
Requisitos antes de instalar:
Requisito 1:
- Ter uma conta iPag de Sandbox (testes) configurada com métodos de pagamento de teste, (caso você não tenha clique aqui) ou;
- Ter uma conta de Produção do iPag com uma Adquirente configurada e métodos de pagamento disponíveis.
Requisito 2:
- Ter o WordPress instalado e configurado em um servidor;
- Ter o plugin WooCommerce instalado e ativo no WordPress;
- Ter o plugin iPag instalado e ativo no WooCommerce.
Instalação do plugin WooCommerce:
Faça login no seu WordPress e então no menu lateral, clique em “PLUGINS”;
No canto superior esquerdo, clique em “ADICIONAR NOVO”;
No campo “PESQUISAR”, digite “WOOCOMMERCE”
O plugin WooCommerce irá ficar visível, clique então no botão “INSTALAR AGORA”:
Por fim, clique em “ATIVAR”, para ativar o plugin WooCommerce:
A tela de boas-vindas é apresentada.
O foco agora é a instalação do plugin iPag, então, escolha a opção “AGORA NÃO”
Instalação do plugin iPag:
No canto superior esquerdo, clique em “ADICIONAR NOVO”;
No campo “PESQUISAR”, digite IPAG;
Clique no botão “INSTALAR AGORA”;
Clique no botão “ATIVAR”;
Pronto, com os plugins instalados, agora é necessário realizar a configuração do plugin iPag.
Configuração do plugin iPag:
Depois que o plugin estiver instalado e ativo, é necessário fazer a configuração dos métodos de pagamento.
Os métodos de pagamento disponíveis no iPag são, cartões de crédito e débito e boletos.
Verifique junto a sua adquirente, quais os métodos de pagamento que ela lhe oferece, pois, estes serão os mesmos que serão configurados no plugin.
Vamos ativar os métodos de pagamento, lembre-se de verificar quais os métodos de pagamento que a sua adquirente disponibiliza para a sua conta no iPag. Caso tenha dúvida do método de pagamento disponível na sua conta iPag, clique no MENU > ADMINISTRAÇÃO > MÉTODOS DE PAGAMENTO.
Localize no MENU lateral do WordPress, a opção WooCommerce e clique nela, agora localize no MENU lateral a opção Configurações, clique novamente:
Clique na ABA Pagamentos:
Habilite os métodos de pagamento que estarão disponíveis no seu e-commerce (Esses métodos precisam ser disponibilizados pela sua adquirente e configurados na sua conta iPag), localize o botão azul no fim da página, SALVAR ALTERAÇÕES.
Configurar método de pagamento Cartão de Crédito:
Após habilitar o método de pagamento Cartão de crédito, clique em GERENCIAR.
As imagens abaixo mostram um exemplo de como os campos devem ser preenchidos:
| Descrição dos campos com preenchimento obrigatório | |
|---|---|
| Ativar iPag Gateway de Pagamento | para o método de pagamento estar disponível, a caixa de seleção deve estar checada (neste caso, o método de pagamento cartão de crédito); |
| Título | Defina um título do método de pagamento; |
| Login iPag | seu login utilizado para acessar o painel do iPag; |
| Ipag API KEY | chave obtida na seção Minha Conta no painel do iPag. Veja aqui, onde encontrar a API_KEY; |
| Bandeiras Aceitas | clique na caixa e selecione as bandeiras de cartão que serão aceitas. As bandeiras disponíveis para cartão de crédito no iPag são: Visa, Master Card, Dinners, Discover, ELO, American Express (AMEX), Hipercard, JCB e Aura; |
| Utilizar parâmentros de parcelamento configurados na conta | Configuração habilita a opção de utilizar as taxas iPag, como o repasse de juros ao cliente. |
| Parcela Mínima | Valor mínimo da parcela para habilitar o parcelamento, ou seja, O menor valor permitido para cada parcela; |
| Parcelar em Até | Número máximo de parcelas para todas as compras no e-commerce. O iPag disponibiliza parcelamento máximo em 12x; |
| Taxa de Juros (%) | Taxa única de juros a ser aplicada nas parcelas. Apenas é possível configurar uma única taxa de juros para serem embutidas nas parcelas. O cálculo de juros é feito pelo método da tabela PRICE; |
| Parcelas sem Juros | Quantidade de parcelas sem aplicação de juros. Os juros começaram a ser cobrados na próxima parcela. Ex: Parcelamento em 3x, sem juros a vista e com juros a partir da segunda parcela, deve ser definir o valor 1x, no campo. Se não for cobrados juros, o campo deve ser preenchido com o mesmo valor do campo “PARCELAR EM ATÉ”. |
| Ambiente | Selecione a opção “Produção”, se tiver uma conta contratada junto ao iPag (Conta apta a receber pagamentos). Selecione “Teste”, caso tenha conta apenas no Sandbox, (Conta não está apta a receber pagamentos). |
| Habilitar pagamentos com cartões salvos | Opção para salvar o cartão, caso utilize opção One Click Buy |
| Ativar Depuração | Marque esta opção para habilitar os logs do sistema e assim, ficar mais fácil encontrar os motivos para problemas e erros. |
| Ativar mara do iPag no Checkout | Aparecer Logo iPag |
| Desativar campo de CPF do portador do cartão | Desativar necessidade de CPF para pagamento |
| Desativar efeito de visualização no prenchimento dos dados do cartão | Mascara aplicada nos cartões |
| Status Aprovado | Selecione o Status na caixa de seleção: “Aguardando”. |
| Status Reprovado | Selecione o Status na caixa de seleção: “Malsucedido”. |
| Status Capturado | Selecione o Status na caixa de seleção: “Concluído”. |
| Status Cancelado | Selecione o Status na caixa de seleção: “Cancelado”. |
| Campos com preenchimento opcional | |
|---|---|
| Habilitar PagSeguro | Marque 'Sim', apenas, caso vá utilizar a integração com o PagSeguro. |
| PagSeguro Ambiente | Caso vá utilizar o boleto via PagSeguro, marque o ambiente que irá utilizar. Se estiver apenas realizando testes, marque a opção 'Teste'. |
| PagSeguro Email | E-mail de acesso do PagSeguro |
| PagSeguro Token | Token de acesso do PagSeguro |
Após inserir os dados da configuração, clique no botão azul SALVAR ALTERAÇÕES.
Importante:
Caso esteja fazendo teste, utilizando o ambiente Sandbox, envie um email para suporte@ipag.com.br, para que seja configurado métodos de pagamento de teste.
Configurando método de pagamento Boleto:
Antes de habilitar o método de pagamento boletos na configuração do plugin iPag, é necessário solicitar ao banco, da conta contratada, a disponibilização do método de pagamento boletos, clique aqui e saiba mais.
Se o método de pagamento boleto já estiver configurado na conta iPag, clique em GERENCIAR.
As imagens abaixo mostram um exemplo de como os campos devem ser preenchidos:
| Descrição dos campos com preenchimento obrigatório | |
|---|---|
| Ativar iPag Gateway de Pagamento | Para o método de pagamento estar disponível, a caixa de seleção deve estar checada (neste caso, o método de pagamento boleto); |
| Título | Título a ser exibido no método de pagamento |
| Login iPag | Login utilizado para acessar o painel do iPag. |
| iPag API KEY | Chave do iPag obtida na seção Minha Conta no painel do iPag. Veja aqui, onde encontrar a API_KEY; |
| Banco Emissor do Boleto | Clique na caixa de seleção e selecione o banco que emitirá o boleto (Banco ao qual a conta de recebimento dos pagamentos está contratada). |
| Dias para Pagar | Quantidades de dias para expirar o boleto (Se definido o valor 0 (zero), o boleto vencerá no mesmo dia da sua emissão, se definido o valor 1 (um), o boleto vencerá no dia seguinte a semissão e assim sucessivamente.. |
| Mensagem no Checkout | Mensagem informativa que será exibida no checkout para o cliente. |
| Ambiente | Selecione a opção “Produção”, se tiver uma conta contratada junto ao iPag (Conta apta a receber pagamentos). Selecione “Teste”, caso tenha conta apenas no Sandbox, (Conta não está apta a receber pagamentos). |
| Ativar Depuração | Marque esta opção para habilitar os logs do sistema e assim, ficar mais fácil encontrar os motivos para problemas e erros |
| Campos com preenchimento opcional | |
|---|---|
| PagSeguro Ambiente | Caso vá utilizar o boleto via PagSeguro, marque o ambiente que irá utilizar. Se estiver apenas realizando testes, marque a opção 'Teste'. |
| PagSeguro Email | E-mail de acesso do PagSeguro |
| PagSeguro Token | Token de acesso do PagSeguro |
Após inserir os dados da configuração, clique no botão azul SALVAR ALTERAÇÕES.
Importante:
Caso esteja fazendo teste, utilizando o ambiente Sandbox, envie um email para suporte@ipag.com.br, para que seja configurado métodos de pagamento de teste.
Configurando método de pagamento Cartão de Débito:
Antes de habilitar o método de pagamento cartão de débito, na configuração do plugin iPag, é necessário verificar se a adquirente contratada possui esse método de pagamento disponível.
Se a adquirente disponibilizar o método de pagamento cartão de débito e ele já estiver configurado na conta iPag, clique em GERENCIAR.
As imagens abaixo mostram um exemplo de como os campos devem ser preenchidos:
| Descrição dos campos com preenchimento obrigatório | |
|---|---|
| Ativar iPag Gateway de Pagamento | Para o método de pagamento estar disponível, a caixa de seleção deve estar checada (neste caso, o método de pagamento cartão de débito); |
| Título | Defina um título do método de pagamento; |
| Login iPag | Seu login utilizado para acessar o painel do iPag; |
| IPag API KEY | Chave obtida na seção Minha Conta no painel do iPag. Veja aqui, onde encontrar a API_KEY; |
| Bandeiras Aceitas | Clique na caixa e selecione as bandeiras de cartão que serão aceitas. As bandeiras disponíveis para cartão de crédito no iPag são: Visa, Master Card, Dinners, Discover, ELO, American Express (AMEX), Hipercard, JCB e Aura; |
| Ambiente | Selecione a opção “Produção”, se tiver uma conta contratada junto ao iPag (Conta apta a receber pagamentos). Selecione “Teste”, caso tenha conta apenas no Sandbox, (Conta não está apta a receber pagamentos). |
| Ativar Depuração | Marque esta opção para habilitar os logs do sistema e assim, ficar mais fácil encontrar os motivos para problemas e erros. |
Após inserir os dados da configuração, clique no botão azul SALVAR ALTERAÇÕES.
Importante: Caso esteja fazendo teste, utilizando o ambiente Sandbox, envie um email para suporte@ipag.com.br, para que seja configurado métodos de pagamento de teste.
Configurando método de pagamento PIX:
Antes de habilitar o método de pagamento Pix na configuração do plugin iPag, é necessário solicitar ao iPag, a disponibilização do método de pagamento em sua conta.
Se o método de pagamento Pix já estiver configurado na conta iPag, clique em GERENCIAR.
As imagens abaixo mostram um exemplo de quais os campos podem ser preenchidos:
| Descrição dos campos com preenchimento obrigatório | |
|---|---|
| Ativar iPag Gateway de Pagamento | Para o método de pagamento estar disponível, a caixa de seleção deve estar checada (neste caso, o método de pagamento Pix); |
| Título | Defina um título do método de pagamento; |
| Login iPag | Seu login utilizado para acessar o painel do iPag; |
| IPag API KEY | Chave obtida na seção Minha Conta no painel do iPag. Veja aqui, onde encontrar a API_KEY; |
| Mensagem do Checkout | Mensagem apresentada para o pagamento do Pix |
| Ambiente | Selecione a opção “Produção”, se tiver uma conta contratada junto ao iPag (Conta apta a receber pagamentos). Selecione “Teste”, caso tenha conta apenas no Sandbox, (Conta não está apta a receber pagamentos). |
| Ativar Depuração | Marque esta opção para habilitar os logs do sistema e assim, ficar mais fácil encontrar os motivos para problemas e erros. |
Após inserir os dados da configuração, clique no botão azul SALVAR ALTERAÇÕES.
Importante: Caso esteja fazendo teste, utilizando o ambiente Sandbox, envie um email para suporte@ipag.com.br, para que seja configurado métodos de pagamento de teste.
Modelo de pagamento com 2 (dois) cartões.
Infelizmente este modelo está desativado.
Observações gerais
O Checkout do WooCommerce deve solicitar que o cliente informe os dados obrigatórios para o Controle de Fraudes (telefone, CPF, Endereço Completo, data de nascimento, sexo).
Sugerimos instalar o módulo Extra Checkout Fields for Brazil.
Nome do plugin foi alterado de “WooCommerce Extra Checkout Fields for Brazil” para“Brazilian Market on WooCommerce”. Seria importante sua utilização para vendas internacionais.
Configurações recomendadas para o plugin Extra Checkout Fields for Brazil:
Dúvidas Frequentes:
- O plugin iPag é compatível com assinaturas e recorrência ?
Sim, é possível utilizar o plugin do iPag com o Pugin WooCommerce Subscriptions para utilização de recorrência, este plugin infelizmente é pago para sua utilização.
- Onde encontro o arquivo de log do plugin?
Dentro da pasta do seu site, acesse a pasta do Wordpress. Vá em wp-content/plugins/ipag-woocommerce/logs, ou /wp-content/plugins/ipag-gateway/logs/.
- 3DS disponivel no plugin?
Sim, hoje o plugin iPag ja conta com a tecnologia 3DS.
Informações Extras:
O WordPress e WooCommerce estão sempre em atualização, e algumas vezes podem ocorrer inconsistências nas versões. Por isso, sempre mantenha seu plugin atualizado, e comunique o iPag caso haja algum erro, por meio do email suporte@ipag.com.br.
Outra forma de acessar a configuração dos métodos de pagamento é, no MENU lateral do WordPress, clicar em PLUGINS, encontrar o plugin iPag WooCommerce e então, clicar no método de pagamento que deseja configurar.
Veja Também:
Criar uma conta de testes no ambiente Sandbox
Instalando Plug-in Antifraude no WooCommerce/Wordpress
Dúvidas ou Sugestões? Envie um e-mail para suporte@ipag.com.br
Este artigo foi útil?
Que bom!
Obrigado pelo seu feedback
Desculpe! Não conseguimos ajudar você
Obrigado pelo seu feedback
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo