Plugin Rede API WooCommerce

Documentação
Informações de configuração do Plugin Rede Ecommerce para WooCoommerce.

O que é o Plugin Rede para WooCommerce?

O Plugin Rede para WooCommerce é uma solução desenvolvida para WordPress que permite receber pagamentos online de forma prática e segura. Com ele, você pode aceitar cartões de crédito, débito, PIX, MaxiPago e autenticação 3DS diretamente em sua loja WooCommerce.

O plugin está disponível em duas versões:

• Gratuita, com funcionalidades básicas;
• Pro (licença paga), com recursos avançados.

Além disso, o plugin integra as tecnologias da MaxiPago, reconhecidas por sua alta segurança e ferramentas eficazes de prevenção a fraudes, garantindo maior proteção e confiabilidade nas transações realizadas.

Credenciamento no e.Rede

Para solicitar o credenciamento no e.Rede e integrar sua aplicação, entre em contato com a Central de Atendimento da Rede pelos seguintes canais:

• Capitais e regiões metropolitanas: 4001 4433
• Demais localidades: 0800 728 4433

O que acontece após o credenciamento?

Após o credenciamento, o responsável pelo estabelecimento receberá um e-mail contendo:

• Número de filiação (PV): necessário para configurar a API.
• Orientações para acessar o portal da Rede: informações detalhadas para facilitar o primeiro acesso.
• Credenciais para integração: dados essenciais para configurar a integração com sua aplicação.

Certifique-se de guardar essas informações em local seguro, pois elas serão fundamentais para o funcionamento correto da integração.

O que é o MaxiPago?

O MaxiPago era uma plataforma de pagamento independente adquirida pela Rede (Itaú), oferecendo soluções para processar pagamentos online, como cartões de crédito, débito, boletos bancários e outros métodos.

No entanto, com a aquisição pela Rede, os serviços do MaxiPago estão em processo de descontinuação. Isso significa que, no futuro, ele deixará de ser uma opção viável para transações. Use a Rede API.

O que fazer diante dessa mudança?

A Rede recomenda que novos credenciamentos e integrações sejam feitos diretamente com o Rede E-commerce, uma solução moderna, robusta e constantemente atualizada. Essa transição garante maior suporte, segurança e acesso a funcionalidades mais avançadas.

Compatibilidade do Plugin com MaxiPago

Apesar dessa mudança, o Plugin Rede PRO mantém compatibilidade com as chaves de integração do MaxiPago. Isso possibilita que estabelecimentos que ainda utilizam o serviço concluam suas operações de forma tranquila.

Recomenda-se que, o quanto antes, os usuários migrem para o Rede E-commerce para evitar interrupções e aproveitar os benefícios de uma solução mais completa e integrada.

Como instalar o plugin grátis para Rede e Maxipago?

O Plugin Rede grátis e MaxiPago está disponível no Marketplace oficial do WordPress e pode ser instalado de forma rápida e fácil pelo painel administrativo do seu site. Siga os passos abaixo:

Acesse o painel administrativo do WordPress

Faça login no painel do seu site WordPress.

Vá até a seção de plugins

No menu lateral, clique em “Plugins” e depois em “Adicionar Novo”.

Pesquise pelo plugin

Na barra de pesquisa, digite “Rede”.

Instale o plugin

Encontre o plugin na lista de resultados e clique em “Instalar Agora”.

Ative o Plugin

Após a instalação, clique em “Ativar” para começar a usar.

Pronto! O plugin já estará instalado e pronto para ser configurado de acordo com as necessidades da sua loja.

Imagem ilustrando o plugin Rede para WooCommerce ativado com sucesso na página de gerenciamento de plugins do WordPress. O botão ou link para iniciar as configurações está destacado, orientando o usuário sobre o próximo passo na configuração.

Filiação e Chave de Integração

Para que seu estabelecimento comece a realizar transações utilizando o e.Rede, é necessário configurar a API com as suas credenciais: número de filiação (PV) e chave de integração.

Gerando a Chave de Integração

A chave de integração é um dado confidencial, gerado no Portal da Rede, e somente usuários com perfil de administrador (usuário master) podem realizá-lo. Siga os passos abaixo para gerar a chave:

1. Acesse o portal da Rede com suas credenciais.
2. Navegue até:
   e.Rede > Para Vender > E-commerce > Chave de Integração.
3. Clique no botão Gerar chave de integração.

Perda ou Esquecimento da Chave

Caso perca ou esqueça a chave de integração, será necessário gerar uma nova. Após gerar a nova chave, atualize a configuração da API para garantir que as transações continuem sendo processadas corretamente pela Rede.

Ativar métodos de pagamento

