Pular para o conteúdo
  • Não há sugestões porque o campo de pesquisa está em branco.

Integrando com a VTEX

Veja o passo a passo para ajustar a integração com a VTEX.

1. Instalação do Connector

  1. Acesse a Vtex e vá até Configurações no menu lateral.

  2. Em Pagamentos > Provedores, clique em Novo Provedor.

  3. Busque por Appmax, selecione e clique em Autorizar via OAuth.

  4. Insira um nome para o provedor, desmarque "Modo Teste" e clique novamente em Autorizar via OAuth.

  5. Será exibido um alerta confirmando a conclusão da instalação da integração entre Appmax e Vtex.

 

 

 

 

Importante: Certifique-se de estar logado na Appmax antes da autorização.

 

Instalação do Connector Appmax na VTEX

Caso o Connector Appmax não esteja instalado, a VTEX exibirá um alerta informando que a instalação é necessária para processar os pagamentos.

  1. Basta clicar em Instalar App e seguir as instruções.

  2. Uma modal de confirmação sobre os termos de serviço será exibida.

  3. Clique em Instalar para concluir a instalação do Connector.

 

 

 

 

Habilitar Cartão de Crédito como forma de pagamento:

  1. Em Configurações > Condições de Pagamento, clique no "+".

  2. Selecione a forma de pagamento desejada (Cartão de crédito, Boleto ou Pix).

    Escolha a afiliação criada com a Appmax e ative a opção.

    • Cartões aceitos: Visa, Mastercard, Elo, Amex, Discover, Diners e Hipercard.

    • Parcelamento: Defina total de parcelas, juros e valores mínimos.

  3. Após o carregamento da página, clique na seta para expandir o menu de opções "Processar com a afiliação".

  4. Na tela resultante, selecione a afiliação previamente criada com o Appmax (identificada pelo nome que você definiu).

  5. Ajuste o status para "Ativa" e finalize o processo.

 

 

 

 

 

 

Configuração de Parcelamento - Condições especiais

Após habilitar o pagamento com a bandeira de cartão, você pode configurar condições especiais para compras à vista ou parceladas.

Para configurar o parcelamento:

  1. Selecione "Parcelado" no centro da tela.

  2. Defina o "Total de parcelas" como de 1 a 12 parcelas.

  3. Defina a parcela mínima como R$ 5,00.

  4. No ícone de faturas, escolha a opção "Fim do período" para a data de cobrança.

Essas configurações permitirão parcelamentos de 1 a 12 vezes, com parcela mínima de R$ 5,00 e vencimento no "Fim do período".

 

O usuário deve configurar as taxas de parcelamento na Vtex de acordo com o tipo de taxa definido na Appmax, que pode ser de financiamento ou simples por parcela.

Taxa de Parcelamento no formato de financiamento (ao mês):

Para configurar a taxa de parcelamento, siga os passos abaixo:

  1. Clique em Adicionar juros.

  2. Insira o percentual de juros para cada parcela.

  3. Selecione a opção de juros composto no campo "Tipo de juros".

  4. Não se esqueça de salvar as alterações.

 

 

Essas configurações permitem especificar as taxas de juros para cada parcela, utilizando o tipo de juros composto. Lembre-se de salvar as alterações para garantir que as configurações sejam aplicadas corretamente.

Observação: Se deseja absorver os juros, ou seja, não cobrar os juros do cliente final, entre em contato com a Appmax para que as alterações necessárias sejam feitas antes de ajustar as configurações no sistema da VTEX.

Taxa de Parcelamento no formato de Simples (por parcela):

Para configurar a taxa de parcelamento, siga os passos abaixo:

  1. Clique no botão "Adicionar juros".

  2. Insira o percentual de juros para cada parcela.

  3. Selecione a opção de "juros simples" no campo "Tipo de juros".

  4. Certifique-se de salvar as alterações após configurar as taxas de parcelamento.

 

 

 

Essas configurações permitem especificar as taxas de juros para cada parcela, utilizando o tipo de juros simples. Lembre-se de salvar as alterações para garantir que as configurações sejam aplicadas corretamente.

