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

Como configurar o PagSeguro4

Atualizado em 22/10/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, clique em Ajustes e, na linha do PagSeguro v4, em Configurar.
  2. Na seção Conexão, clique no botão que corresponde exatamente ao prazo configurado na sua conta PagSeguro: Recebimento em 14 dias, Recebimento em 30 dias ou Recebimento 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, confira o aviso "Conta do PagSeguro conectada." e o selo Conectada em Conta do PagSeguro. A conexão já traz tudo o que a loja precisa, sem nenhuma chave para digitar. Depois, faça os ajustes:
  • Usar a análise de risco da loja — ligue se usar a ClearSale ou a Konduto junto com o PagSeguro. Com ela ligada, o pagamento no cartão fica só autorizado: a ClearSale captura o pedido aprovado, e com a Konduto a captura é feita no pedido. Desligada, o pagamento é capturado na aprovação.
  • Usar as parcelas calculadas pelo PagSeguro — ligado, o checkout mostra as parcelas com os juros calculados pelo PagSeguro, até o número máximo escolhido logo abaixo. Desligado, valem as condições da tela de Parcelas da loja (passo 4).
  • Vencimento do boleto e Validade do Pix — o prazo do boleto, em dias, e do QR Code do Pix, em horas. Em branco, vale 1.
  • Cancelar o pedido com o Pix vencido — ligado, o pedido que ficou aguardando pagamento com o QR Code vencido é cancelado na verificação periódica dos pedidos pendentes, a partir de 30 minutos depois do vencimento (e não na hora exata).
  • Link de pagamento (webcheckout) — os meios aceitos no link (boleto, Pix e cartão), as parcelas e a validade do link, se for usar.
  • Usar o ambiente de testes — mantenha desligado para vender de verdade. É o interruptor no título da seção de mesmo nome, no fim da tela.
  1. Clique em Gravar.

Se a conexão não for concluída: a tela avisa que o PagSeguro não concluiu a conexão. O problema costuma estar no prazo de recebimento: revise a configuração na conta PagSeguro e conecte de novo pelo botão do prazo correto. O mesmo caminho serve para trocar de conta ou de prazo.

Com o PagSeguro v4 ativo em Pagamentos > Serviços, a tela não grava enquanto a conta não estiver conectada, para o checkout não oferecer um pagamento que não consegue cobrar.

Atenção: a linha Conta de testes do PagSeguro, dentro da seção Usar o ambiente de testes, no fim da tela, é para quem quer testar a integração. Conectar a conta de testes liga o ambiente de testes e apaga a conexão de produção, que precisa ser refeita depois. Em uma loja que já vende pelo PagSeguro, isso deixa a loja sem receber até a reconexão.

3. Adicionar os serviços de pagamento

  1. Vá em Pagamentos > Serviços e clique em Adicionar.
  2. No campo Serviço, escolha cada serviço do PagSeguro V4 que deseja oferecer (um por vez), com o Nome no checkout e o Status em Ativo:
  • Crédito
  • Pix
  • Boleto
  • Link de Pagamento

4. Configurar parcelas e condições

  1. Vá em Pagamentos > Parcelas / Condições, clique em Adicionar e escolha o serviço (como Crédito PagSeguro v4).
  2. Marque as parcelas e defina o Tipo, a Taxa ou desconto e o Valor mínimo de cada uma, 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.