Ao escolher a Koin, você oferece aos seus clientes uma forma de pagamento simples, segura e extremamente flexível, com a opção de parcelar as compras sem cartão, tornando tudo mais prático e conveniente.
Este guia simples te ajudará a configurar a solução na sua loja Wake em poucos passos.
Para o correto funcionamento do plugin, atente-se aos pré-requisitos abaixo:
1
Conta criada na Koin;
2
Credenciais Koin (informação enviada no onboarding pela Koin)
3
Acesso administrador da plataforma Wake.
Antes de iniciar a configuração da Koin em sua plataforma Wake, será necessário criar um token que será utilizado nos passos seguintes a criação.
Realize o login em sua plataforma Wake e acesse o caminho abaixo para criar o Token Wake:
No menu lateral, clique em Configurações;
Em seguida, clique em Integrações;
Depois clique em Tokens;
Clique em Adicionar Token;
No campo Nome da Aplicação, preencha com Koin;
Em Permissões, marque as seguintes opções:
Pedido - marque a opção "GET pedidos/{pedidoId}"
Webhook - marque as opções abaixo:
"GET /webhook/inscricao"
"POST /webhook/inscricao"
"PUT /webhook/inscricao/{inscricaoId}/Ativar
Clique em Salvar.
Atenção!
Copie o Token gerado, localizado ao lado do Nome da Aplicação, será necessário a utilização dele para configurar o conector de pagamento da Koin, na etapa 4.0.
Nesta etapa, é necessário instalar o conector de pagamentos "Koin - Pix Parcelado".
Acesse a opção Pagamentos, no menu lateral;
Clique em Conectores de Pagamentos;
Na tela seguinte, localize a opção "Koin - Pix Parcelado" e clique em "Instalar Configuração";
Em seguida, abrirá a janela de configuração do conector. Preencha os campos abaixo com as informações cedidas pela Koin e com o wake_token, gerado em sua plataforma Wake (etapa 3.0)
Os campos necessários de preenchimento são:store_code: {Código da loja Koin};
account: {Conta da loja Koin};
private_key: {Chave privada Koin};
org_id: {Chave orgId Koin};
wake_token: {Token de integração da Wake gerado no passo 3};
expiration_minutes: {Tempo de expiração do QRCode em minutos};
User-Agent: inserir no valor do campo koin;
Em Antifraude, selecione a opção "Nenhum";
Finalize clicando em Atualizar.
Obs.: Neste vídeo as informações preenchidas no campo "valor" não são reais. Em sua configuração utilize as informações enviadas pelo time de onboarding da Koin.
5.0 Grupos e Parcelamentos
5.1 Criar 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 “Gerenciamento de Pagamentos”;
Na tela de Gerenciamento de pagamentos 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”.
5.2 Criar Parcelamento
Em seguida, é necessário criar uma forma de parcelamento (Mesmo que não utilizada, esta configuração é necessária).
Acesse no menu a opção “Pagamentos” e em seguida clique em “Gerenciamento de 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;
Número de parcelas: 1;
Valor mínimo por parcela: 0.10.
Em seguida clique em “Salvar”.
5.3 Vincular Configurações
Após realizar as etapas de Criação de Token, Configuração de Pagamento Customizado, criação do Grupo de Pagamento e Parcelamento, é necessário vincular as configurações ao Grupo criado:
Localize o grupo de pagamento "Koin";
Clique em “Vincular formas de pagamento” e selecione a opção “Koin - Pix Parcelado”;
Em seguida, clique 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.
6.0 Estrutura de Pagamento
6.1 Informação importante
A criação da estrutura de pagamento não é obrigatória. (vide documentação Wake).
Quando não houver nenhuma estrutura de pagamento configurada, na página de fechamento, serão exibidos todos os grupos de pagamento ativos seguindo a ordem de cadastro do grupo.
6.2 Criar Estrutura de Pagamentos
Caso já tenha estrutura de pagamentos criada, siga para a próxima etapa (6.3).
Para criar a estrutura de pagamentos, acesse a opção a "Organização de Pagamentos"
Clique em “+ Criar Estrutura”;
Abrirá um pop-up para inserir o nome da estrutura, adicione “koin”;
E em seguida clique em “+ Criar Estrutura”;
6.3 Adicionar Grupo de Pagamento a Estrutura
Após criar a estrutura de pagamento, é necessário adicionar o grupo de pagamento a ela:
Clique em “Selecionar grupo de pagamento”;
Abrirá uma tela “Grupo de pagamentos ativos”, selecione a opção “Koin”.
Em seguida, clique em "Salvar Estrutura".
7.0 Adicionar Script
Nesta última etapa, é necessário adicionar o script de Confirmação de Pagamento (QrCode Pix Parcelado) :
Acesse a opção "Configurações", no menu lateral esquerdo;
Clique em "Gestor de Scripts";
Em seguida, clique em "Adicionar Script";
Na tela seguinte, preencha os seguintes campos:
Nome: "Koin - Confirmação";
Posição na Página: escolha "Header - Primeira Linha";
Páginas: Marque "Todas" com o Identificador "*Confirmacao";
Em "Conteúdo do Script", adicione:
<link href="https://api-ecommerce.koin.com.br/wake/payments/payment-confirmation.css" rel="stylesheet" defer>
<script type="text/javascript" src="https://api-ecommerce.koin.com.br/wake/payments/payment-confirmation.js" defer></script>Clique em "Salvar".
8.0 Dicas
Abaixo você encontrará algumas dicas para o correto funcionamento do conector Koin em sua plataforma Wake:
O método de pagamento da Koin não aparece no Checkout
- Pode ser necessário aguardar até 2 horas para que o método de pagamento da Koin apareça em seu checkout.
- Limpe o cache de sua plataforma Wake.
- Verifique se o conector Koin está ativado.
Caminho: Pagamentos > Gerenciamento de Pagamentos.
- Verifique se já mais de uma estrutura de pagamentos criada.
Caminho: Pagamentos > Organização de Pagamentos.
- Em "Urls Permitidas", verifique se inseriu todas as urls citadas na etapa 8.0 e se estão ativas. Caminho: Configurações > Políticas de Segurança > Urls Permitidas.
- Reveja e refaça, se necessário, todas as etapas dessa documentação.
Para mais informações sobre a plataforma Wake, consulte a documentação clicando aqui.