Bem-vindo à documentação Pagar.me

Aqui você vai encontrar guias e exemplos para te ajudar
a integrar com a melhor API de Pagamentos do Brasil!

Começar

Você também pode buscar ou navegar pelas categorias

Configurando o plugin Pagar.me no WooCommerce

Agora que você já tem o plugin instalado no seu WooCommerce, vamos então configurar este complemento para aceitar transações por Boleto e Cartão de crédito.

Configurações de Boleto bancário

Primeiro é preciso que você encontre o plugin Pagar.me. Faça isso em: Plugins > Plugins Instalados > WooCommerce Pagar.me e clique em Configurações de boleto, assim como é mostrado nos passos 1 a 3:

Ao clicar em Configurações de boleto, a tela a seguir é mostrada. É preciso configurar esses campos, então veja o que cada um significa e como fazer isso nas explicações abaixo.

Explicando os campos da imagem acima:

Habilitar/Desabilitar:

Ativa ou desativa a opção de oferecer o boleto do Pagar.me na sua página de finalização de pedido.

Título:

Neste campo é necessário indicar o nome que será mostrado para a opção de Boleto bancário na página de finalização de compra no seu site.

Descrição:

Ao lado do título você pode também fornecer uma descrição para esta opção, também na página de finalização de compra no seu site.

Chave de API do Pagar.me:

Neste campo você coloca a sua API Key, que é uma chave utilizada para autenticar o seu negócio junto à API do Pagar.me.

🚧

Chave de teste e de produção

Preste atenção sempre em qual chave você está usando, se é a de teste ou a de produção.
Exemplo de API Key de teste: ak_test_grXijQ4GicOa2BLGZrDRTR5qNQxJW0
Exemplo de API Key de produção: ak_live_qlSlEXJgsqaCjKohh5AZfnqv7OLP5Q

🚧

Atenção!

Garanta que a versão de API configurada em sua conta Pagar.me é a 07-17-2017. Você pode verificar essa informação diretamente na Dashboard do Pagar.me junto com as chaves de API. Se a versão configurada for diferente, você pode ajustar na própria Dashboard.

Chave de Criptografia do Pagar.me:

Neste campo você deve colocar a sua Encryption Key, que é uma chave essencial para realizar transações com Cartão de crédito usando a API Pagar.me.

🚧

Chave de teste e de produção

Da mesma forma que o campo anterior, preste atenção sempre em qual chave você está usando, se é a de teste ou a de produção.
Exemplo de Encryption Key de teste: ek_test_aHGru3d5a7qweiftqXg1bQvbN1c7K0
Exemplo de Encryption Key de produção: ek_live_Wa8CDUuLlFvSQzjxf4YFZIBQvb2l1p

Log de depuração:

Habilita a opção de que eventos sejam registrados em um arquivo de Log. Isso é essencial para investigar possíveis questões que interfiram no funcionamento do plugin.

Uma vez inseridas todas essas informações, a sua tela deve estar parecida com a seguinte:

Excelente! Agora é só clicar em Salvar alterações para que o boleto do Pagar.me esteja habilitado na sua aplicação.

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

Assim como na configuração anterior, para fazer as alterações de Cartão você precisa seguir o caminho: Plugins > Plugins Instalados > WooCommerce Pagar.me e então clicar em Configurações de Cartão de crédito, como mostra a imagem abaixo:

Ao clicar em Configurações de Cartão de crédito, a tela a seguir é mostrada. É preciso configurar esses campos, então veja o que cada um significa e como fazer isso nas explicações abaixo.

Explicando os campos da imagem acima:

Habilitar/Desabilitar:

Ativa ou desativa a opção de pagamento com Cartão de crédito na sua página de finalização de pedido.

Título:

Neste campo é necessário indicar o nome que será mostrado para a opção de Cartão de crédito na página de finalização de compra no seu site.

Descrição:

Ao lado do título você pode também fornecer uma descrição para esta opção, também na página de finalização de compra no seu site.

Chave de API do Pagar.me:

Neste campo você coloca a sua API Key, que é uma chave utilizada para autenticar o seu negócio junto à API do Pagar.me.

🚧

Chave de teste e de produção

Preste atenção sempre em qual chave você está usando, se é a de teste ou a de produção.
Exemplo de API Key de teste: ak_test_grXijQ4GicOa2BLGZrDRTR5qNQxJW0
Exemplo de API Key de produção: ak_live_qlSlEXJgsqaCjKohh5AZfnqv7OLP5Q

Chave de Criptografia do Pagar.me:

Neste campo você deve colocar a sua Encryption Key, que é uma chave essencial para realizar transações com Cartão de crédito usando a API Pagar.me.

🚧

Chave de teste e de produção

Da mesma forma que o campo anterior, preste atenção sempre em qual chave você está usando, se é a de teste ou a de produção.
Exemplo de Encryption Key de teste: ek_test_aHGru3d5a7qweiftqXg1bQvbN1c7K0
Exemplo de Encryption Key de produção: ek_live_Wa8CDUuLlFvSQzjxf4YFZIBQvb2l1p

Checkout Pagar.me:

Ao habilitar esta opção, a sua página de finalização de pedido chama o modal de pagamento Checkout Pagar.me. Este é um produto nosso que tem um grande impacto positivo na sua taxa de conversão. O Checkout é mostrado na página de pagamento dessa forma:

Caso você opte por deixar o Checkout Pagar.me desabilitado, o formulário para inserir os dados será o seguinte, ou o correspondente para o seu tema do WooCommerce:

Número de parcelas:

Este campo define em até quantas vezes será possível parcelar um pedido.

Valor da menor parcela:

Caso queira, você pode definir um valor mínimo para as parcelas de compras feitas no seu site. O módulo mostra sempre o maior número até que o valor seja atingido. Por exemplo: Um produto A tem um valor de R$100,00, mas foi configurado no módulo que a parcela mínima seria R$70,00, então a única opção disponível é o pagamento à vista.

Taxa de juros:

O módulo Pagar.me oferece a conveniência de calcular (via juros simples) o valor das parcelas de acordo com um valor de juros passado neste campo. Configure este valor usando ponto, e não vírgula. Caso a sua aplicação não cobre juros, é preciso deixar o campo como 0.

Parcelas sem juros:

Alinhado diretamente com o ponto de juros, esta opção define em até quantas parcelas aquele pedido não será cobrado juros. Exemplo: Digamos que o campo esteja configurado com 3, ou seja, caso o cliente opte por comprar em 1x, 2x ou 3x, seu pedido não será cobrado juros, mas caso escolha 4x, todas as parcelas terão juros aplicados.

Log de depuração:

Habilita a opção de que eventos sejam registrados em um arquivo de Log. Isso é essencial para investigar possíveis questões que interfiram no funcionamento do plugin.

Seguindo as configurações acima, a sua página de Cartão de Crédito Pagar.me deve estar da seguinte forma:

Agora tudo o que precisa ser feito é clicar em "Salvar Alterações" e a sua loja estará pronta para transacionar com a opção de Cartão de crédito do Pagar.me. Viu como é simples?

Updated 2 years ago


Próximo

Se você usa o PrestaShop, pode ver na próxima página como instalar o módulo do Pagar.me nessa plataforma.

Instalando o módulo Pagar.me no PrestaShop

Configurando o plugin Pagar.me no WooCommerce


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.