Betalabs: Integrando com a plataforma

Passo a passo para integrar sua loja BetaLabs à Pagar.me: painel, chaves de API e criptografia e checagem da integração.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da Pagar.me v5 (versão clássica). Para projetos novos, explore o API Catalog.

1. Veja como começar o processo de integração

Acesse seu painel de controle Pagar.me e clique em Configurações no menu vertical ao lado esquerdo da tela.

1396

Nas Configurações, procure por Chaves de API, selecione a Versão 2 (2017-07-17) e salve esses códigos. Você utilizará as chaves de API e Criptografia na configuração da BetaLabs.

1396

2. Agora, é hora de acessar seu painel de controle na BetaLabs

No menu vertical da esquerda, clique em Configurações.

1396

Na lista de Configurações selecione Gateways.

1396

Nas configurações do Gateway selecione o Pagar.me e clique em Chave da API. Cole a chave de API que você encontrou no painel do Pagar.me e salve.

1396

Observação importante sobre as Chaves

Muita atenção às chaves de API e Criptografia utilizadas na configuração. Para que as transações do seu site de fato aconteçam e você receba o dinheiro das vendas, essas chaves devem estar na versão 2017-07-17 e os códigos devem começar com ak_live e ek_live. O termo live indica que essas são as chaves de produção, ou seja, geram vendas reais. Já as chaves de teste, começam com ak_test e ek_test. Então, certifique-se de você copiou os códigos certos de acordo com seu objetivo.

2. Agora, é hora de acessar seu painel de controle na BetaLabs

Após a configuração do Pagar.me na Betalabs é necessário definir as opções de pagamento para sua loja. Para isso, você deve acessar o menu lateral esquerdo do painel Betalabs e em Finanças selecionar Métodos de Pagamento. Se preferir, você pode assistir ao passo-a-passo dessa etapa aqui.
Ao acessar a listagem clique em + Adicionar e preencha a listagem com base nas informações apresentadas abaixo:

1152

CampoDescrição
NomeIndica o nome que aparecerá ao seu cliente na finalização da compra (Cartão de Crédito, Boleto).
CanaisIndica onde essa opção de pagamento deve ser apresentada, ERP (apenas no sistema) ou E-commerce (na loja online).
Gateway de pagamentoAqui você deve selecionar o Pagar.me.
TipoDefine o tipo de pagamento (cartão ou boleto).
Desconto PercentualÉ a porcentagem de desconto aplicada ao selecionar a opção de pagamento.
DescontoÉ o desconto em valor real aplicado ao selecionar a opção de pagamento.
Juros PercentualIndica se haverá juros após o vencimento.
JurosPorcentagem de acréscimo aplicado ao pagar após o vencimento.
Multa PercentualIndica se haverá multa após o vencimento.
Multa após o vencimentoValor real da multa aplicada após o vencimento.

Não se esqueça de Salvar Alterações ao final da modificação.
Depois de fazer todas as configurações, uma mensagem de sucesso aparecerá no painel Betalabs.

Pronto! Sua loja está integrada ao Pagar.me!

4. Para checar o sucesso da integração, você pode

  • Realizar uma compra por boleto: faça o caminho do comprador do seu site e finalize a compra com a opção de Boleto Bancário. O pedido deve ser criado na BetaLabs e o boleto gerado no painel do Pagar.me.
  • Realizar uma compra por cartão de crédito: faça o caminho do comprador do seu site e finalize a compra com a opção de cartão de crédito. Você pode utilizar um número de cartão fictício (sugerimos 4242424242424242) para que a compra seja recusada. A transação deve aparecer como recusada no Painel do Pagar.me.

Aproveite e certifique-se de que o Número de Parcelas, Valor mínimo de parcela e Taxa de juros em parcelamento (caso configurado) estejam compatíveis com a configuração e façam sentido para o seu negócio.

Boas vendas!


Jornada: Conectar minha plataforma de e-commerce
Etapa 25 de 26