Como configurar PagBank na LojaVirtual
Use sua própria conta PagBank (PagSeguro) para receber Pix, cartão de crédito e boleto. Os pagamentos são destinados à conta da sua loja. O checkout utiliza a API Orders; não usa o token de outro lojista.
Conectar sua conta ao PagBank da LojaVirtual
A LojaVirtual utiliza seu aplicativo PagBank Connect, já homologado como plataforma. Você autoriza o acesso à sua conta; os pagamentos continuam sendo recebidos diretamente nela. Não é necessário cadastrar um token individual nem enviar logs de homologação por loja.
- Abra Formas de pagamento > PagBank e clique em Conectar conta PagBank.
- Antes de sair, a tela explica a autorização para criar e acompanhar pagamentos. O botão abre o PagBank, vinculado à sessão da sua loja no painel LojaVirtual. Confira as permissões apresentadas pelo serviço.
- Entre na conta PagBank que receberá os pagamentos e autorize o aplicativo da LojaVirtual.
- Após autorizar, você retorna automaticamente à configuração no painel LojaVirtual. Confira Conta conectada e Ativa na loja ligado. Se a autorização expirar, use Reconectar conta.
- Habilite os meios desejados, revise parcelas e instruções de boleto e salve. Use Testar credenciais salvas para verificar o acesso sem criar uma cobrança.
A configuração permanece no painel novo da LojaVirtual. Se a sessão expirar, entre novamente nesse mesmo painel e reabra Formas de pagamento > PagBank. A configuração não exige entrar no painel antigo. O painel mantém a loja escolhida no acesso; se precisar mudar de loja, faça essa seleção antes de conectar a conta PagBank.
A autorização e o retorno são processados pelo Node. As credenciais ficam no cadastro compartilhado da loja, sem pedir que você as copie. A renovação automática continua no sistema existente. Após concluir a autorização com sucesso, a forma de pagamento é ativada automaticamente, inclusive ao reconectar. Parcelas, meios habilitados e a opção Exibir no checkout são preservados. A modalidade atendida é a integração transparente; o Checkout PagBank por redirecionamento não é oferecido nesta configuração.
Se a autorização for cancelada ou expirar, o painel informa o resultado e permite iniciar novamente. Use a mesma conta quando houver pagamentos anteriores. Se aparecer indisponibilidade da conexão da plataforma, fale com o suporte LojaVirtual; não é necessário cadastrar outro aplicativo ou token individual.
O retorno ao painel novo requer a habilitação do encaminhamento da LojaVirtual. Se após autorizar você voltar ao painel antigo, solicite ao suporte a habilitação desse retorno; não precisa gerar outro token ou cadastrar uma nova aplicação.
O indicador Ativa ou Inativa no cabeçalho acompanha o controle Ativa na loja. Para desativar depois, desligue esse controle e salve as alterações. Exibir no checkout é uma opção separada: estar ligado não ativa uma forma desativada.
Se você já havia salvo um token individual
As credenciais anteriores são preservadas para manter os pagamentos e a consulta do histórico, inclusive do ambiente de testes. O painel não oferece novos tokens ou troca de ambiente. Para mudar para a conexão da LojaVirtual, contate nosso suporte antes de reconectar: a troca precisa preservar a conciliação das cobranças anteriores.
Verificar credenciais e últimas cobranças
O botão Testar credenciais salvas verifica o acesso com a configuração já salva e consulta a última tentativa de cobrança registrada para essa conta e ambiente. Ele não cria cobranças, não testa pagamentos reais e não consulta a situação da verificação cadastral no PagBank. Após o retorno da autorização, confira o estado da conexão e use o botão para testar.
- Credenciais validadas: o acesso com as credenciais funcionou. Isso não comprova a liberação para criar cobranças.
- Nenhuma tentativa de cobrança registrada: ainda não há envio registrado para essa conta no ambiente da conexão.
- Última tentativa bloqueada pelo PagBank: o provedor recusou o acesso ao criar a cobrança. Se o aviso indicar falta de liberação, contate o suporte LojaVirtual para verificar a liberação da conta e da conexão da plataforma com o PagBank. Um novo teste de credenciais bem-sucedido não apaga o bloqueio registrado.
- Última tentativa sem confirmação de criação: não há confirmação suficiente sobre a criação. Confira o pedido e contate o suporte LojaVirtual se a dúvida continuar. Tentativas antigas sem detalhes de erro também podem aparecer assim; isso não comprova um bloqueio.
- Cobrança criada no PagBank: houve criação da cobrança indicada, mas isso não confirma que ela foi paga nem garante a aprovação de novas cobranças ou de outros meios de pagamento.
Confira a data da tentativa, o pedido, o meio e o ambiente. Sandbox representa testes sem pagamentos reais e não comprova funcionamento em produção. O resultado mostra o histórico consultado; após uma nova tentativa de pagamento, atualize a página ou teste as credenciais novamente. Em conexões Connect, use o botão para identificar a conta atual e consultar seu histórico. Se o histórico estiver indisponível, tente novamente em instantes.
Preciso homologar minha loja ou gerar testes de Sandbox?
A conexão usa o aplicativo da plataforma LojaVirtual. O lojista autoriza sua conta pelo PagBank Connect e não precisa gerar arquivos de Sandbox ou solicitar uma homologação individual para usar essa conexão. Eventuais validações da integração da plataforma são tratadas pela LojaVirtual com o PagBank.
A habilitação da conta e dos meios de pagamento continua sujeita às regras do PagBank. Se houver bloqueio ou acesso recusado, fale com o suporte LojaVirtual e informe o pedido e a mensagem mostrada em Última tentativa de cobrança.
Histórico de testes anterior
Se o histórico antigo de Sandbox indicar chave Pix não encontrada, esse resultado pertence à conta de testes daquele envio e não comprova bloqueio da conexão de produção. Não gere novas cobranças para corrigir uma tentativa sem resposta: confira o pedido e peça ajuda ao suporte.
Meios de pagamento e parcelamento
Os interruptores de Pix, cartão e boleto ficam à vista. Abra Configurações avançadas dos meios para alterar parcelas, descontos ou instruções de boleto; as condições existentes permanecem salvas quando o grupo está fechado.
- Pix: QR Code, código copia e cola e validade de uma hora. A confirmação é automática após consulta ao PagBank.
- Cartão: os dados são criptografados no navegador pelo SDK PagBank. Aprovação, análise e recusa aparecem no acompanhamento do pagamento.
- Parcelas: até 12, respeitando o máximo configurado, o valor mínimo por parcela e as opções aceitas pelo PagBank. Se o vendedor assume os juros, o comprador vê parcelas sem acréscimo. Se o comprador assume os juros, o checkout consulta as taxas do PagBank ao informar o número do cartão e mostra o valor das parcelas, os juros e o total antes do pagamento.
- Boleto: linha digitável, link e vencimento conforme o prazo de cancelamento da loja; o padrão é 10 dias. A compensação é confirmada automaticamente.
Descontos e frete já registrados no pedido integram o total da cobrança. Descontos ou adicionais específicos do meio de pagamento que não sejam suportados impedem sua oferta; o checkout não deve cobrar um valor diferente do apresentado.
Por que aparece somente 1x no PagBank?
Confira o máximo de parcelas, o valor mínimo por parcela e Quem assume os juros. A opção Sem acréscimo para o comprador até a parcela inclui a parcela indicada: com o valor 3, por exemplo, até 3x fica sem acréscimo; as opções seguintes podem ter juros do comprador. A parcela mínima no PagBank é R$ 5; se a loja configurar um mínimo maior, esse valor também será respeitado.
No modo em que o comprador assume juros, informe o número do cartão e aguarde a consulta. Se houver falha, use Consultar parcelas. A configuração de 12x é um limite, e a disponibilidade depende do valor e das condições do PagBank. Se as taxas ou o pedido mudarem antes de pagar, consulte novamente e confira o novo total; o checkout não altera o valor escolhido silenciosamente.
Cancelar ou estornar um pagamento
No detalhe do pedido, o titular encontra Pagamento PagBank. Confira o valor, marque a autorização e use Cancelar ou estornar pagamento. A solicitação é processada em segundo plano e a tela acompanha a resposta.
A ação solicita cancelamento ou devolução integral, conforme o estado e as regras aceitas pelo PagBank. Não há estorno parcial nesta tela, nem devolução automática de boleto já compensado. Se houver recusa ou resultado desconhecido, confira a cobrança na sua conta antes de devolver por outro canal.
O estorno financeiro não altera automaticamente o envio nem devolve produtos ao estoque. Revise a situação comercial em Pedidos. Uma operação já enviada não é repetida por novos cliques.
Liberação e problemas de configuração
Credenciais válidas não garantem a liberação de todos os métodos em produção. O uso depende da autorização da conta, das permissões da conexão da plataforma e da habilitação dos meios pelo PagBank. A homologação do aplicativo não substitui a análise cadastral da conta recebedora.
Se uma opção não aparecer, confira conta, ambiente, modalidade, parcelas, regras de exibição e valor do pedido. Uma cobrança criada ou uma página de retorno não comprova recebimento: aguarde a confirmação consultada no PagBank.
Veja também como receber por Pix e como configurar os meios de pagamento.