PagSeguro no ERP: visão geral e por onde começar
O PagSeguro no ERP é uma integração de meio de pagamento: você cobra pelo PagSeguro e o ERP guarda o vínculo entre a cobrança e o seu lançamento. Esta fonte é o mapa da pasta. Ela diz o que é o quê e manda você para a fonte certa; o detalhe fica nas outras.
DOIS CADASTROS COM O MESMO NOME
Esta é a confusão mais cara do PagSeguro e vale conferir antes de qualquer outra hipótese.
Um é a integração do aplicativo PagSeguro, a que serve o financeiro (boleto e cobrança do lançamento). Ela é a tela nova, tem sete campos e não tem campo de token: quem autoriza é o próprio PagSeguro.
O outro é o PagSeguro como meio de pagamento da Loja Virtual, o que faz o PagSeguro aparecer na vitrine. Esse é um cadastro à parte, com tela própria (uma tela antiga, ainda com campo de token) e regras próprias de parcelamento e checkout.
Os dois gravam na mesma tabela, mas são registros diferentes. Cadastrar um não cria o outro. Quando o cliente disser "cadastrei e não funciona", pergunte qual dos dois ele preencheu.
O PRÉ-REQUISITO QUE TODO MUNDO PULA
Antes de a integração servir para alguma coisa precisa existir uma forma de pagamento apontando para o PagSeguro, e ela é escolhida dentro do próprio cadastro da integração. Se a forma que você quer não aparece na lista, o motivo comum é ela já estar vinculada a outra integração. Esse roteiro é o mesmo de todos os meios de pagamento e está na pasta Meios de pagamento.
NÃO SE COLA TOKEN NO APLICATIVO
No cadastro do aplicativo não existe campo de credencial. Você salva e o sistema leva você à página de autorização do PagSeguro; a autorização volta para o ERP e é ali que ela é verificada. Cadastro salvo não é conta autorizada: enquanto faltar autorizar, o Status da lista fica clicável, como um link. Detalhe completo na fonte 1548.
Você nunca precisa do token do cliente para atender. Não peça, não confira e não repita credencial nenhuma. Se ele colar uma na conversa, oriente-o a gerar outra no portal do PagSeguro.
POR ONDE O PAGSEGURO COBRA
No financeiro, pelo caminho do boleto. O link de pagamento decide por um campo só: se a forma de pagamento do lançamento estiver marcada como Pix, o link vai para o caminho de Pix; senão vai para o caminho do boleto, que é o que entrega a emissão ao PagSeguro. Fonte 1549.
Na loja virtual, como meio de pagamento próprio, com parcelamento e checkout transparente. Fonte 1554.
PELO PAGSEGURO NÃO SE PROMETE PIX
Isto está confirmado no código e não é "ainda não verificamos". No caminho de Pix do lançamento o sistema só tem tratamento para Banco Inter, GerenciaNet, PagHiper, Conta Integrada e as integrações que rodam fora do ERP. O PagSeguro não está nessa lista: a chamada volta vazia, sem cobrança e sem mensagem de erro. Na vitrine da loja virtual é a mesma história: a opção PIX só é montada para a Conta Integrada.
Se o cliente quer Pix, ele está no cadastro errado. Não prometa Pix pelo PagSeguro, nem para agora nem para depois.
QUANDO ALGO PARA DE FUNCIONAR
Integração depende da autorização do parceiro. Autorização revogada, conta bloqueada ou senha trocada do lado do PagSeguro derruba tudo sem nada ter mudado aqui. Recurso que para do nada é conta do parceiro até prova em contrário.
Erro devolvido pelo próprio PagSeguro se resolve no PagSeguro. O ERP repassa o que recebeu.
O QUE É DO PARCEIRO E NÃO SE DISCUTE AQUI
Taxa, tarifa, prazo de repasse, limite e aprovação de conta são contrato seu com o PagSeguro. O suporte não cita nem confere número. Os passos dentro do portal do PagSeguro mudam sem aviso.
ONDE ESTÁ CADA ASSUNTO
Cadastrar a integração do aplicativo, os campos, a autorização e o Status: fonte 1548.
Cobrar um lançamento pelo link de pagamento e por que Pix não gera nada: fonte 1549.
PagSeguro na loja virtual, parcelamento, checkout transparente e a situação do pedido: fonte 1554.
O que é do aplicativo e o que é do ERP, e o Recebimentos podado: fonte 1545.
Permissões, inclusive por que recebimento depende do financeiro: fonte 1482.
O QUE NÃO ESTÁ AQUI
O roteiro comum de integrar um meio 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 e quem é 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 na fonte de raiz de Integrações. Cadastro de cliente, forma de pagamento, conta bancária e lançamento são do ERP e têm fontes próprias. Não repita esses assuntos aqui: aponte.