This page's content:

🇧🇷 Ler Guia em Português |  🇺🇸 Read Guide in English

Make more money with EBANX Pay Local WooCommerce

With the EBANX Local Payment Gateway plugin for WooCommerce, you can offer local payment methods in the fastest growing markets in Brazil for thousands of new customers.

After our plugin is installed you will be able to:

  • Create payments & request refunds directly in WooCommerce, without needing any other integration or plugin
  • One-click purchases which allow your client to skip the checkout process by saving their credit card information
  • Offer credit card and boleto payments at checkout

And don’t worry, no technical knowledge is needed for installation; follow a few steps to install it and start processing with EBANX Pay.

1. Installing the plugin

WARNING: If you are using our old plugin for WooCommerce, please uninstall it before using the new one.

The easiest and quickest option to install the EBANX Pay plugin for WooCommerce is an automatic installation that can be done without leaving your web browser.

If you want to install the plugin manually, access our repository on Github.

To install it using the web browser, log in to the WordPress Dashboard and follow the steps below:

  1. Open your admin page in WordPress. Go to Plugins > Add new and search for “EBANX Local Payment Gateway for WooCommerce”.
  2. Click on “Install Now” button.
  3. Wait and once the plugin is installed, tap on “Activate”.

2. Configuring your checkout

  1. To properly set up the EBANX Pay plugin, you will need to have in hands the public and private keys provided the Welcome email message. If you need any help, reach us out via email localintegration@ebanx.com.
  2. Go to your WooCommerce and click EBANX Settings button in sidebar admin menu.
  3. Add the integration keys. Please, note that you will need to use different keys for test (sandbox) and production (live) modes.

Integration

Sandbox Integration Key

Unique test mode key, keep it safe and do not expose this information.

Sandbox Public Integration Key

General test mode key. You can do a token operation using this, key instead of the integration key when the request is from the client of your customer (browser, app, etc.). By doing this, you do not have to deal directly with the credit card information of your customer.

Live Integration Key

Once you have completed the process of integration with EBANX, you will receive a unique live mode key which will allow you to operate with our services; it is essential to keep all the information safe and not exposed.

Live Public Integration Key

General live mode key. Just like the Sandbox Public Integration Key, you can do a token operation using this key instead of the integration key when the request is from the client of your customer (browser, app, etc.). By doing this, you do not have to deal directly with the credit card information of your customer.

EBANX Sandbox

Mark or unmark the box to go into sandbox mode and live. EBANX Sandbox is a testing environment that mimics the live environment. Use it to make payments requirements to see how your eCommerce processes them.

Debug Log

Mark or unmark the box to choose to record all errors that occur when executing a transaction.

3. Enable Payment Methods

Enable the payment methods for your checkout and make sure that the payment methods chosen are included in your agreement.

Credit Card settings

Save Card Data

Choose to allow your customer to save their credit data for future purchases.

One-click Payment

Choose to allow your customer to complete payments in one-click using credit cards saved.

Enable Auto Capture

Automatically capture payments from your customers, just for the credit card. Otherwise, you will need to capture the payment going to WooCommerce -> Orders. Not captured payments will be cancelled within four days.

Maximum Number of Installments

Establish the maximum number of installments in which your customer can pay, as consented to your contract.

Minimum Installment

Set the minimum installment value during checkout. The minimum EBANX Pay allows for BRL is 5, lower values in these currencies will be ignored.

Interest Rates

If enabled, this option pass the processing fee to your customer when he chooses to pay in installments – “crédito parcelado.”

4. CPF and CNPJ

To process payments with EBANX Pay, we must have the tax ID information about the customer – CPF or CNPJ.

We strongly recommend using the Brazilian Market on WooCommerce plugin in order to create these fields in your checkout. Click here to install it.

Enable Checkout for

In order to process with the EBANX Plugin in Brazil there a few mandatory fields such as CPF identification for individuals and CNPJ for companies.

Checkout Manager

If you make use of a Checkout Manager, please identify the HTML name attribute of the fields.

Need any help? Reach us out at localintegration@ebanx.com.


🇧🇷 Ganhe mais dinheiro com o plugin do EBANX Pay para WooCommerce

Com o plugin de pagamentos EBANX Pay para Shopify, você pode oferecer métodos locais de pagamento no Brasil para milhares de novos clientes.

Após a instalação do plugin, você estará apto a:

  • Oferecer pagamentos via cartão de crédito e boleto no checkout da sua loja.
  • Melhorar sua taxa de conversão com nosso Checkout Transparente.
  • Criar pagamentos e solicitar reembolsos diretamente do WooCommerce, sem precisar de nenhum outro plugin ou integração.
  • Checkout com one-click, ao oferecer aos seus clientes a possibilidade de manter o cartão de crédito tokenizado salvo em sua loja.
  • Oferecer pagamento via cartão de crédito parcelado e poder repassar as taxas para o cliente.