O Plugin Rede para WooCommerce é gratuito e permite habilitar quatro formas de pagamento: cartão de crédito, cartão de débito, MaxiPago e outras opções. Recursos adicionais estão disponíveis na versão PRO, garantindo ainda mais flexibilidade e praticidade para sua loja online.

Para ativar um método de pagamento, basta clicar no botão correspondente ao método desejado e seguir as instruções para configurá-lo.

Configurações do Cartão de Crédito Rede

Ao habilitar o método de pagamento Cartão de Crédito Rede, a versão gratuita oferece configurações básicas, como mostrado na imagem abaixo. Observe que as imagens são ilustrativas e podem não refletir as atualizações mais recentes do plugin.

Para explorar todos os recursos disponíveis, instale o plugin e navegue pelas opções de configuração. Cada funcionalidade conta com um ícone de ajuda que fornece explicações detalhadas, facilitando a configuração e o uso.

Opções de parcelamento do Plugin Gratuito

O Plugin Rede Gratuito permite configurar o parcelamento, oferecendo a opção de definir o número mínimo e máximo de parcelas disponíveis para os pagamentos no cartão de crédito. No entanto, na versão gratuita, não é possível definir os juros para cada parcela, sendo essa funcionalidade exclusiva da versão PRO.

Opções de pagamento por parcelamento

Ao ativar o Plugin Rede PRO, na opção de cartão de crédito, você pode habilitar o parcelamento em até 21 vezes, além de definir os juros aplicados a cada parcela. A imagem ilustra a configuração até 6x, mas essa opção de parcelamento está disponível até 21x.

A opção de exibir a porcentagem de juros habilita um recurso que permite ao comprador visualizar a quantidade de juros embutidos nas parcelas.

Configuração Descrição de Pagamento

A configuração de descrição de pagamento é útil para que o comprador consiga identificar facilmente o seu estabelecimento, facilitando o reconhecimento da compra no extrato do cartão. No entanto, para utilizar esse recurso, ele precisa estar configurado dentro do portal da Rede.

Antes de ativar a descrição de pagamento, siga os passos abaixo:

1. Acesse o portal da Rede com seus dados de login.
2. Vá até a opção Vender > E-commerce > Identificação da Fatura.

3. Na página de Identificação da Fatura, insira uma identificação para facilitar o reconhecimento da compra. O campo deve ter no máximo 12 caracteres e não pode conter acentuação nem espaços.

Após realizar essa configuração no portal da Rede, habilite a opção de descrição de pagamento no plugin. Caso esse passo não seja concluído corretamente no portal da Rede, sua transação poderá resultar em erro.

Configurações do Cartão de Crédito PRO

O plugin PRO da Rede possui recursos adicionais para configuração, incluindo:

• Licença: Campo para inserir a licença adquirida na Link Nacional.
• Captura automática: Habilita a captura automática do pagamento por cartão de crédito, sem necessidade de ação manual. Quando desativado, os pagamentos são pré-autorizados e aguardam captura manual nos detalhes do pedido, recurso útil para verificações de fraude antes da confirmação da transação.
• CSS Customizado (Shortcode): Permite estilizar o CSS dentro do shortcode do checkout.
• CSS Customizado (Editor por blocos): Permite estilizar o CSS para temas baseados em blocos, como o Gutenberg.
• Status de pagamento completo: Define qual será o status do pedido após a confirmação do pagamento.
• Juros do parcelamento: Ao habilitar esse recurso, será possível configurar os juros para cada parcela.

Captura da transação

No plugin grátis, a captura do pagamento é sempre automática. Já na versão PRO, é possível alterar a configuração de captura para manual ou automática. A opção de captura manual permite que o pedido seja confirmado, mas o administrador da loja virtual tenha tempo para realizar verificações no pagamento antes de completá-lo. Ao selecionar a captura automática, todos os pagamentos serão capturados automaticamente. Caso a configuração seja desabilitada, a captura deve ser realizada manualmente dentro do pedido. O prazo para capturar um pagamento manualmente é de até 12 dias (recomenda-se confirmar essa informação com a Rede, pois pode estar desatualizada).

A captura manual é útil em situações onde é necessário validar os dados do pedido, realizar uma verificação de fraude ou aguardar algum tipo de confirmação antes de finalizar o pagamento. Exemplos incluem reservas de hotel, compras de produtos perecíveis ou itens que podem se esgotar rapidamente.

Configurações do Cartão de Débito Rede

Ao habilitar o método de pagamento Cartão de Débito Rede, a versão gratuita disponibiliza configurações básicas, como ilustrado na imagem abaixo. Vale lembrar que as imagens são apenas ilustrativas e podem não refletir as atualizações mais recentes do plugin.

