PagSeguro como meio de pagamento da loja virtual e a situação do pedido
O MESMO NOME EM DOIS LUGARES
O PagSeguro aparece duas vezes no ERP e trocar um pelo outro é o erro mais caro desta integração. Um é o aplicativo PagSeguro, usado no financeiro (boleto, cobrança), ligado à forma de pagamento e com telas próprias. O outro — o que vemos aqui — é o PagSeguro como meio de pagamento da Loja Virtual.
A regra é a seguinte: para o PagSeguro aparecer na vitrine da loja virtual precisa existir o meio de pagamento da loja virtual, cadastrado, ativo e vinculado à integração, por empresa e por loja. Cadastrar apenas o aplicativo não coloca o meio na vitrine. Antes de qualquer outra hipótese, confirme qual dos dois você preencheu.
A tela desse cadastro é uma tela antiga do sistema, hoje legada — o ERP está migrando para a interface nova. Por isso o que vale aqui são os campos e as regras, não a posição de um botão ou o nome de um menu.
OS CAMPOS DO CADASTRO
A tela legada mostra: e-mail, token, ativo, checkout transparente, valor mínimo da parcela, desconto boleto à vista (em percentual), máximo de parcelas e tempo para saque. Nessa tela o desconto à vista fica desabilitado quando o checkout transparente está desligado — o desconto é do boleto.
Essa lista é referência, não é tudo o que o cadastro guarda. Entram também o máximo de parcelas sem juros, o percentual de parcelamento, a marcação de padrão da loja virtual, os recursos da integração (boleto e/ou cartão) e os campos de taxa e tarifa. Se você encontrar um campo que não está na lista da tela legada, isso não significa que ele não exista.
O token não deve ser pedido, conferido nem repetido em atendimento. Se ele for exposto numa conversa, gere um novo no portal do PagSeguro.
COMO OS VALORES DE PARCELAMENTO CHEGAM NA LOJA VIRTUAL
Há uma rotina que consolida os valores das integrações de pagamento na loja virtual: máximo de parcelas, máximo de parcelas sem juros, desconto à vista e percentual de parcelamento.
Ela só enxerga integração que esteja ao mesmo tempo marcada como padrão da loja virtual e ativa, e casa por empresa e por loja — integração de outra loja não entra na conta. Faltando uma das duas marcações, os valores não sobem.
Quando mais de uma integração atende a essas condições, o valor que vai para a loja é o maior entre elas — não necessariamente o do PagSeguro. É a explicação comum para "configurei um número de parcelas no PagSeguro e a loja mostra outro": vale conferir as demais integrações ativas e marcadas como padrão da loja virtual.
O QUE O CHECKOUT TRANSPARENTE MUDA NA VITRINE
Com o checkout transparente ligado, o meio de pagamento deixa de aparecer como uma opção só e se desdobra em opções separadas, conforme os recursos da integração: pode virar "Cartão de crédito", pode virar "Boleto bancário", e pode virar os dois. Na linha de cartão de crédito o desconto à vista é zerado — ele é do boleto. Se a integração não trouxer esses recursos, o meio continua aparecendo como opção única.
Há um limite conhecido: quando a loja tem mais de um meio de pagamento com checkout transparente, apenas o primeiro da listagem se desdobra; os demais aparecem como opção única. É um comportamento conhecido do sistema, não erro de configuração. Se isso atrapalhar, registre o caso com o suporte.
Com o checkout transparente desligado, o meio aparece como uma opção única, com o nome do próprio meio.
O PagSeguro não oferece PIX nesse desdobramento. Nessa listagem, a opção PIX só é montada para a Conta Integrada. Se você quer PIX na loja virtual e está olhando o PagSeguro, é o cadastro errado.
O QUE FICA REGISTRADO QUANDO A TAXA MUDA
Quando a taxa de parcelamento, a taxa de intermediação ou a tarifa de intermediação do PagSeguro são alteradas na edição, o sistema grava um log com o valor anterior, o novo, o usuário e a data. Isso ajuda no caso clássico do "mudou sozinho": consulte o registro antes de tratar como falha do sistema. Os valores em si são assunto do PagSeguro e do comercial — o suporte não discute taxa nem tarifa.
A SITUAÇÃO DO PEDIDO NÃO MUDA SOZINHA
Existe no sistema uma rotina de confirmação automática. Ela consultaria a transação no PagSeguro pelo código gravado no pedido e, com o pedido ainda na situação inicial da loja virtual e o pagamento confirmado, trocaria o pedido para a situação padrão de pagamento confirmado daquela empresa, gravando o registro no histórico de situações e disparando o efeito de estoque e financeiro conforme a configuração de lançar da situação de destino.
Na prática ela não confirma pedido nenhum, e o motivo é do próprio sistema, não da sua configuração: a consulta é feita no ambiente de testes do PagSeguro, nunca no ambiente real, e o e-mail e o token que ela usa vêm de um cadastro antigo, diferente do que a integração preenche hoje. Ou seja: a situação do pedido não muda sozinha, nem agora nem depois.
O caminho é: confirmar o pagamento no painel do PagSeguro, alterar a situação do pedido manualmente e registrar o caso com o suporte. A alteração manual funciona normalmente e produz os mesmos efeitos de estoque e financeiro da situação escolhida — esse efeito de lançar e estornar é do ERP, não é específico do PagSeguro, e está descrito no conteúdo sobre situações.
O QUE NÃO ESTÁ AQUI
O roteiro comum de integrar um meio de pagamento, o pré-requisito da forma de pagamento e o funcionamento geral do Pix estão na pasta Meios de pagamento. O desenho comum dos canais de venda, o de-para de situações, quem é o dono do pedido, do estoque e do preço estão na pasta Marketplaces e e-commerce. O índice das integrações, o vínculo por loja e o efeito de remover uma integração estão no conteúdo geral de Integrações. A visão geral do PagSeguro e o índice desta pasta estão no conteúdo de apresentação do PagSeguro; o cadastro do aplicativo e a autorização, no conteúdo sobre cadastrar a integração do PagSeguro.
O QUE COSTUMA DAR ERRADO
Cadastrou o aplicativo PagSeguro e esperava que a loja virtual passasse a receber. O meio de pagamento da loja virtual é um cadastro à parte, que precisa existir, estar ativo e estar vinculado à integração. Confirme qual dos dois você preencheu.
O meio de pagamento está inativo, ou não está marcado como padrão da loja virtual. A consolidação dos valores de parcelamento exige as duas coisas ao mesmo tempo. Faltando uma, os valores não sobem.
O número de parcelas na loja não é o que você configurou no PagSeguro. Quando há mais de uma integração ativa e marcada como padrão da loja virtual, prevalece o maior valor entre elas.
O plano da empresa não inclui o recurso da integração. A listagem que a loja virtual consome filtra os meios de pagamento pelo recurso do plano — se o recurso não está no plano, o meio simplesmente não aparece, sem mensagem de erro.
O cadastro da integração foi apagado. Quando o sistema não encontra mais o registro da integração vinculado ao meio de pagamento, ele desfaz o vínculo e desativa o meio de pagamento. O efeito é o meio "sumir da loja" — a causa é o cadastro removido.
O pedido foi pago no PagSeguro e ficou na situação inicial. Confirme o pagamento no painel do PagSeguro, altere a situação manualmente e registre o caso com o suporte. A mudança automática não vai acontecer depois.
A integração é por loja. Quem tem mais de uma loja precisa do cadastro na loja que vende — o registro de uma loja não atende a outra.