Manual do plugin GetnetManual do plugin Getnet
Home
Home
  • Introdução
  • Instalação
  • Contratação de serviços
  • Configuração
  • URLs de Callback
  • Atualização do plugin
  • Perguntas Frequentes
  • Solução de Problemas
  • Colaboradores
  • Suporte

Configuração

Credenciais

Após receber suas credenciais, é hora de configurar o módulo. Siga os passos abaixo para acessar a área de configuração no painel administrativo do seu site WordPress:

  1. Navegue até WooCommerce > Configurações > Getnet
  2. Selecione o tipo de API desejado: Regional Brasil ou Global
  3. Selecione o ambiente: Homologação ou Produção
  4. Preencha os campos Seller ID, Client ID e Client Secret com as credenciais correspondentes ao tipo de API e ambiente selecionados.

Tela de configurações

Tipo de API

O plugin suporta dois tipos de API Getnet, selecionáveis pela opção API no topo da seção de credenciais:

TipoDescrição
Regional BrasilAPI voltada ao mercado brasileiro.
GlobalAPI global da Getnet (integração SEP).

Países disponíveis na API Global (SEP)

O modo Global não é exclusivo para lojas internacionais. O Brasil também está incluído na lista de países suportados pela API global da Getnet.

Os países aceitos atualmente pelo plugin no modo Global são:

PaísCódigoMoeda
ArgentinaARARS
BrasilBRBRL
ChileCLCLP
ColômbiaCOCOP
EspanhaESEUR
MéxicoMXMXN
PortugalPTEUR
UruguaiUYUYU

A moeda da transação é determinada automaticamente pelo país-base configurado no WooCommerce. Cartão de crédito e Boleto ficam disponíveis apenas se o país-base estiver nessa lista. O Pix, mesmo no modo Global, é restrito ao Brasil (BR).

Cada tipo de API possui seu próprio conjunto de credenciais (Seller ID, Client ID e Client Secret) e seus próprios ambientes (Homologação e Produção). As credenciais de um tipo não são intercambiáveis com o outro.

A diferença entre os dois modos vai além das credenciais cadastradas: ela define qual API da Getnet será utilizada, quais endpoints e regras de autenticação serão aplicados e como o plugin se comporta em relação aos métodos de pagamento e à moeda da transação.

Regional Brasil

No modo Regional Brasil, o plugin usa a estrutura tradicional da API brasileira da Getnet. A operação é voltada ao mercado nacional, com transações em BRL, credenciais próprias do ambiente regional e fluxo compatível com a operação brasileira.

Global

No modo Global, o plugin usa a API global da Getnet, também chamada internamente de integração SEP. Nesse caso, o plugin passa a utilizar outro conjunto de credenciais, outros endpoints e um formato de requisição diferente em alguns meios de pagamento.

Esse modo foi pensado para cenários em que a loja precisa seguir a estrutura global da Getnet, com suporte a outros países previstos pela plataforma.

Comportamento no modo Global

O plugin observa o país-base definido nas configurações do WooCommerce. Essa informação influencia diretamente o comportamento no modo global:

  • Cartão e Boleto: o método só permanece disponível se o país-base da loja estiver dentro da lista de países aceitos pela integração global.
  • Pix: mesmo no modo global, a disponibilidade continua restrita ao Brasil.
  • Moeda: o plugin ajusta automaticamente a moeda da transação com base no país-base configurado no WooCommerce — ou seja, ele usa a configuração estrutural da loja para decidir qual moeda enviar para a Getnet.

No modo Regional Brasil, a moeda da operação permanece sempre em BRL.

Resumo da escolha

Regional BrasilGlobal
API utilizadaAPI brasileira da GetnetAPI global da Getnet (SEP)
CredenciaisCredenciais regionaisCredenciais globais
MoedaSempre BRLBaseada no país-base da loja
Disponibilidade de métodosDefinida pelas configurações do pluginCondicionada ao país-base da loja
PixDisponível no BrasilRestrito ao Brasil

Na prática: se a loja opera somente no Brasil com credenciais brasileiras e fluxo nacional da Getnet, o modo mais natural é o Regional Brasil. Se a operação depende da estrutura internacional da Getnet, com credenciais e regras da API global, o modo correto é o Global.