Para conhecer todos os recursos disponíveis, instale o plugin e explore as opções de configuração. Cada funcionalidade possui um ícone de ajuda que oferece explicações detalhadas para facilitar o processo.

Configurações do Ambiente

A opção de configuração de ambiente define o tipo de chaves utilizadas na integração. Se as suas chaves forem de Sandbox, você deve alterar a configuração para o ambiente de teste ou desenvolvimento. Essas chaves normalmente são usadas por desenvolvedores ou usuários avançados.

Se você fez uma homologação com a Rede, suas chaves provavelmente são de produção. Nesse caso, defina o ambiente como produção. Mesmo que deseje realizar um teste, é recomendável usar o ambiente de produção.

Habilitação do Pagamento por Cartão de Débito com Autenticação 3DS

O pagamento por cartão de débito no Plugin Rede PRO utiliza a autenticação 3DS (3-D Secure). No entanto, esse recurso não está ativado por padrão no cadastro do seu estabelecimento na Rede. É necessário habilitá-lo manualmente através do portal da Rede:

1. Acesse o portal da Rede e navegue até:
   Para Vender > E-commerce > 3DS – Data Only.
2. Na página de Contratação 3DS / Data Only, solicite a ativação do serviço.
3. Após a ativação, o portal irá exibir que o ponto de venda já está ativo para as bandeiras VISA e Mastercard.

Com esse recurso habilitado, sua loja estará preparada para processar pagamentos por cartão de débito com maior segurança e conformidade.

Configurações do MaxiPago

Ao habilitar o método de pagamento por Cartão de Débito ou Crédito via MaxiPago, a versão gratuita oferece configurações básicas, como mostrado na imagem ao lado. É importante notar que as imagens são ilustrativas e podem não refletir as atualizações mais recentes do plugin.

Para explorar todos os recursos disponíveis, instale o plugin e acesse as opções de configuração. Cada funcionalidade conta com um ícone de ajuda que fornece explicações detalhadas, facilitando sua configuração.

Como instalar o plugin Rede PRO

O Plugin Rede PRO é uma extensão do plugin gratuito, portanto, é necessário ter o plugin gratuito previamente instalado para utilizá-lo. A versão PRO oferece recursos avançados e contribui para a manutenção do plugin oficial da Rede e MaxiPago, garantindo sua evolução contínua e suporte técnico.

Para adquirir a versão PRO, basta comprar uma licença e seguir as instruções de instalação fornecidas.

Por que comprar uma licença do Plugin Rede PRO?

Adquirir uma licença do Plugin Rede PRO traz diversos benefícios tanto para sua loja quanto para a comunidade que utiliza a solução. Confira os principais motivos:

1. Ajuda na manutenção do plugin: Sua contribuição garante que o plugin oficial continue funcionando de forma eficiente e estável.
2. Incentiva melhorias e novas funcionalidades: Com o suporte dos usuários PRO, é possível desenvolver novos recursos e aprimorar ainda mais a experiência.
3. Atualizações frequentes: O plugin PRO recebe atualizações regulares, mantendo a compatibilidade com o WooCommerce e as últimas tecnologias de pagamento.
4. Maior segurança: Com a versão PRO, você conta com tecnologias avançadas para proteger as transações e garantir a confiança de seus clientes.
5. Atenção: A aquisição do plugin não inclui suporte para instalação ou configuração. Este tipo de suporte pode ser contratado separadamente, por hora técnica, e é totalmente opcional.

Ao investir em uma licença PRO, você não só melhora a qualidade da sua loja online, como também apoia o desenvolvimento contínuo do plugin.

Download do Plugin Rede e MaxiPago PRO

O download do Plugin Rede PRO está disponível na área do cliente da Link Nacional. Após a confirmação do pedido, o plugin é liberado imediatamente para download, permitindo uma instalação rápida e prática.

Além disso, um e-mail será enviado para você com todos os detalhes da licença e o link para download do plugin. Não se esqueça de verificar a caixa de entrada do seu e-mail para acessar as informações.

Instalar o Plugin Rede PRO

A instalação do Plugin Rede PRO é simples e pode ser feita diretamente pela área administrativa do seu WordPress. Basta seguir os passos abaixo:

1. Acesse o menu Plugins > Adicionar Novo > Enviar Plugin.
2. Selecione o arquivo do plugin PRO que você baixou.
3. Clique em Instalar Agora.

Ativar Plugin

Após instalar o Plugin Rede PRO, é necessário ativá-lo. A opção de ativação geralmente aparece imediatamente após a instalação. Basta clicar em Ativar para começar a utilizá-lo.

