Como configurar o PagarMe v5

1. Pré-requisitos Essenciais


  • Acesso à Dashboard Pagar.me V5: Certifique-se de que você possui acesso à nova Dashboard da Pagar.me V5 (diferente do painel da Pagar.me V4). Caso sua conta ainda não tenha sido migrada ou seja nova, ela já estará na V5.
  • Conta Ativa e de Produção: Sua conta na Pagar.me V5 deve estar ATIVA e configurada para operar em modo de Produção. Contas de teste não funcionarão para vendas reais. Se o processo de ativação por parte da Pagar.me estiver pendente, recomendamos agilizar essa solicitação com eles.

2. Conectando sua Loja com a Pagar.me V5


Este é o procedimento padrão para estabelecer a conexão entre sua loja e a Pagar.me V5.


  1. Acesse as Configurações de Pagamento na Plataforma:

    • No painel administrativo navegue até: Serviços > Pagamentos > Ajustes > PagarMe5.

      Inicie a Conexão:

    • Dentro da página de configurações da Pagar.me V5, clique no botão "Conectar com credencial 1".

      Redirecionamento e Autorização na Pagar.me:

    • Você será automaticamente redirecionado para o ambiente seguro da Pagar.me.
    • Faça login com suas credenciais da Pagar.me.
    • Selecione a loja correta (sua conta de Produção) caso tenha múltiplas configurações na Pagar.me.

    • Revise e aceite os termos e condições apresentados pela Pagar.me para autorizar a instalação e comunicação do aplicativo da sua plataforma com sua conta Pagar.me.

      Retorno à Plataforma e Confirmação Inicial:

    • Após autorizar os termos na Pagar.me, você será redirecionado de volta para a página de configurações da Pagar.me V5 em sua loja (Serviços > Pagamentos > Ajustes > PagarMe5).
    • Se a conexão inicial for bem-sucedida, a plataforma poderá indicar que o token foi configurado ou que a conexão está estabelecida (por exemplo, com uma mensagem de sucesso como "Token configurado").

3. Configurações Imediatas Pós-Conexão na Plataforma


Após o redirecionamento de volta para Serviços > Pagamentos > Ajustes > PagarMe5, você precisará realizar os seguintes ajustes:


  • Análise de Risco Externa ou Captura Automática: Decida e configure se deseja habilitar uma análise de risco externa (se contratada) ou se as transações serão capturadas automaticamente. Siga as orientações específicas da sua plataforma para esta configuração.
  • Prazos de Boleto e PIX: Defina os prazos de validade para boletos bancários e códigos PIX gerados através da Pagar.me.
  • Configurar Link de Pagamento (se aplicável): Ajuste as configurações relacionadas à funcionalidade de link de pagamento da Pagar.me, caso sua plataforma ofereça essa integração.
  • Modo Sandbox (Ambiente de Testes): Certifique-se de que o campo referente ao modo "Sandbox" ou "Ambiente de Testes" esteja desabilitado para processar vendas reais.
  • Gravar: Após realizar todos os ajustes nesta tela, clique em "Gravar" para salvar as configurações. Uma mensagem de sucesso deve confirmar que as alterações foram salvas.

4. Adicionando os Serviços de Pagamento Pagar.me V5


Para que as opções de pagamento da Pagar.me V5 apareçam para seus clientes no checkout, você precisa adicioná-las:


  1. Navegue até: Serviços > Pagamentos.
  2. Clique em "Adicionar".
  3. Selecione e adicione os serviços Pagar.me V5 que você deseja oferecer (Ex: "Crédito PagarMe5", "PIX PagarMe5", "Boleto PagarMe5", etc.).

5. Configurando Opções de Parcelamento (Condições)


Após adicionar os serviços de pagamento (especialmente o de cartão de crédito), configure as condições de parcelamento:


  1. Acesse: Serviços > Parcelas / Condições.
  2. Adicione e configure as regras de parcelamento para os serviços Pagar.me V5 que você habilitou (principalmente para "Crédito PagarMe5"). Defina o número máximo de parcelas, juros, valor mínimo por parcela, etc.

6. Autorizando seu Domínio na Dashboard da Pagar.me (Essencial para Cartão de Crédito)


Para processar transações de cartão de crédito (especialmente via checkout transparente), a Pagar.me exige que o domínio da sua loja esteja autorizado na dashboard deles:


  1. Acesse a nova Dashboard da Pagar.me: https://dash.pagar.me/
  2. No menu da Pagar.me, navegue até Configurações > Conta.
  3. Localize o campo "Domínios que poderão enviar requisições pelo checkout transparente" (ou similar).
  4. Adicione o domínio da sua loja sem o https:// .
    • Exemplo para lojas em domínio temporário Braavo: sualoja.braavo.com.br (geralmente sem www ).
    • Exemplo para lojas em domínio oficial: www.sualoja.com.br (geralmente com www ).
  5. Após digitar o domínio, pressione a tecla Enter. O domínio deverá ser listado, muitas vezes com um fundo destacado ou um "X" para remoção, indicando que foi reconhecido.
  6. Role a página para baixo e clique em "Salvar alterações" na dashboard da Pagar.me.
  • Recomendação 1: Saia e entre novamente no menu Configurações > Conta na Pagar.me para validar se o domínio foi realmente salvo.
  • Recomendação 2: Confirme se a conta Pagar.me selecionada é de fato a de Produção (geralmente indicada como "ATIVO" de forma destacada no topo da dashboard Pagar.me) e se o domínio na lista está formatado corretamente e destacado visualmente.
  • Importante: Se sua loja estava em um domínio temporário (ex: .braavo ) e foi migrada para um domínio oficial, lembre-se de atualizar/substituir o domínio nesta mesma seção da Pagar.me.

7. Validando a Integração


Após todas as configurações, realize testes:


  • PIX ou Boleto: Faça um pedido de teste escolhendo PIX ou Boleto. Se o QR Code (para PIX) ou o código de barras (para Boleto) for gerado corretamente, a comunicação básica está funcionando.
  • Cartão de Crédito:
    • Certifique-se de que a etapa de Autorização de Domínio (etapa 6) foi concluída corretamente na Pagar.me.
    • Realize um pedido de teste com cartão de crédito. Se a transação avançar para a análise ou for aprovada, a integração está funcionando.
    • Se, ao tentar finalizar a compra com cartão, a página não avançar ou não houver nenhuma ação, o problema mais comum é a falta de autorização do domínio na Pagar.me. Revise cuidadosamente a etapa 6.

8. Observações Importantes


  • Método de Conexão: O processo descrito na etapa 2 (clicar em "Conectar com V5", redirecionamento e autorização na Pagar.me) é o método padrão e atual para estabelecer a conexão inicial. Manuais ou instruções que citem inserção manual de chaves de API ou tokens para a Pagar.me V5 devem ser desconsiderados para a conexão inicial na sua plataforma.
  • Suporte: Para dúvidas sobre sua conta Pagar.me, taxas, funcionalidades específicas da dashboard Pagar.me ou o processo de ativação da conta, contate diretamente o suporte da Pagar.me. Para dúvidas sobre as configurações dentro da sua plataforma de loja, consulte o suporte da plataforma.