Como instalar o Plugin Getnet no Woocommerce?

Atenção:
1- Para baixar ou obter atualizações de plugins acesse sua conta > downloads em www.loja5.com.br
2- Para atualizações de módulos e plugins o processo é o mesmo de instalação (guia abaixo), lembre-se de fazer backup antes e após atualizar os arquivos reconfigurar todo seu módulo novamente.

O que é a Plataforma Digital da Getnet?
A Plataforma Digital é um ecossistema completo criado para fornecer as mais diversas soluções para o mercado de pagamentos (eCommerce, mCommerce). Com ela você terá disponível uma gama de ferramentas para seu comércio eletrônico, que possibilitam, inclusive, a integração também com o seu comércio físico. Esta plataforma foi construída com o intuito de atender as necessidades de cada cliente de forma personalizada, portanto, para utilizar os recursos da plataforma você pode optar por utilizar diretamente a API Getnet.

Atenção, recomendamos o uso de um Captchar para evitar problemas de Bots e Testadores, https://wordpress.org/plugins/wp-recaptcha-integration/ 

Requisitos:
- Woocommerce >= 4.x / 5.x / 6x / 7.x
- Ser Credenciado a Getnet API (Pacote Avançado) (cadastre-se aqui)
- PHP 5.6.x / 7.x / 8.x
- Ter certificado SSL instalado na loja (https://)
- Campos de Cadastro Brasileiro ( https://br.wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/ )

Pacote Serviços Getnet Suportado:

Métodos de pagamentos suportados:
- Cartões de crédito (visa, elo, mastercard, amex, hiper e hipercard)
- Cartões de débito (visa electron (visa), maestro (mastercard))
- Boleto Bancário Santander* (Apenas no pacote avançado, o mesmo é habilitado a parte junto a Getnet, requer conta Santander empresas, para saber como habilitar contate: [e-mail])

Atenção Caso não tenha CPF/CNPJ no cadastro da loja instalar https://br.wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/ (Obrigatorio)

Bandeiras Cartão de Crédito:

Atenção:
1 - Por padrão a Getnet libera apenas cartões de crédito e débito, para boleto bancário e pix este serviço deverá ser contratado a parte junto a eles.
2 - Sempre antes de qualquer processo de instalação ou atualização de plugin realizar um backup antes.

3 - Pix e Boleto devem ser contratados a parte e configurados junto a Getnet e Santander

Como instalar:

1 - Primeiro, acesse sua conta em nossa loja (clique aqui) depois em Downloads baixe o arquivo de seu módulo e copie o seu serial de registro (mantenha o mesmo a salvo em seu HD ou cloud, só guardamos downloads de clientes por 6 meses), após baixado descompacte o arquivo do módulo.


2 - A instalação poderá ser feita por FTP ou diretamente no admin de seu Wordpress, para instalação por FTP primeiramente acesse o servidor de sua loja via FTP, ao acessar acesse o diretório "wp-contents/plugins" e envie a pasta de seu módulo "loja5-woo-getnet-api" para  dentro do diretório de plugins de seu wordpress e aguarde a conclusão do Upload dos arquivos, para instalação via painel administrativo acesse o admin de seu wordpress depois Plugins > Adicionar Novo, na barra vai ter o botão "Enviar Plugin", clique e selecione o arquivo zipado de seu plugin "loja5-woo-getnet-api.zip" (descompacte antes e zipe somente a pasta loja5-woo-getnet-api), clique em instalar e aguarde o procedimento.


3 - Depois de instalado por um dos métodos acima verifique se seu plugin já esta instalado e ativo, acesse o menu Plugins > Plugins instalados e veja se o mesmo vai exibir na lista e se já esta ativado, caso não exiba verifique se fez os passos anteriores corretamente e caso exiba e não esteja ativo clique em ativar.


4 - Após ativado acesse o menu Wocommerce > Configurações na aba Pagamentos vai lista os métodos de pagamento do plugin instalado, clique nos métodos qual deseja usar em sua loja para exibir a tela de configuração, inicialmente deverá ativar a licença do módulo em sua loja, ao acessar caso exiba o campo pedido o serial apenas informe o mesmo e clique em salvar (copie o serial em sua conta em nossa loja no menu Downloads), ao salvar caso não exiba a tela de configuração clique aqui, caso ative corretamente agora é só configurar o módulo com suas credenciais fornecidas pela Getnet (client id, client secret, seller id), fique atento a questão de ambiente, cada credenciais funciona apenas em seu devido ambiente ou seja, teste apenas em teste e produção apenas em produção.

Para obter credenciais de teste (homologação) ou produção solicite a Getnet caso ainda não as tenha, lembre-se:
- credenciais de homologação o Modo Homologação deverá esta ativado.
- credencias de produção o Modo Homologação deverá esta desativado.

Suporte Getnet: [e-mail]


5 - Configure os métodos qual deseja usar um a um Cartão de crédito, Cartão de débito e Boleto (caso já tenha contratado e liberado junto a Getnet) de forma correta e com as credenciais validas de acordo o ambiente qual deseja usar em sua loja (homologação ou produção), lembre-se que as funcionalidades de Boleto Bancário e Anti-fraudes deverá ser contratado e ativado a parte junto a Getnet
Cartão de crédito: Configure credenciais, ambiente, as bandeiras que deseja usar, softDescriptor (nome que vai exibir na fatura, não poderá ser maior que 13 dígitos e nem existir acentos), parcelas com e sem juros, taxa de juros, parcela minima, tipo de captura (automática efetivar ou posterior para apenas autorizada) anti-fraude (caso tenha contratado), merchant fraude getnet deixe vazio e detalhes extras com os status na loja, de inicio caso esteja em ambiente de homologação ative o modo debug.
Tela de configuração de Parcelas e Juros para Cartão de crédito:

Cartão de débito: Configure credenciais, ambiente, as bandeiras que deseja usar, softDescriptor (nome que vai exibir na fatura, não poderá ser maior que 13 dígitos e nem existir acentos) e detalhes extras com os status na loja, de inicio caso esteja em ambiente de homologação ative o modo debug.
Boleto Bancário (somente se contratado e liberado, caso contrario não o ative): Configure credenciais, ambiente, prazo de validade em dias e detalhes extras com os status na loja, de inicio caso esteja em ambiente de homologação ative o modo debug.

6 - Pronto, após devidamente configurado realize teste de acordo o ambiente, lembre-se que compras em modo de teste não são efetivadas, fique atendo a não manter a loja ativada em ambiente de teste para não confundir os clientes.

Atenção: Ao cadastrar as URLs de retorno de notificações junto a Getnet solicitar a modificação de notificações 1.0 para 1.1 ( https://developers.getnet.com.br/api#tag/Notificacoes-1.1 )

Debugado e Visualizando Logs Getnet?

Para realizar um debug e visualizar logs com motivos de erros ou problemas de integração ou configuração em métodos de pagamento getnet em sua loja é bem simples, primeiro deverá ativar no método qual esta ocorrendo o problema é deseja debugar o modo debug, é uma configuração que exibe ao final da configuração de cada método de pagamento getnet em sua loja, após ativado simule uma compra de forma que seja feito uma requisição de pagamento, assim o sistema salva os logs e erros de debug, após simulado a compra e retornando o erro acesse ao admin de sua loja e o menu woocommerce > status > logs, selecione o log getnet correspondente ao método de pagamento e data qual realizou o teste, e visualize os logs, sempre os últimos são os mais recentes, verifique as mensagens de erros retornando qual geralmente esta o motivo do problema.

Erro "The given client credentials were not valid" motivo?
Caso sua loja esteja retornando o erro acima o mesmo é devido suas credenciais configuradas estarem erradas ou não corresponde ao ambiente, existe ambientes de funcionando onde cada tipo requer credenciais especificas, se a getnet forneceu credenciais de produção as mesmas só funcionam em produção, nenhum outro ambiente vai funcionar, igualmente a cada ambiente.

Formato URL de Retorno API 1.1 (callback) (substituir o domínio por o seu):
https://www.sualojawoo.com.br/wp-admin/admin-ajax.php?action=loja5_woo_getnet_api_ipn

Para fim de teste podem ser utilizados os seguintes cartões:

Cartão	Tipo de Teste	Resultado do Teste
5155901222280001	Transação Autorizada	Transação Aprovada
5155901222270002	Transação Não Autorizada	Cartão Inválido
5155901222260003	Transação Não Autorizada	Cartão Vencido
5155901222250004	Transação Não Autorizada	Estabelecimento Inválido
5155901222240005	Transação Não Autorizada	Saldo Insuficiente
5155901222230006	Transação Não Autorizada	Autorização Recusada
5155901222220007	Transação Não Autorizada	Transacao Não Processada
5155901222210008	Transação Não Autorizada	Excede o Limite de Retiradas
4012001037141112	Transação Autorizada	Transação Aprovada

Observação: Ao utilizar os cartões de teste, é necessário ter atenção em alguns pontos:

• Utilize uma data de vencimento válida, ou seja, posterior à data atual.

• O nome do portador não deve ter caracteres especiais, como acento e Ç.

• O valor do CVV pode ser qualquer valor numérico com três dígitos.

• Para operações de tipo Débito, deve-se utilizar somente o cartão Visa: 4012001037141112.

Em caso de necessidade de suporte para ambiente de Homologação, o que faço?
Caso você esteja no período de homologação e tenha qualquer dúvida ou dificuldade em utilizar nossos serviços, pode nos contatar através do e-mail [e-mail], que entraremos em contato o mais breve possível para lhe auxiliar.

Em caso de necessidade de suporte para ambiente produtivo, o que faço?
Caso você já esteja em ambiente produtivo, entre em contato com a Central de atendimento Getnet pelo telefone 4020 4000 ou 0800 648 8000, disponível 24 horas por dia, 7 dias por semana.

Por que meus clientes não estão conseguindo finalizar compras no débito?
Transações de débito autenticado utilizam um processo de autenticação chamado 3DS, que envolve o banco emissor do cartão, a Getnet e o cliente portador do cartão. Nem todos os bancos brasileiros são participantes do 3DS. Cada banco pode ter uma política diferente para incluir o cartão de um comprador no 3DS. O Santander, em particular, não exige que o cliente solicite ao banco a habilitação do produto débito autenticado para transações de e-commerce. Se as transações de débito do comprador não estão sendo concluídas com sucesso na Plataforma Digital da Getnet, é necessário verificar com o banco emissor se o devido cartão está habilitado para compras online na modalidade débito.

Qual a diferença dos status "APPROVED" e "AUTHORIZED" no status de retorno das transações por cartão de crédito?
“APPROVED”: Transação de confirmação automática (flag “delayed”: false). Confirmada e capturada, sem mais etapas pendentes.
“AUTHORIZED”: Transação com confirmação tardia (flag “delayed”: true). Crédito autorizado aguardando confirmação. Caso não haja confirmação em 7 dias a transação será desfeita. Utiliza-se o seguinte serviço para confirmação:

Documentação Getnet
https://api.getnet.com.br/v1/doc/api

Problema ao ativar um módulo?
https://loja5.zendesk.com/hc/pt-br/articles/360001980232-Problema-ou-erro-ao-ativar-um-m%C3%B3dulo-

Trocar o dominio da licença?
https://loja5.zendesk.com/hc/pt-br/articles/360002245071-Trocando-de-dom%C3%ADnio-em-um-m%C3%B3dulo-licenciado

Gostou de nosso módulo? Acesse nossa loja https://www.loja5.com.br e avalie o mesmo :)