O Plugin Rede PRO requer a biblioteca IONCUBE ativada no PHP. Caso não consiga ativar o plugin, verifique se aparece uma mensagem de erro no topo do seu WordPress relacionada ao IONCUBE. Se houver, entre em contato com o seu provedor de hospedagem e solicite a ativação da biblioteca no seu plano. Muitas vezes, essa ativação é simples e rápida. Você também pode buscar no Google por ‘Como habilitar IONCUBE [Nome da sua provedora]’, substituindo [Nome da sua provedora] por sua hospedagem, para encontrar tutoriais específicos.

Se o plugin foi ativado com sucesso, ele aparecerá conforme a imagem ilustrativa abaixo, indicando que o plugin está ativo e funcionando corretamente.

Configurar o Plugin Pro

Ao ativar o Plugin Rede PRO, novos métodos de pagamento e funcionalidades estarão disponíveis, incluindo opções avançadas de configuração. Além disso, a versão PRO habilita o meio de pagamento por PIX através da Rede e MaxiPago, oferecendo mais flexibilidade para sua loja online.

Ao ativar o PIX através da Rede ou MaxiPago, você poderá configurar os novos métodos de pagamento. Além disso, serão disponibilizadas novas opções de configuração para os meios de pagamento de cartão de crédito e débito, tanto para a Rede quanto para o MaxiPago, permitindo personalizar de acordo com as necessidades da sua loja.

Seguindo os passos deste tutorial, você poderá usufruir de um plugin de meio de pagamento avançado e seguro para sua loja online. Caso necessite de suporte ou atendimento especializado, estamos disponíveis para auxiliá-lo mediante a contratação de hora técnica, com atendimento realizado via Google Meet.

Meio de Pagamento PIX (Rede E-commerce)

O meio de pagamento PIX da Rede E-commerce está disponível exclusivamente no Plugin Rede PRO. Essa funcionalidade permite o recebimento de pagamentos via PIX, mas possui uma limitação: só é válida para estabelecimentos que possuem conta corrente no Banco Itaú.

Diferentemente do plugin da CIELO, que permite a utilização de contas correntes em qualquer banco, o PIX da Rede exige essa vinculação ao Itaú.

Se você for correntista do Banco Itaú e tiver adquirido o Plugin Rede PRO, poderá configurar essa funcionalidade diretamente no plugin.

As configurações do PIX são intuitivas e contam com ícones de ajuda (?), que fornecem descrições detalhadas sobre cada campo, facilitando o entendimento e a configuração. Vale destacar que alguns itens podem aparecer em inglês devido ao processo de aprovação de traduções pelo WordPress. Isso não interfere no funcionamento do recurso.

Tela do checkout para usuário concluir o pagamento do PIX no WooCommerce.

Confirmação de pagamento automático do PIX

O estabelecimento deverá informar uma URL válida presente nas configurações da Rede denominada como Endpoint. Assim irá garantir o retorno automático da confirmação de pagamento. O cadastro dessa URL será por CNPJ, independente de quantos ou quais PV’s foram habilitados para aquele estabelecimento.

Para esse cadastro, o responsável pelo estabelecimento deve ligar na central de atendimento nos telefones:

• Central de atendimento: Capitais e regiões metropolitanas 4001 4433
• Central de atendimento: Demais localidades 0800 728 4433

Deverá informar: o número de CNPJ, PV, e-mail para contato e o endpoint da URL que deseja utilizar para receber as notificações do PIX. O prazo para ativação é de 2 dias uteis após a abertura do chamado.

Após a configuração do PIX e o endereço do EndPoint junto a Rede, quando a transação é confirmada, o status do pedido é atualizado automaticamente.

Após a confirmação do pagamento via Pix, o código do Pix deixa de ser exibido ao usuário, sendo substituído pela mensagem “Pagamento realizado com sucesso!”

Depuração: Log de erros das transações

Para identificar erros, recomenda-se habilitar a verificação dos logs de erro. No entanto, utilize essa configuração apenas para esse fim, mantendo-a sempre desabilitada para garantir a privacidade dos dados. Para habilitar os logs de depuração, acesse as configurações do plugin, aba Desenvolvedor e ative a opção Ativar registro de depuração. Com o recurso ativado as transações serão armazenadas em um log.

Após ativar a depuração, as informações serão armazenadas. Clique em “Veja os registros” para ser redirecionado à página com os logs do WooCommerce. Nesta página, clique no log “rede”.

Dentro do log, é possível visualizar as informações, fazer o download ou excluí-lo permanentemente. Baixe o log e envie para o desenvolvedor analisar. Após a correção, exclua o log e mantenha a depuração desativada para preservar informações sensíveis.

Erro: Unknown PIX Key

Para solucionar esse erro entre em contato direto com a Rede pois o PV configurado no plugin não esta com a chave PIX replicada no PV.