Suporte: seg. a sex., das 9h às 18h

Como configurar o PagSeguro4

Atualizado em 16/07/2026

Este guia mostra como integrar o gateway PagSeguro V4 (versão 2022) à sua loja, para oferecer pagamento de forma segura e automatizada.

1. Pré-requisito: prazo de recebimento no PagSeguro

Antes de configurar na plataforma, defina o seu prazo de recebimento diretamente na conta PagSeguro.

  • O que fazer: acesse sua conta no PagSeguro e defina o plano de recebimento (por exemplo, 14 dias, 30 dias ou um plano negociado).
  • Por que importa: a conexão na plataforma é feita por um link correspondente a esse prazo. Sem esse passo, a conexão não funciona corretamente.

2. Conectar a loja com o PagSeguro V4

  1. No painel, vá em Pagamentos > Serviços > Ajustes > PagSeguro v4 (2022).
  2. Clique na opção Conectar recebimento que corresponde exatamente ao prazo configurado na sua conta PagSeguro (por exemplo, "14 dias", "30 dias" ou "Negociado").
  3. Você será redirecionado para o ambiente seguro do PagSeguro. Faça login, se solicitado.
  4. Clique em Autorizar para permitir a conexão com a sua conta.
  5. Ao voltar para a tela de ajustes, a Credencial 1 é preenchida automaticamente. Faça os ajustes:
  • Análise de Risco Externa: habilite se usar um serviço externo de análise de risco junto com o PagSeguro.
  • Prazos: preencha os prazos de validade de Boleto e PIX.
  • Pagamento via link (Webcheckout): configure, se for usar.
  1. Clique em Gravar.

Se as credenciais voltarem em branco: o problema costuma estar no prazo de recebimento. Revise a configuração na conta PagSeguro e refaça a conexão.

3. Adicionar os serviços de pagamento

  1. Vá em Pagamentos > Serviços e clique em Adicionar.
  2. Selecione os serviços do PagSeguro V4 que deseja oferecer:
  • Crédito
  • Pix
  • Boleto
  • Link de Pagamento

4. Configurar parcelas e condições

  1. Vá em Pagamentos > Parcelas / Condições e clique em Adicionar.
  2. Crie as regras para os serviços adicionados:
  • Cartão de crédito: o passo mais importante é configurar as condições do Crédito PagSeguro v4 (número máximo de parcelas, juros, valor mínimo da parcela).
  • Outros métodos: vale criar condições específicas, como um desconto para o PIX PagSeguro v4.

Ao final, faça um pedido de teste para garantir que tudo está funcionando.