Este documento tem como objetivo fornecer dicas sobre o plugin Koin para Magento 2

• Dicas gerais de configuração do plugin
• Perguntas frequentes
• Dicas para criação de regras de parcelamento
• Identificação de problemas e possíveis soluções

Configurações Gerais

Abaixo estão algumas dicas gerais de configuração para o plugin.

👍

Caminho: Vendas > Koin > Configurações > Vendas > Métodos de pagamentos > Outros Métodos de Pagamento > Koin > Geral

Sandbox

1. A Koin permite testes com o plugin Koin para Magento 2?
   Sim, a Koin permite a realização de transações de teste.
   Contudo, recomendamos o uso de uma conta de teste fornecida pela equipe da Koin para garantir a validade dos testes.
2. Como configuro minhas credenciais de teste no plugin da Koin?
   Após obter suas credenciais de teste, basta seguir os passos de configuração do plugin descritos anteriormente.

   📘

   Observações importantes

   As credenciais de Produção e Sandbox são diferentes.

   Verifique se o campo Usar Sandbox está definido como Sim (consulte o passo 4 na documentação).

   Para o método de pagamento BNPL, é importante ativar a extensão de navegador ModHeader e configurá-la com os seguintes valores:

   No campo Name, insira: xdesp-sandbox

   No campo Value, insira: true

👍

Para o ambiente de Produção, não esqueça de substituir as credenciais de teste pelas credenciais de Produção, para evitar o envio de transações reais para a conta de teste.

3. Posso testar 3DS para transações com cartão de crédito no sandbox?
   Sim, você pode testar a estratégia 3DS no modo sandbox.

👍

Para habilitar no Magento

Vá para Vendas > Koin > Configurações > Geral > Sandbox

Certifique-se de que a opção Usar Sandbox esteja definida como Sim

Abaixo dessa configuração, ative e defina a estratégia 3DS nos seguintes campos:

Usar Sandbox 3DS para transações com cartão de crédito – selecione Sim

Estratégia 3DS – escolha uma das opções:

Challenge (exibe um desafio OTP para o comprador)

Frictionless (nenhum desafio OTP é apresentado)

Por fim, salve a configuração.

🚧

Atenção!

Para realizar testes de 3DS, você deve solicitar a ativação do suporte a 3DS na sua conta de teste da Koin.

Além disso, certifique-se de que a versão do plugin Koin para Magento 2 que você está usando já inclua suporte a 3DS.

Dúvidas Gerais

1. Preciso habilitar a opção “Habilitar Logs de Requisições” nas configurações do plugin?
   Sim!
   Essa opção permite que a Koin registre as requisições enviadas pelo plugin e ajude a identificar possíveis problemas no fluxo de requisições.
   As informações de log são armazenadas no diretório var/log, na pasta raiz da sua instalação Magento.
2. Como verificar qual versão do plugin Koin está instalada no meu Magento?
   Para conferir a versão instalada, acesse:
   Vendas > Koin > Configurações > Koin
   O número da versão aparece logo abaixo do título “Koin”.
3. Atualizações do Plugin Koin
   Todas as atualizações e correções são publicadas em nosso repositório oficial no GitHub, onde o plugin está hospedado.
   Lá você encontra notas de versão detalhadas sobre cada release.
4. Onde posso ver as transações enviadas para a Koin no Magento?
   Você tem duas formas principais de consultar essas informações:
   • Na visualização do pedido: Na página de detalhes do pedido, existe uma seção “Koin” que exibe o payload enviado para aquela transação.
   • Pelo menu Koin: Acesse Vendas > Koin > Requests e Responses para ver o histórico completo de logs de requisições e respostas gerados pelo plugin.
5. Por que o status do pedido não foi atualizado?
   Para investigar um problema de atualização de status:
   1. Verifique no portal de lojista da Koin se o status do pedido foi alterado.
   2. Se o status mudou na Koin, verfique em sua plataforma Magento como Administrador, os pontos abaixo:
   • Em Requests e Responses, confira se houve algum erro retornado.
   • Em Callbacks (em Vendas > Koin > Callbacks), verifique se ocorreu algum erro.
   3. Analise os logs da plataforma em: magento_root/var/log
6. Erro no checkout durante a finalização do pedido
   Abaixo estão alguns motivos comuns para erros na página de checkout:
   1. Campos obrigatórios não preenchidos ou não habilitados no formulário de checkout.
   2. O método de pagamento não está habilitado na Koin.
   3. Verifique a seção Requests e Responses no menu Koin para identificar erros de requisição.
   4. Analise os arquivos de log localizados em: magento_root/var/log.

👍

Dicas - Exemplos de Regras de Parcelamento

Para acessar os exemplos de regras de parcelamento, clique aqui.