E não se preocupe: não é necessário ter conhecimento técnico para fazer a instalação do plugin; basta seguir nosso passo a passo e começar a processar localmente no Brasil com o EBANX Pay.

1. Instalando o plugin

ATENÇÃO: Se você está usando a versão antiga do plugin do EBANX Pay para WooCommerce, por favor, desinstale-o antes de instalar a nova versão.

A forma mais fácil e rápida para instalar o plugin do EBANX Pay no WooCommerce é a instalação automática, que pode ser feita diretamente no navegador.

Para isso, entre no Dashboard do seu WordPress e siga os passos abaixo:

  • No Admin do WordPress, vá até Plugins > Adicionar novo e busque pela opção “EBANX Local Payment Gateway for WooCommerce“.
  • Clique em “Instalar agora
  • Aguarde a instalação do plugin ser finalizada e clique em “Ativar Plugin“.

Caso você prefira seguir com a instalação manual do plugin, acesse nosso repositório no Github.

2. Configurando seu checkout

Para configurar seu checkout, você precisará das chaves de integração (pública e privada) que foram enviadas no email de boas-vindas.

Caso você precise de alguma ajuda em relação às chaves, entre em contato com nosso time no email localintegration@ebanx.com.

Com essas informações em mãos, clique no link do EBANX Settings, na barra lateral esquerda do seu WordPress, e insira as chaves de integração.

Note que as chaves são diferentes para os ambientes de produção e para o ambiente de testes (sandbox).

Integração

Chave de Integração de Sandbox

Chave única utilizada para testes. Por favor, esta informação é confidencial, não a compartilhe.

Chave de Integração Pública de Sandbox

Chave geral utilizada para testes. Você pode fazer uma operação com token em vez de usar esta chave quando o request vem do seu cliente (via browser, app etc.). Ao fazer isso, você não precisa lidar diretamente com as informações abertas de cartão de crédito do cliente.

Chave de Integração Live

Uma vez finalizado o processo de integração com o EBANX Pay, você receberá uma chave única de produção que permitirá que sua loja opere utilizando nossos serviços de processamento de pagamento. Por favor, a chave é uma informação confidencial, não a compartilhe.

Chave de Integração Pública Live

Chave geral de produção. Assim como a Chave Geral de Testes, você pode fazer uma operação com token em vez de usar esta chave quando o request vem do seu cliente (via browser, app etc.). Ao fazer isso, você não precisa lidar diretamente com as informações abertas de cartão de crédito do cliente.

EBANX Pay Sandbox

Marque esta opção caso você deseje utilizar o modo de testes. A EBANX Pay Sandbox é um ambiente de testes que replica o ambiente de produção. Utilize-o para solicitar pagamentos e reembolsos e garantir que o funcionamento está adequado.

Debug Log

Marque esta opção para que os eventuais erros que ocorram ao processar uma transação sejam gravados.

3. Habilitar Métodos de Pagamento

Não se esqueça de habilitar os métodos de pagamento que serão disponibilizados em seu checkout. Eles devem ser os mesmos métodos incluídos no seu contrato com o EBANX Pay.

Configurações de Cartão de Crédito

Salvar Dados do Cartão

Permita que seu cliente salve os dados tokenizados do cartão de crédito para usá-lo em suas próximas compras.

Compra One-click

Habilite a compra com um só clique, utilizando as informações salvas do cartão de crédito.

Habilitar Auto-Captura

Capture pagamentos automaticamente dos seus clientes – válido para cartão de crédito. Caso esta opção não esteja habilitada, você precisará ir até WooCommerce > Pedidos e capturar os pagamentos individualmente. Pagamentos não capturados são cancelados automaticamente em 4 (quatro) dias.

Número Máximo de Parcelas para o Brasil

Defina o número máximo de parcelas que serão oferecidas aos seus clientes. Essa informação deve estar de acordo com as informações acordadas em seu contrato com o EBANX Pay.

Valor Mínimo da parcela para o Brasil

Defina o valor mínimo de uma parcela, que será mostrada no checkout. O valor mínimo permitido pelo EBANX Pay é R$ 5,00. Valores abaixo do mínimo não serão considerados.

Taxa de Juros

Habilite esta opção para repassar a taxa de processamento para seu consumidor quando ele optar pelo parcelamento (modalidade parcelado com juros). Insira os mesmos valores acordados no seu contrato com o EBANX Pay.

4. CPF e CNPJ

Para processar com o EBANX Pay, é obrigatório solicitar a identificação de CPF ou CNPJ do seu cliente. Nós precisamos desta informação para poder processar o pagamento.

Habilitar Checkout para

Defina se você quer vender para Pessoa Física, Pessoa Jurídica ou ambos.

Gerenciador de Checkout

Indicamos o uso do plugin gratuito Brazilian Market on WooCommerce para que sejam adicionados os campos de CPF e/ou CNPJ. Você poderá configurar o nome dos campos, como na imagem abaixo:

Qualquer dúvida, entre em contato com nosso time no email localintegration@ebanx.com.