Como configurar o PagSeguro4

Este guia detalha o processo para integrar o gateway de pagamento PagSeguro V4 (versão 2022) à sua sua loja na Braavo!, permitindo que você ofereça diversas formas de pagamento de maneira segura e automatizada.


1. Pré-Requisito Essencial: Prazo de Recebimento no PagSeguro

Antes de iniciar a configuração na sua plataforma, é fundamental que você já tenha configurado e definido seu prazo de recebimento diretamente em sua conta PagSeguro.


  • Ação Necessária: Acesse sua conta no PagSeguro e defina o seu plano de recebimento (por exemplo, 14 dias, 30 dias ou um plano negociado).
  • Importância: A conexão na plataforma será feita através de um link correspondente a este prazo que você configurou. Se este passo não for feito previamente no PagSeguro, a conexão não funcionará corretamente.

2. Conectando sua Loja com o PagSeguro V4

Este é o procedimento para estabelecer a conexão entre sua loja e o PagSeguro.


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

    • No painel administrativo da sua loja, navegue até: Serviços(9) > Pagamentos > Ajustes > PagSeguro v4 (2022).

      Inicie a Conexão:

    • Na tela de configuração, você verá opções de conexão baseadas no prazo de recebimento. Clique na opção "Conectar recebimento" que corresponde exatamente ao prazo que você configurou em sua conta PagSeguro (Ex: "14 dias", "30 dias" ou "Negociado").

      Redirecionamento e Autorização no PagSeguro:

    • Você será automaticamente redirecionado para o ambiente seguro do PagSeguro.
    • Faça login com suas credenciais do PagSeguro, se solicitado.

    • Siga as instruções na tela e clique em Autorizar para permitir que sua loja se conecte à sua conta PagSeguro.

      Retorno à Plataforma e Configurações Iniciais:

    • Após a autorização, você será redirecionado de volta para a tela de ajustes da PagSeguro v4 (2022) no menu admin.
    • As informações de conexão "Credencial 1" serão preenchidas automaticamente. Ajustes Imediatos:
      • Análise de Risco Externa: Habilite esta opção caso utilize um serviço de análise de risco externo em conjunto com o PagSeguro.
      • Prazos: Preencha os prazos de validade para pagamentos via Boleto e PIX (em dias ou horas, conforme a opção).
      • Pagamento via link (Webcheckout): Configure as definições para pagamentos gerados via link, se for utilizar esta funcionalidade.
    • Após realizar os ajustes, clique em Gravar.

  • Observação Importante: Ao retornar para a plataforma após a autorização, as credenciais de conexão devem ser preenchidas automaticamente. Caso isso não aconteça e os campos permaneçam vazios, o problema geralmente está na configuração do prazo de recebimento. Verifique novamente suas configurações diretamente no painel do PagSeguro e tente realizar o processo de conexão novamente.

3. Adicionando os Serviços de Pagamento do PagSeguro V4

Para que as opções de pagamento do PagSeguro apareçam para seus clientes no momento da compra, você precisa adicioná-las e ativá-las:


  1. Navegue até: Serviços(9) > Pagamentos > Botão “Adicionar”.
  2. Selecione e adicione os serviços do PagSeguro V4 que deseja oferecer. As opções que o PagSeguro oferece são:
    • Crédito
    • Pix
    • Boleto
    • Link de Pagamento

4. Configurando Parcelas e Condições

A última etapa de configuração envolve definir as condições de pagamento, como o parcelamento para cartão de crédito.


  1. Acesse: Serviços > Parcelas / Condições.
  2. Clique no botão Adicionar.
  3. Crie as regras e condições para os serviços do PagSeguro V4 que você adicionou.
    • Cartão de Crédito: O passo mais importante aqui é configurar as condições para o "Crédito PagSeguro v4". Defina o número máximo de parcelas, se haverá juros, o valor mínimo da parcela, etc.
    • Outros Métodos: também é importante criar condições específicas para outros métodos, como aplicar um desconto para pagamentos via "PIX PagSeguro v4", por exemplo.

5. Conclusão

Ao seguir estes três passos — conectar-se com a credencial correta, adicionar os serviços de pagamento e configurar as condições de parcelamento —, sua loja estará devidamente integrada com o PagSeguro V4 e pronta para processar pagamentos de forma segura. Lembre-se sempre de realizar um pedido de teste para garantir que todas as configurações estão funcionando como esperado.