Dicas
Dicas - Magento 2
1.0 Introdução
Este documento tem como objetivo apresentar dicas sobre o plugin da Koin para Magento 2:
Dicas de configuração geral do plugin;
Dúvidas Gerais;
Dicas de criação de regras de parcelamento;
Identificando problemas e possíveis soluções.
2.0 Configuração Geral
Abaixo, segue algumas dicas de configuração geral do plugin.
O caminho para acessar a configuração geral fica em:
Vendas > Koin > Configurações > Vendas > Métodos de pagamento > Outros meios de pagamento > Koin > Geral.
2.1 Ambiente de testes (Sandbox)
A Koin possibilita realizar testes com o plugin Koin para Magento 2?
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 “Usar Sandbox” (consultar etapa 4 da documentação), se está selecionado a opção “Sim”.
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
Consigo realizar testes de 3DS para Cartão de Crédito em sandbox?
Sim, é possível testar a estratégia de 3DS.
Para habilitar no Magento, acesse Vendas > Koin > Configurações > Koin > Geral > Sandbox.
Em seguida, verifique se a opção "Usar Sandbox" está com o valor "Sim";
Abaixo desta opção será preciso ativar e configurar o tipo de estratégia, nos seguintes campos:
Usar Sandbox 3DS para transações de cartão - selecione a opção "Sim";
Estratégia 3DS - escolha uma das opções: Challenge (apresenta desafio OTP para o comprador) ou Frictionless (não apresenta o desafio OTP).
Por fim, salve as configurações.
Atenção!
Para conseguir realizar os testes da estratégia 3DS, será preciso solicitar a ativação em sua conta de testes da Koin.
Verifique se a versão que está utilizando do conector Koin para Magento 2, já contempla a funcionalidade de 3DS.
2.2 Habilitar Logs
Preciso habilitar a opção "Habilitar Log de Requisição" 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.
Ele armazena as informações de log, dentro da pasta var/logs, na pasta raiz de sua plataforma Magento.
3.0 Dúvidas Gerais
Como saber qual a versão do plugin está instalado no meu magento?
Para verificar a versão do plugin Koin instalado em sua plataforma Magento, acesse o menu de configurações do plugin em Vendas > Koin > Configurações > Koin.
A versão será apresentada logo abaixo ao nome Koin.
Atualizações do plugin Koin
Todas as atualizações e correções são lançadas em nosso repositório, onde esta armazenado o plugin da Koin, no Github.
Nele você encontra também todas as informações sobre cada atualização.
Onde vejo no Magento as transações que foram enviadas para a Koin?
Há dois locais onde pode acessar as informações das transações que são enviadas para a Koin:
Acessando as informações do pedido, no menu terá uma opção com o nome Koin. Nele apresentará as informações de payload da Koin.
No menu de opções da Koin, dentro do menu Vendas, clique em Requests e Responses. Nesta tela são apresentadas todas as informações de requisição e retornos do plugin.
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 positivo, segue abaixo alguns pontos para verificar:
Se em Requests e Responses apresenta algum retorno de erro;
Em Callbacks, dentro do menu de opções da Koin, se apresenta algum retorno de erro;
Se apresenta algum registro nos logs da plataforma. Localizado na pasta var/logs, dentro da pasta raiz do servidor que hospeda sua aplicação magento.
Verifique também a configuração dos campos de status, dentro das configurações do plugin Koin.
Caso tenha um firewall configurado no servidor que hospeda sua plataforma, verifique se o mesmo realizou algum bloqueio de ip.
Checkout apresenta erro na finalização da compra
Segue abaixo algumas possibilidades que fazem com que apresente mensagem de erro na tela de checkout (Finalização da compra):
Campos obrigatórios não preenchidos ou não habilitados para o formulário do checkout;
Método de pagamento não habilitado na Koin;
É importante verificar também se possui algum registro na opção Requests e Responses, no menu da Koin em sua plataforma do Magento;
Verifique também os logs. Localizado na pasta var/logs, dentro da pasta raiz do servidor que hospeda sua aplicação magento.
4.0 Regras de parcelamento
Caminho: Vendas > Koin > Regras de Parcelamento
Atenção!
A funcionalidade de regras de parcelamento somente está ativada para o método de pagamento Cartão de Crédito.
Abaixo segue algumas orientações sobre a criação e edição das regras de parcelamento:
As regras de parcelamento somente são aplicadas ao método de pagamento Cartão de Crédito.
Evite erros no checkout por conta de conflito de regras. Antes de criar uma regra, verifique se já existe alguma regra com as mesmas configurações e condições.
Caso a regra não tenha sido ativada em uma venda especifica, verifique as configurações da regra, como:
o campo Data de Término, que informa se a regra foi expirada;
Condições da regra, como BIN, valor mínimo por parcela, valor mínimo ou máximo do pedido.
O campo Account, informa qual conta de pagamento Koin a transação será enviada. Caso não seja preenchido, utilizará a conta de pagamento Koin configurada no campo Account, localizado nas configurações gerais do plugin.
Por conta da configuração de parcelamento geral do plugin, no checkout sempre aparecerá na seleção de parcelamento 1x.
4.1 Exemplos de Regras de parcelamento
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 juros específico por parcela;
- Parcelamento com valor mínimo de parcela;
- Configurar parcelamento acima de 12x;
- Regra de parcelamento por Bandeira;
- Regra com condição específica de parcelamento.
4.1.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 Vendas > Koin > Configurações > Vendas > Métodos de Pagamento > Koin > Cartão de Credito com Antifraude.
Configure apenas os campos Minimo de Parcelas (in cash payments) e Máximo de Parcelas.
Atenção ao campo Has interest, precisa estar como no. Este campo habilita o repasse de juros ao comprador.
Veja como a regra será apresentada no checkout
4.1.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.
Caminho: Sales > Koin > Settings > Sales > Payment Methods > Koin > Credit Card with Antifraud.
Configure os campos:
- Min Installments: in cash payments
- Max Installments: número máximo de parcelas 12 installments.
- Max Installments Without Interest: 6 installments.
- Has Interest: Yes
- Interest Type: Simple
- Interest rate: 1.99 (informar a porcentagem de juros a ser aplicada)
Veja como a regra será apresentada no checkout
4.1.3 Parcelamento com juros específico por parcela
Se aplicável em todos os casos, a configuração pode ser feita dentro da configuração geral do plugin Koin
Caminho: Sales > Koin > Settings > Sales > Payment Methods > Koin > Credit Card with Antifraud
Será necessário configurar os seguintes campos:
Min Installments: in cash payments;
Max Installments: número máximo de parcelas 12 installments;
Max Installments Without Interest: 6 installments;
Has Interest: Yes;
Interest Type: Per Installments;
Abrirá a opção “Interest Per Installments”.
Clique nele e abrirá os campos para configurar a porcentagem que será aplicado em cada parcela.
Exemplo:
Na primeira parcela não quero repasse de juros;
Na segunda parcela quero que seja repassado ao comprador juros de 1.20%;
Na terceira parcela quero que seja repassado ao comprador juros de 1.25%;
Na quarta parcela quero que seja repassado ao comprador juros de 1.30%;
Na quinta parcela quero que seja repassado ao comprador juros de 1.35%;
Da sexta parcela até a Décima nona, quero que seja repassado ao comprador juros de 2%;
Na décima segunda parcela quero que seja repassado ao comprador juros de 4%;
Veja como ficará a configuração:
Veja como a regra será apresentada no checkout
4.1.4 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.
Caminho: Sales > Koin > Settings > Sales > Payment Methods > Koin > Credit Card with Antifraud
Configure os campos básicos, conforme necessário: Min Installments, Max Installments, Max Installments Without Interest, Has Interest, Interest Type.
Informe no campo Minimum Installment Amount, o valor mínimo para liberar o parcelamento. Exemplo: campo Minimum Installment Amount, configurado com o valor 25.
Valor total da Compra: $75
Parcelas liberadas: 3
Como ficará a configuração do campo:
Veja como a regra será apresentada no checkout
4.1.5 Configurar parcelamento acima de 12x
Para disponibilizar parcelamento acima de 12x para cartão de crédito, verifique com a Koin a disponibilidade em seu contrato.
A ativação deste parcelamento no plugin da Koin é realizado através da criação de uma regra de parcelamento.
Caminho: Vendas > Koin > Regras de parcelamento.
Veja a configuração de exemplo no vídeo abaixo:
Veja como a regra será apresentada no checkout
4.1.6 Regra de parcelamento por Bandeira
Caminho: Vendas > Koin > Regras de parcelamento
Atenção!
Para criar uma regra de parcelamento específico por bandeira, será necessário adicionar os BIN´s específicos da bandeira que deseja ativar a regra.
Exemplo
- Regra para bandeira Visa,
- No campo Payment Methods BINs, os BIN´s da Visa, como por exemplo o 456514.
Veja no video a configuração da regra:
Veja como a regra será apresentada no checkout
4.1.7 Regra com condição específica de parcelamento
Caminho para criar a regra: Vendas > Koin > Regras de Parcelamento > Adicionar Regra
- Neste exemplo citaremos 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 bandeira”, acrescentar os BINs específicos de Tarjeta Naranja e nos campos Minimum Installments e Maximum Installments, ter o mesmo valor “3”.
Veja o vídeo da configuração
Veja como a regra será apresentada no checkout
- Criando a mesma regra para Tarjeta Naranja, em 3x, aplicando juros de 2%:
Neste exemplo, a configuração inicial da regra permanece a mesma, porém será preciso habilitar o repasse de juros no campo Has Interest, escolher o tipo de repasse de juros no campo Interest Type e adicionar o juros que será aplicado por parcela no campo Interest Rate.
Atenção!
Não esqueça de informar os BINs referente a bandeira que será informado nas condições da regra.
Veja o vídeo da configuração da regra
Veja como a regra será apresentada no checkout
Atenção!
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.