Integração EVO Pay

Este tutorial descreve como integrar o Evo Pay para tokenização de cartões de crédito e realizar vendas via API. O processo inclui a configuração do Evo Pay no frontend, a captura do token do cartão e a realização da venda através da API de vendas.

Passo 1: Configuração do Evo Pay

Antes de começar, carregue o script do Evo Pay para permitir a tokenização de cartões.

Adicione o script do Evo Pay no seu HTML:
Inclua a tag <script> no <head> do seu HTML para carregar o script do Evo Pay.

Criando o componente para capturar os dados do cartão:
Adicione o componente <evo-cartao> no corpo da página. Esse componente será responsável pela captura dos dados do cartão.

Configuração do Componente no JS:
Defina o componente evo-cartao e configure os dados necessários (gateway, bandeiras de cartões, traduções) para que ele funcione corretamente.

Configuração do Gateway evoCartao.gateway

Este código configura o gateway de pagamento do Evo Pay. Ele utiliza dados fornecidos pela API do Evo, que pode incluir informações sobre a chave pública (publicKey), configurações de antifraude, e outras propriedades necessárias para o processamento do pagamento.

Fonte dos Dados: A URL mencionada (https://evo-integracao-api.w12app.com.br/api/v1/configuration/gateway) fornece essas informações.

Configuração das Traduções (evoCartao.traducoes)

Esta configuração é usada para traduzir os campos do formulário de pagamento, como "Número do Cartão", "Nome do Titular", etc. Isso garante que os labels do formulário sejam apresentados no idioma correto para o usuário final.

Fonte dos Dados: Os dados de tradução são obtidos de uma API específica (https://evo-integracao-api.w12app.com.br/api/v1/configuration/card-translation), onde são fornecidas as traduções para cada campo do cartão de pagamento.

Passo 2: Usar o Token Gerado

Quando o cartão for tokenizado com sucesso, o evento 'eventoTokenGerado' será disparado, e você receberá um objeto com o token gerado. Esse token será utilizado para realizar a venda no Evo.

Passo 3: Realizar a Venda

Com o token gerado pelo Evo Pay, você pode realizar a venda via a API de vendas.

Exemplo de chamada POST para o endpoint de vendas:

Resumo dos Fluxos

Tokenização do Cartão: Use o Evo Pay para capturar os dados do cartão e gerar um token. Isso ocorre ao clicar no botão "Salvar".

Realização da Venda: Após obter o token, use a API de vendas para registrar a venda, passando os dados do cliente, do serviço e do pagamento, incluindo o token gerado.

Respostas: O retorno do evento eventoTokenGerado ou eventoOcorreuErro informará se a tokenização foi bem-sucedida ou se houve erro.

Esse fluxo garante que você possa realizar vendas com segurança e facilidade, usando o Evo Pay para tokenizar os cartões e registrar transações.

Integração EVO Pay

Passo 1: Configuração do Evo Pay#

Passo 2: Usar o Token Gerado#

Passo 3: Realizar a Venda#

Resumo dos Fluxos#

Passo 1: Configuração do Evo Pay

Passo 2: Usar o Token Gerado

Passo 3: Realizar a Venda

Resumo dos Fluxos