Atenção às configurações dos ambientes

É crucial garantir que cada credencial seja utilizada no ambiente correto e no tipo de API correto.

Ambientes disponíveis

As credenciais de homologação funcionam apenas no ambiente de homologação, enquanto as credenciais de produção funcionam apenas no ambiente de produção.

Testes

Realize os testes de acordo com o ambiente, lembre-se que compras em ambiente de teste (homologação) não são efetivadas, fique atento a não manter a loja ativada em ambiente de teste.

Métodos de pagamentos

Escolha os métodos de pagamento que deseja utilizar.

  1. Acesse o painel administrativo do WooCommerce;
  2. Clique em Configurações > Pagamentos;
  3. Selecione os métodos de pagamento que deseja habilitar para a sua loja, marcando as opções desejadas na lista abaixo:

payment methos

Dica

Configure os métodos pelos quais deseja utilizar um a um. Para abrir as configurações clique no botão Gerenciar. Lembre-se que para utilizar as funcionalidades de Boleto Bancário e Pix no ambiente de produção, esta opção deverá ser contratada e ativada à parte junto a Getnet.

Cartão de Crédito

Configurações de cartão de crédito

Descrição dos campos

OpçãoDescrição
Habilitar Cartão de CréditoAssinalar a opção para ativar pagamentos com cartão de crédito.
Inserir títuloControla o título que o usuário vê durante o checkout.
Inserir descrição no checkoutControla a descrição que o usuário vê durante o checkout.
Inserir prefixo do pedidoInsira um prefixo para os números dos pedidos. Se usar a conta Getnet para várias lojas, certifique-se de que este prefixo seja único.
Inserir descrição na fatura do compradorTexto exibido na fatura do cartão do comprador.
Imagem do cartão de crédito no checkoutAssinalar a opção para habilitar a imagem de pré-visualização do cartão de crédito no checkout.
Histórico (Logs)Assinalar a opção para habilitar os logs do cartão de crédito (getnet-creditcard-order ou getnet-creditcard-order-error). Para visualizar: WooCommerce > Status > Logs.
Confirmação TardiaAssinalar a opção para reservar o valor no cartão e cobrar depois, quando o produto estiver pronto pro envio
Inserir valor mínimo para parcelar a compraDefine o valor mínimo para habilitar compras parceladas. Se o total da compra for inferior a esse valor, apenas o pagamento à vista será permitido.
Inserir quantidade máxima de parcelasSeleciona a quantidade máxima de parcelas disponíveis para o pagamento.
Juros a partir da parcelaDefine a partir de qual parcela os juros serão aplicados.
Valor inicial dos jurosValor percentual dos juros aplicados na parcela definida.
Incremento nos jurosValor percentual dos juros incrementados em cada parcela.

Parcelamento Avançado

A opção de pacelamento avançado, permite que você possa configurar as opções de parcelamento limitando os valores e a quantidade de parcelas. Para isso primeiramente a opção deve ser ativada conforme a imagem abaixo:

Ativação da opção de parcelamento avançado

Após ativar a opção de parcelamento avançado, as configurações correspondentes serão exibidas logo abaixo:

Opção de parcelamento avançado vazia

Você pode preencher as opções conforme desejar.

Parcelamento Avançado Preenchido

Neste caso de exemplo:

  • Compras entre R$ 30,00 e R$ 199,99 serão parceladas em até 2x;
  • Compras entre R$ 200,00 e R$ 999,99 serão parceladas em até 5x;
  • E compras a partir de R$ 1.000,00 serão parceladas em até 6x;

Tips

Os juros do parcelamento avançado seguirão normalmente as regras definidas.

Confirmação Tardia

A opção "Confirmação Tardia", muda o comportamento padrão de cobrar no cartão logo após o checkout para reservar um valor e deixar a cobrança em um estado "Aguardando", e só será cobrada quando você decidir cobrar e escolher o valor que deve ser menor ou igual a quantidade reservada. Esta opção pode ser ativada em WooCommerce > Pagamentos > Getnet Cartão de Crédito conforme a imagem abaixo:
Confirmação Tardia Preenchido

