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
- No painel, vá em Pagamentos > Serviços, clique em Ajustes e, na linha do PagSeguro v4, em Configurar.
- 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.
- Você será redirecionado para o ambiente seguro do PagSeguro. Faça login, se solicitado.
- Clique em Autorizar para permitir a conexão com a sua conta.
- 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.
- 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
- Vá em Pagamentos > Serviços e clique em Adicionar.
- 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
- Vá em Pagamentos > Parcelas / Condições, clique em Adicionar e escolha o serviço (como Crédito PagSeguro v4).
- 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.