O manual a seguir descreve as instruções para estabelecer a Koin como gateway de pagamento e/ou provedor antifraude para clientes que integram através da plataforma VTEX, realizando as seguintes atividades:
Cadastrar Chave de aplicação, para Koin gerar relatório de conciliação;
2
Cadastrar Afiliação de Gateway (Koin-Payment ou Koin-antifraude);
3
Habilitar produto koin (condições de pagamento na Vtex);
4
Inserir JS Divice finger print (via configuração de checkout vtex ou via GTM).
Instale a KOin para a VTEX automaticamente seguindo as etapas abaixo.
Selecione CONFIGURAÇÕES DE CONTA -> Configurações de conta -> Perfis de acesso disponíveis no menu do lado esquerdo.
Neste ponto, a primeira coisa é criar um perfil somente leitura para acesso aos serviços do OMS. Para fazer isso, pressione o botão Novo perfil:
Esta ação irá levá-lo para a tela de criação da função de acesso, lá você deve inserir o nome da função “OMS Readonly”
Em seguida, atribua as seguintes permissões:
Producto
Recurso
Permiso
OMS
OMS access
View order
OMS
OMS access
Feed v3 and Hook Admin
OMS
OMS access
List Orders
PCI Gateway
Payment-ViewPaymentData
View Payment Data
Acesse a URL {store}.myvtex.com/admin/mykeys/new/ ou selecione
CONFIGURAÇÕES DA CONTA -> Chaves de aplicação -> Gerenciar minhas chaves disponível no menu do lado direito e depois clique em “Gerar chave”:
Em seguida, digite o nome da nova chave (chave, segredo) , selecione o perfil criado na etapa anterior (OMS Readonly) ee selecione “Gerar”:
Será exibido o valor gerado para o segredo, que deve ser copiado e salvo, pois não poderá ser acessado posteriormente:
Esta funcionalidade está disponível apenas para o usuário proprietário da loja. É importante observar que o appKey gerado deve estar ativo.
Concluídas todas as etapas, envie o appKey e o appToken gerados no ponto 1.1 para a Koin.
No Admin VTEX, acesse Configurações da loja > Pagamentos > Provedores, ou digite Provedores na barra de busca no topo da página.
Na tela de provedores, clique no botão Novo provedor.
Digite o nome Koin-Payments na barra de busca e clique sobre o nome do provedor.
Preencha os campos Application Key e Application Token com as informações da sua conta Koin-Payments.
Clique em Salvar.
No Admin VTEX, acesse Configurações da loja > Pagamentos > Provedores, ou digite Provedores na barra de busca no topo da página.
Na tela de provedores, clique no botão Novo provedor.
Digite o nome KoinAntifraud na barra de busca e clique sobre o nome do provedor.
Teste - Live/Produção: indica se a associação será usada para testes ou em um ambiente produtivo. Levando isso em consideração, para o processo de aprovação deverá ser configurada uma afiliação selecionando o valor “Teste”, e outra para ser utilizada na produção, selecionando Live/Produção”, ambas com suas credenciais correspondentes.
Preencha os campos Application Key e Application Token com as informações da sua conta koin.
Habilitar Pré-Análise de Risco: Indica se o serviço de Pré-Análise está habilitado. Esta configuração permite que Koin execute uma pré-avaliação de cada transação antes da autorização de pagamento. Esta configuração não omite a avaliação subsequente da transação após a autorização de pagamento.
Campo de documento do titular do cartão: indica se o documento do titular do cartão de crédito utilizado no pagamento será um campo obrigatório a ser recebido pelo antifraude.
Clique em Salvar.
Instale a KOin para a VTEX automaticamente seguindo as etapas abaixo.
Em "Condições de pagamento", clique em "+" para gerar uma nova configuração de pagamento que usa o plug-in "Koin-Payments" para ativar o método de pagamento.
Em "Outro" clique “Boleto Parcelado Koin”
Altere o status para "Ativado"
Pronto! Agora você pode vender com Koin via VTEX! Conte conosco.
Em "Condições de pagamento", clique em "+" para gerar uma nova configuração de pagamento que usa o plug-in "Koin-Payments" para ativar o método de pagamento.
Selecione Pix como forma de pagamento
Selecione Koin como afiliação “Koin-Payments - Pix” preencha o nome da regra e altere o status para ativo.
Pronto! Agora você pode vender com Koin via VTEX! Conte conosco.
Em "Condições de pagamento", clique em "+" para gerar uma nova configuração de pagamento que usa o plug-in "Koin-Payments" para ativar o método de pagamento.
Selecione Cartão de Crédito como forma de pagamento:
Selecione o cartão de crédito com o qual deseja operar
Selecione Koin como afiliação “Koin-Payments”, Digite o nome da regra e altere o status para ativo.
Configurar cotas:
Valor das prestações ou à vista
Quantidade mínima
Cobrança
Além disso, você pode inserir condições específicas para juros, emissor, banco, país, tipo de cartão, etc., na seção "Adicionar condições especiais".
Obs.: Caso seu contrato prevê a contratação do serviço de gateway (cartão de crédito) + Antifraude Koin, você deve seguir os próximos passos (3.4 e 4) para habilitar o antifraude.
Pronto! Agora você pode vender com Koin via VTEX! Conte conosco.
Após a configuração da afiliação, a Koin deve ser selecionada como provedor antifraude. Esta ação pode ser realizada em cada plano de pagamento disponível independentemente, acessando ”Condições de pagamento” e selecionando o painel do plano desejado:
Uma vez no detalhe, no painel "Status" você deve indicar que deseja usar antifraude marcando a opção "Usar antifraude" e selecione Koin no menu suspenso:
Para finalizar, salve as alterações feitas com a ação “Salvar”. Uma vez salvo, será exibida e a etiqueta antifraude Koin, no cabeçalho do plano de pagamento.
Instale a KOin para a VTEX automaticamente seguindo as etapas abaixo.