Dicas
Dicas - Woocommerce
1.0 Introdução
Este documento tem como objetivo apresentar dicas sobre o plugin da Koin para Woocommerce:
Dicas de configuração geral do plugin;
Dúvidas Gerais;
Dicas de criação de regras de parcelamento.
2.0 Configuração Geral
Abaixo, segue algumas dicas de configuração geral do plugin.
O caminho para acessar a configuração geral fica na barra lateral esquerda, com o menu "Pagamentos Koin".
Ao clicar abrirá as opções: Configurações, Regras de Parcelamento, Cartão de Crédito, Pix Parcelado e Pix.
Para acessar a configuração geral do plugin da Koin, é só clicar na opção "Configurações".
2.1 Ambiente de testes (Sandbox)
A Koin possibilita realizar testes com o plugin Koin para Woocommerce?
Sim, a Koin permite realizar transações de testes.
Porém aconselhamos a utilização de uma conta de testes criada pelo time da Koin.
Como configuro minhas credenciais testes Koin no plugin?
Após ter as credenciais de testes, basta seguir o passo-a-passo da configuração do plugin.
Pontos importantes:
As credenciais de Produção e de Testes são diferentes.
É importante verificar a configuração do campo “Ambiente” (consultar configuração), se está selecionado a opção “Sandbox”.
Para o método de pagamento BNPL, é importante habilitar em seu navegador a extensão Modheader e configurar com as informações abaixo:
No campo name, insira o valor xdesp-sandbox;
No campo value, insira o valor true;
Para seu ambiente de Produção, não se esqueça de alterar as credenciais da Koin, evitando enviar transações reais para a conta de testes.
2.2 Habilitar Logs
Preciso habilitar a opção "Habilitar Logs" nas configurações do plugin?
Sim! Esta opção permite a Koin registrar as requisições enviadas do plugin e também a identificação de possíveis erros na requisição.
Onde encontro os Logs do plugin da Koin?
Todos os logs são encontrados através do painel administrador do Wordpress.
No menu lateral esquerdo acesse: Woocommerce > Status > Logs.
Os logs da Koin iniciam com wc-koin-official e são gerados diariamente.
3.0 Dúvidas Gerais
Como saber qual a versão do plugin está instalado no Wordpress/Woocommerce?
Para verificar a versão do plugin Koin instalado em sua plataforma, localize a opção Plugins, na barra lateral esquerda.
Localize o plugin da Koin com o nome Pagamentos Oficiais Koin.
Nele aparecerá a versão instalada.
Atualizações do plugin Koin
Todas as atualizações contendo novas funcionalidades ou correções são atualizadas direto no plugin.
Aconselhamos que tenha habilitado no plugin as atualizações automáticas.
Verifique se está ativado acessando a opção Plugins e localizando o plugin da Koin "Pagamentos Oficiais Koin".
Onde vejo no Woocommerce as transações que foram enviadas para a Koin?
As transações que foram enviadas para a Koin, estão localizadas dentro da opção Pedidos, na barra lateral esquerda e dentro da opção Woocommerce.
Dentro de cada pedido, são apresentadas as informações da transação enviada para a Koin.
Porque o pedido não atualizou o status?
Para verificar a não atualização de status de um pedido, verifique em seu portal lojista da Koin se o mesmo teve alteração de status.
Caso sim, acesse os logs da Koin no caminho Woocommerce > Status > Logs, em seguida verifique nos logs da Koin se apresenta algum retorno com erro e acione a Koin para apoiá-lo.
Caso utilize firewall, verifique se houve bloqueio dos ip´s da Koin.
4.0 Exemplos de Regras de parcelamento
Caminho: Menu Pagamentos Koin > Regras de Parcelamento > Criar Regra.
Abaixo apresentaremos alguns exemplos de regra de parcelamento.
Aconselhamos que utilize apenas como orientação na criação das regras.
Para acessar diretamente cada exemplo, clique no link abaixo:
- Simples sem juros;
- Simples até 6x sem juros e de 7 a 12x com juros;
- Parcelamento com valor mínimo de parcela;
- Regra de parcelamento por BIN;
- Regra de parcelamento por Bandeira;
- Regra com condição específica de parcelamento.
4.1 Simples sem juros
Se aplicável em todos os casos, a configuração pode ser feita dentro da configuração geral do plugin Koin, acessando o menu Pagamentos Koin > Cartão de Crédito.
Configure apenas os campos Quantidade mínima de parcerlas e Quantidade máxima de parcelas.
Atenção ao campo Tipo de Transferência de Taxa, precisa estar como Desabilitado. Este campo habilita o repasse de juros ao comprador.
Veja como a regra será apresentada no checkout
4.2 Simples até 6x sem juros e de 7 a 12x com juros
Se aplicável em todos os casos, a configuração pode ser feita dentro da configuração geral do plugin Koin.
Configure os campos:
- Quantidade mínima de parcelas: número minimo de parcelas 1;
- Quantidade máxima de parcelas: número máximo de parcelas 12;
- Tipo de Transferência de Taxa: selecione "Por Parcela";
- Formato de Transferência de Taxa: neste exemplo usaremos "Porcentagem";
- Valor da taxa por parcela: Defina no campo ao lado do número da parcela a porcentagem de juros a ser aplicada (até a sexta parcela deixe 0 da sétima até a décima segunda inclua a porcentagem de juros que irá repassar ao comprador).
Veja como a regra será apresentada no checkout
4.3 Parcelamento com valor mínimo de parcela
Se aplicável em todos os casos, a configuração pode ser feita dentro da configuração geral do plugin Koin.
Configure os campos básicos, conforme necessário.
Para limitar o valor mínimo por parcela, defina no campo "Valor Mínimo da Parcela".
Exemplo: campo "Valor mínimo da parcela", configurado com o valor 25.
Valor total da Compra: $100
Parcelas liberadas: 4
Como ficará a configuração do campo:
Veja como a regra será apresentada no checkout

