Na VTEX, você pode integrar com o provedor de pagamento easypay. Por meio deste conector, sua loja pode efetuar vendas utilizando a easypay, MBWay e MultiBanco.

Para utilizar a afiliação easypay no seu marketplace, é necessário:

• Instalar o app easypay
• Configurar o app easypay
• Configurar Webhook easypay
• Configurar afiliação easypay

Caso sua loja não seja um marketplace, acesse os artigos Configurar pagamento com easypay ou Configurar pagamento com easypay seller.

Para instalar o app easypay, siga os passos abaixo:

1. No VTEX IO CLI, execute o comando vtex login nomedaconta para realizar o login em sua conta.
2. Instale o app easypay por meio do comando vtex install easypaypartnerpt.payment-provider-easypay.

Após realizar a instalação do app easypay, você precisa configurá-lo. Para acessar a tela de configurações, siga os passos abaixo:

1. No Admin VTEX, acesse Hub de Extensões > Gerenciamento de Aplicativos, ou digite Gerenciamento de Aplicativos na barra de busca no topo da página.
2. Localize o app Easypay Payment Provider e clique em Configurações.

As informações de configuração estão divididas em quatro seções:

• Credenciais easypay (obrigatório)
• Pagamento (obrigatório)
• Personalização do Checkout easypay (opcional)
• Modo sandbox

Você deve realizar as configurações abaixo no ambiente easypay. O controle destas configurações é de responsabilidade da easypay, e portanto, a VTEX não garante que os passos abaixo estejam atualizados permanentemente. Utilize este documento como uma referência e consulte sua conta no ambiente easypay para informações atualizadas.

As informações desta seção devem ser preenchidas obrigatoriamente.

Key ID e Key Value: valor e ID da chave easypay.

Merchant account UID: identificação da conta do comerciante onde serão depositados os valores das compras dos produtos efetuados na loja. Caso não haja uma conta comerciante separada, é possível utilizar o “Account UID” da conta de pagamentos.

Margin account UID: identificação da conta de margens.

1. No menu lateral do ambiente easypay, clique em Beneficiário.
2. Copie as informações e salve as informações do Account UID disponíveis em Conta de Margens.

Refund account ID e Refund account key: easypay refund keys ID e value.

Os reembolsos são debitados diretamente de uma conta pertencente ao marketplace. Posteriormente, o marketplace deve solicitar ao seller o valor reembolsado.

Nesta seção, você deve indicar se a sua loja utilizará pagamentos assíncronos, síncronos ou ambos. Acesse a documentação easypay para verificar os métodos de pagamentos disponíveis e suas respectivas siglas de identificação.

Tipos de pagamento assíncronos aceites: métodos de pagamento assíncronos disponíveis para o cliente. Preencha apenas com as siglas dos tipos de Assíncronos, separados por vírgula, sem pontos e sem espaços.

Exemplo:

Correto	Incorreto
mb,dd,vi	mb, dd, vi

Caso este campo seja preenchido, será obrigatório o preenchimento do campo Dias para expiração de pagamentos assíncronos.

Tipos de pagamento síncronos aceites: métodos de pagamento síncronos disponíveis para o cliente. Preencha apenas com as siglas dos tipos de Síncronos, separados por vírgula, sem pontos e sem espaços.

Exemplo:

Correto	Incorreto
cc,mbw	cc, mbw

Dias para expiração de pagamentos assíncronos: tempo de expiração (em dias) de pagamentos assíncronos. Preencha apenas o número de dias desejados.

Exemplo:

Correto	Incorreto
10	10 dias, Dez ou 10/05/2023

A easypay possui um layout de Checkout nativo configurado no app. Veja abaixo:

Caso deseje realizar algum tipo de personalização no Checkout nativo da easypay, preencha um ou mais dos campos nesta seção:

• Checkout logo URL: logotipo a ser exibido no Checkout easypay. Preencha com o link do endereço da imagem a ser utilizada.
• Checkout background color: cor do background. Preencha o código HEX da cor desejada. Padrão nativo: #ffffff.
• Checkout accent color: cor dos destaques, padrão de botões e bordas dos inputs. Preencha o código HEX da cor desejada. Padrão nativo: #0d71f9.
• Checkout error color: cor das mensagens de erros. Preencha o código HEX da cor desejada. Padrão nativo: #ff151f.
• Checkout input background color: cor do background dos inputs. Preencha o código HEX da cor desejada. Padrão nativo: transparent.
• Checkout input border color: cor da borda dos inputs. Preencha o código HEX da cor desejada. Padrão nativo: a mesma cor utilizada no accent color.
• Checkout input border radius: permite definir o arredondamento das bordas dos inputs. Preencha com o valor desejado em pixels (apenas números). Padrão nativo: 50 pixels.

Exemplo:

Correto	Incorreto
35	35px

• Checkout button background color: cor do background dos botões. Preencha o código HEX da cor desejada. Padrão nativo: a mesma cor utilizada no accent color.
• Checkout button border radius: permite definir o arredondamento das bordas dos botões. Preencha com o valor desejado em pixels (apenas números). Padrão nativo: 50 pixels.

Exemplo:

Correto	Incorreto
30	30px

• Checkout button box shadow: opção que permite ativar ou desativar a sombra nos botões.

• Checkout font family: fontes utilizadas em textos. Preencha com o generic family name, web safe font ou link da fonte . Padrão nativo: Overpass. Exemplo correto: sans-serif, verdana, ou https://fonts.gstatic.com/s/overpass/v12/qFda35WCmI96Ajtm83upeyoaX6QPnlo6_PPbM5qKl8Kuo8AzesE.woff2

• Checkout base font size: permite definir o tamanho da fonte no elemento raíz. Preencha com o valor desejado em pixels (apenas números). Padrão nativo: 10 pixels.

Exemplo:

Correto	Incorreto
11	11px

Não utilize fontes acima de 12 pixels, pois poderão distorcer a visualização do layout.

Para habilitar o ambiente de testes de desenvolvimento, selecione a opção Ativar modo sandbox. Você deve utilizar credenciais de teste.

Após concluir o preenchimento dos campos de configuração, clique em Salvar.

Para configurar o webhook da easypay, sig os passos abaixo:

https://{nome-da-sua-conta}.myvtex.com/_v/easypaypartnerpt.payment-provider-easypay/webhook

Caso haja mais de uma conta de pagamento em seu marketplace, adicione um link para cada uma das contas existentes.

Para configurar a afiliação easypay, siga os passos abaixo:

1. No Admin VTEX, acesse Configurações da loja > Pagamentos > Configurações, ou digite Configurações na barra de busca no topo da página.
2. Na aba Afiliações de Gateways, clique no botão +.
3. Clique no conector easypay.
4. Preencha os campos Application Key e Application Token com as informações da sua conta easypay.
5. Em Captura Automática de Pagamento, selecione a opção Use O Comportamento Recomendado Pelo Processador de Pagamentos.
6. Em Ativar divisão e enviar recebedores?, selecione a opção Sim.
7. Clique em Salvar.

Para configurar os métodos de pagamento a serem processados pela easypay, acesse Condições de Pagamento.

Para definir condições especiais sobre os métodos de pagamento, acesse Configurar condições especiais de Pagamento.

Depois de seguir os passos indicados, o conector easypay pode demorar até 10 minutos para aparecer no checkout da sua loja como uma opção de pagamento.