Observação: Se desejar absorver os juros, ou seja, não cobrar juros do cliente final, entre em contato com a Appmax para as alterações necessárias serem feitas antes de ajustar as configurações no sistema da VTEX.

Após ativar a opção de cartão de crédito em seu módulo, aguarde cerca de 10 minutos para as alterações serem processadas e refletidas na página de checkout do seu site.

 

Habilitar Boleto Bancário como forma de pagamento:

Para habilitar o pagamento via boleto bancário:

  1. Acesse a plataforma Vtex e clique em Configurações no menu lateral.

  2. Em Condições de pagamento, clique em Criar nova condição de pagamento.

  3. Selecione a categoria BOLETO e clique em Boleto Bancário.

  4. Expanda o menu Processar com a afiliação, selecione a afiliação criada com a Appmax e defina o status como Ativa. Clique em Salvar.

 

 

 

 

 

Importante:

Após ativar a opção de boleto, aguarde cerca de 10 minutos para que as alterações apareçam no checkout.

 

Habilitar Pix como forma de pagamento:

Para realizar a configuração de pagamento via PIX na Vtex:

  1. Acesse a plataforma Vtex e clique em Configurações no menu lateral.

  2. Em Condições de pagamento, clique em Criar nova condição de pagamento.

  3. Selecione a categoria PAGAMENTO INSTANTÂNEO e clique em Pix.

  4. Expanda o menu Processar com a afiliação, selecione a afiliação criada com a Appmax e defina o status como Ativa. Clique em Salvar.

 

 

 

 

Importante:

Após ativar o Pix, aguarde cerca de 10 minutos para que as alterações apareçam no checkout.

 

Configurar tokens - Código de rastreio:

Para integrar os códigos de rastreio automaticamente da VTEX para a Appmax, siga os seguintes passos para configurar os tokens da VTEX no sistema da Appmax:

Gerar a chave de aplicação na VTEX:

  1. Acesse sua conta na VTEX: clique no seu perfil no canto superior direito e selecione "Configurações da conta".

  2. Chaves de aplicação: na página de configurações, clique em "Chaves de aplicação".

  3. Gerenciar Minhas Chaves: clique em "Gerenciar Minhas Chaves" e depois em "Gerar Chave".

  4. Gerar chave de aplicação: na tela, adicione um nome para a chave e clique em "Adicionar Perfis".

  5. Adicionar Perfis: selecione o perfil "OMS - Full Access" e clique em "Adicionar Perfis".

  6. Criar o token: clique em "Gerar" para criar o token.

  7. Armazenar o token: copie o token gerado e armazene-o em um local seguro. Ele será exibido apenas uma vez.

 

 

 

 

 

 

 

 

 

 

 

Caso o perfil "OMS - Full Access" não esteja disponível:

  1. Vá até o avatar do seu perfil e clique em "Configurações de conta".

  2. Perfis de Acesso: selecione "Perfis de Acesso".

  3. Criar novo perfil: clique em "Novo perfil" e, na tela de "Escolher Perfil de Acesso", selecione "OMS - Full Access".

  4. Salvar: após selecionar o perfil, clique em "Salvar".

 

 

 

 

Registrando os tokens da VTEX na Appmax

Após gerar os tokens no painel admin da VTEX, siga estes passos para registrá-los na Appmax:

  1. Acesse sua conta na Appmax: entre na sua conta da Appmax.

  2. Configurações: clique em "Configurações" no menu.

  3. Tokens VTEX: dentro das configurações, localize e clique em "Tokens VTEX".

  4. Adicionar Tokens: clique no botão "Adicionar Tokens".

  5. Preencher os campos: insira os tokens gerados na VTEX (a chave de aplicação e o token) nos campos correspondentes.

  6. Salvar: após preencher os campos, clique em "Salvar" para registrar os tokens na Appmax.

Agora a integração entre VTEX e Appmax estará configurada corretamente.

 

 

 

Agora a integração entre VTEX e Appmax estará configurada corretamente.