Este módulo é um facilitador de integração da Koin com a Wake.
Disponibilizamos nesta integração o método de pagamento BNPL (Buy Now Pay Later).
Para o correto funcionamento do plugin, atente-se aos pré-requisitos abaixo:
1
Conta criada na Koin;
2
Url Koin (informação enviada no onboarding pela Koin)
3
Acesso administrador da plataforma Wake.
Segue abaixo o passo-a-passo para instalar e configurar a Koin em sua plataforma Wake.
3.1 Criar e configurar método de pagamento
O primeiro passo é adicionar um novo conector de pagamento, seguindo os passos abaixo:
Clique em “Pagamentos”,
Em seguida clique em “Conectores de Pagamento F-Gateway”;
Localize a opção “Custom” e clique em "+ Nova Configuração":
Abrirá um pop-up chamado “Adicionar configuração”:
Em “Nome da configuração”, insira “koin” (em minúsculo);
E em “Selecione uma Forma de Pagamento”, selecione a opção “Customizado”;
Clique em “Adicionar Configuração”.
Em seguida abrirá a tela de configurações do conector:
No campo “Nome da configuração”, verifique se apresenta o nome “koin”, caso não, será preciso preencher o campo em letra minúscula.
No campo “Configuração do Endpoint de Pagamento” insira a URL fornecida pela koin.
Ao lado do campo “Configuração do Endpoint de Pagamento”, possui outro campo chamado “Versão” selecione a opção “Simplificada”.
Em seguida clique em “Atualizar”:
3.2 Inclusão do Script
O próximo passo é a inclusão do Script da Koin:
No menu de opções, clique em “Configurações”;
Em seguida clique em “Gestor de Scripts”;
E depois clique em “Adicionar Script”
Preencha os dados conforme instrução abaixo:
Em “nome” digite "checkout_koin" (em minúsculo) e marque “ok” na opção "script ativo?":
Em "Posição" selecione "Footer - Última linha";
Em "Páginas" deixe a opção "Todas";
Em "Identificador" de página deixe "*";
E em “conteúdo do script” digite o seguinte trecho de código:
<link rel="stylesheet" href="https://static.fbits.net/css/samurai/koin-traycorp.css" />
<script src="https://static.fbits.net/scripts/checkout/koin-checkout-traycorp.js"></script>
Por fim clique em salvar e depois publicar:
Segue abaixo vídeo demonstrativo:
4.1 Parcelamento
Nesta etapa, é necessário criar um parcelamento:
Acesse a opção “Grupos e Parcelamentos”, dentro do menu “Pagamentos”;
Em seguida, clique em “Parcelamentos”;
Abrirá uma janela lateral, clique em “+ Criar Parcelamentos”;
Na tela seguinte, preencha os campos com as informações abaixo:
> Nome do parcelamento: koin (em minúsculo)
> Número de parcelas: 1
> Valor mínimo por parcela: 0.10.
Em seguida clique em “Salvar”.
4.2 Grupo de pagamento
A próxima etapa, será a criação de um grupo de pagamento:
Acesse no menu a opção “Pagamentos” e em seguida clique em “Grupos e Parcelamentos”;
Na tela de Grupos de pagamento clique em “+ CRIAR GRUPOS”;
Abrirá a tela para cadastrar um novo grupo de pagamento;
Adicione o nome “koin” no campo “Nome do grupo”;
E também adicione o nome “koin” no campo “Nome de exibição”;
No campo “Valor mínimo”, adicione o valor “R$ 1.00”;
Não é necessário adicionar ou configurar informações nos outros campos disponíveis;
Em seguida, é necessário subir a imagem de logo da Koin (realize o download da imagem, clicando aqui)
Após realizar o download da imagem, clique em “Usar nova imagem”;
Por fim, clique em “Salvar”.
Segue vídeo demonstrativo:
Em seguida, é necessário vincular o parcelamento criado ao grupo de pagamento.
Ainda na mesma tela de “Grupos de Pagamento”, localize o Grupo “koin” criado;
Clique em “ativar”.
Em seguida, clique em “Vincular formas de pagamento” e selecione a opção “Customizado”;
O próximo passo será necessário vincular as configurações e o parcelamento da koin:
Primeiro vincule as configurações, clicando em “Vincular Configurações”;
Abrirá um pop-up de “Formas de Pagamento”, clique na opção “koin”;
Em seguida, vincule o parcelamento clicando em “Vincular Parcelamento”;
Abrirá o pop-up de “Parcelamentos”, clique na opção “koin”;
Por fim, habilite a forma de pagamento vinculada ao grupo de pagamento koin.
Segue vídeo demonstrativo:
5.0 Criar estrutura de pagamento
Esta ação de criação de estrutura de pagamento não é obrigatória, conforme documentação da Wake.
Para criar a estrutura de pagamentos, acesse a opção “Estrutura de Pagamentos”, localizada dentro da opção “Pagamentos” no menu lateral esquerdo e siga as instruções abaixo:
Clique em “+ Criar Estrutura”;
Abrirá um pop-up para inserir o nome da estrutura, adicione “koin” (em minúsculo);
E em seguida clique em “+ Criar Estrutura”;
É necessário adicionar o grupo de pagamento a estrutura, clicando em “Selecionar grupo de pagamento”;
Abrirá o pop-up “Grupo de pagamentos ativos”, selecione a opção “koin”.
Observação: Caso já tenha estrutura criada é necessário apenas adicionar o grupo de pagamento:
Localize a Estrutura de pagamento criada e ativa;
Clique em “Selecionar grupo de pagamento”;
Abrirá o pop-up “Grupo de pagamentos ativos”, selecione a opção “koin”.
Segue vídeo demonstrativo:
6.0 Incluir urls permitidas
Esta é a última etapa da configuração da koin na plataforma Wake. Para o correto funcionamento do módulo da koin é necessário permitir algumas urls nas configurações da plataforma.
Acesse a opção “Urls Permitidas”, localizado dentro da opção “Configurações” e “Políticas de Segurança”;
Em seguida clique em “+ Adicionar Nova Url”;
Abrirá um pop-up para inserir a Nova Url;
Adicione a Url no campo abaixo do descrito “Nova Url”;
Clique em “Salvar”.
Observação: Segue abaixo a lista de Urls que precisam ser incluídas:
azurewebsites.net
static.hotjar.com
static.fbits.net
koin-custom-conector-gateway.fbits.net
payments.koin.com.br
Segue vídeo demonstrativo:
7.0 Dicas
Após realizar toda a configuração acima, pode ser necessário aguardar até 2 horas para que o método de pagamento da Koin apareça em seu checkout.
Aconselhamos também que após a configuração, limpe o cache de sua plataforma.
Caso após a configuração e as dicas citadas acima não apresente a Koin em seu Checkout, verifique se há mais de uma estrutura criada (Etapa 5.0).
Para mais informações sobre a plataforma Wake, consulte a documentação clicando aqui