4.4 Regra de parcelamento por BIN
Para criar uma regra de parcelamento específico por bin no campo BINs do Método de Pagamento, insira os BIN´s da bandeira especifica que deseja ativar a regra.
Exemplo utilizarei o bin 456514, que pertence a bandeira Visa.
Veja no video a configuração da regra:
Veja como a regra será apresentada no checkout
4.5 Regra de parcelamento por Bandeira
Para criar uma regra de parcelamento específico por Bandeira, selecione no campo Bandeiras de Cartão a ou as bandeiras que deseja ativar a regra.
Exemplo utilizarei a bandeira Visa.
Utilizarei um bin de bandeira Master e depois um de bandeira Visa.
Para Bandeira Visa, será ativado apenas 2 parcelas, quanto para a bandeira Master mais de 2 parcelas.
Veja no video a configuração da regra:
Veja como a regra será apresentada no checkout
4.6 Regra com condição específica de parcelamento
Caminho para criar a regra: Vendas > Koin > Regras de Parcelamento > Adicionar Regra
- Neste exemplo citarei a criação de uma regra para um emissor de cartão de crédito específico. Utilizarei neste exemplo Tarjeta Naranja.
- Como regra de parcelamento, terá também a limitação de apenas 3 parcelas sem juros.
Neste caso, será necessário criar a regra, como citado na opção “Regra de parcelamento por bin”, acrescentar os BINs específicos de Tarjeta Naranja e nos campos Quantidade mínima de parcelas e Quantidade máxima de parcelas, ter o mesmo valor “3”.
Veja o vídeo da configuração
Veja como a regra será apresentada no checkout
Atenção!
- As informações contidas nos vídeos de exemplo não são reais!
- Alguns bancos emissores de cartão oferecem promoções específicas de parcelamento para determinados BINs de cartão.
- Atente-se para a criação das regras de parcelamento, quanto ao juros que será repassado ao consumidor.