Para encontrar os pagamentos que estão aguardando uma Confirmação Taridia basta ir em WooCommerce > Pedidos e você poderá visualizar os pedidos que estão aguardando. como na imagem abaixo: Woocommerce Pedidos

Para Confirmar a cobrança basta clicar no pedido que está aguardando e ir em "Getnet confirmação tardia", inserir o valor que quer cobrar e depois clicar em "Autorizar Pagamento" Woocommerce Editar Pedido

Cancelamento/Estorno

É possível realizar a solicitação de cancelamento/estorno de pagamentos com cartões de crédito.

Atenção

Esta operação não poderá ser desfeita.

Para realizar o cancelamento ou estorno de uma compra por cartão de crédito de um pedido WooCommerce, você precisará seguir estas etapas:

  1. Acesse o painel administrativo do WooCommerce.
  2. Clique em Pedidos.
  3. Localize o pedido que deseja cancelar ou estornar.
  4. Clique no botão Reembolso. Clique em reembolso
  5. Insira o valor a ser reembolsado, que deve corresponder exatamente ao total do pedido para evitar erros no processamento da operação.
  6. Clique no botão Reembolso via Getnet Cartão de Crédito (aparecerá a mensagem informando que a operação não pode ser desfeita). Realizar reembolso via getnet

Pronto, agora o reembolso foi concluído com sucesso e aparecerá com o valor estornado destacado em vermelho:

Reembolso realizado

Para verificar o status do pedido reembolsado, acesse o painel administrativo do WordPress: “WooCommerce” > “Pedidos”. Localize o pedido e já aparecerá o status REEMBOLSADO e também receberá a mensagem de Log que “o estorno foi realizado com sucesso”.

Pedido com status de reembolso

Para verificar a mensagem de Log, acesse o painel administrativo do WordPress: “WooCommerce” > “Status” > “Aba logs” > “Selecione a transação” > “Clique em visualizar”. Pronto, aparecerá a mensagem com o status de transação cancelada com sucesso e o seu respectivo valor.

Boleto

Tela de configuração do boleto

Descrição dos campos

OpçãoDescrição
Habilitar Boleto GetnetAssinalar a opção para ativar pagamentos com boleto.
Inserir títuloControla o título que o usuário vê durante o checkout.
Inserir descriçãoControla a descrição que o usuário vê durante o checkout.
Inserir prefixo do pedidoInsira um prefixo para os números dos pedidos. Se usar a conta Getnet para várias lojas, certifique-se de que este prefixo seja único.
Número de dias para vencimentoDias de vencimento do boleto após impresso.
Instruções do boletoInstruções para aparecer no boleto.
HistóricoAssinalar a opção para habilitar os logs do boleto (getnet-boleto-order ou getnet-boleto-order-error). Para visualizar: WooCommerce > Status > Logs.
Nome do DescontoDigite o nome do desconto (Nome padrão: Desconto Getnet).
Valor do DescontoDigite o valor do desconto (Exemplo: 10,00%), desconto em porcentagem.
Salvar alteraçõesClique no botão Salvar alterações.

PIX

Tela de configuração do PIX

Descrição dos campos

OpçãoDescrição
Habilitar Getnet PixAssinalar a opção para ativar pagamentos com Pix.
Inserir títuloControla o título que o usuário vê durante o checkout.
Inserir descriçãoControla a descrição que o usuário vê durante o checkout.
Inserir prefixo do pedidoInsira um prefixo para os números dos pedidos. Se usar a conta Getnet para várias lojas, certifique-se de que este prefixo seja único.
HistóricoAssinalar a opção para habilitar os logs do Pix (getnet-pix-order ou getnet-pix-order-error). Para visualizar: WooCommerce > Status > Logs.
Nome do DescontoDigite o nome do desconto (Nome padrão: Desconto Getnet).
Valor do DescontoDigite o valor do desconto (Exemplo: 10,00%), desconto em porcentagem.
Salvar alteraçõesClique no botão Salvar alterações.

Atenção

A URL de Callback para o método de pagamento pix, está disponível apenas no ambiente de produção.

Last Updated:
Contributors: Ritchelly
Prev
Contratação de serviços
Next
URLs de Callback