PagHiper — Pix: gerar, acompanhar, compartilhar e por que o Pix não aparece no financeiro
O QUE VOCÊ ENCONTRA AQUI
O Pix da PagHiper dentro do ERP tem três telas: a lista de Pix, a tela Receber (onde você gera) e a tela de detalhe de um Pix. Aqui está o que cada uma tem, palavra por palavra, e as travas que impedem a geração. A visão geral da integração está no conteúdo de apresentação da PagHiper. O roteiro comum de ligar um meio de pagamento e o funcionamento geral do Pix estão na pasta Meios de pagamento; a exigência de existir uma forma de pagamento apontando para a integração está no conteúdo geral de Integrações.
COMO GERAR UM PIX
Na lista de Pix, o botão Receber abre a tela de geração.
A tela Receber tem quatro campos, e essa lista é fechada: Valor do Pix (obrigatório), a marcação "Gerar recebimento no financeiro", Cliente (obrigatório) e Descrição (obrigatório). Não existe outro campo nessa tela.
A marcação "Gerar recebimento no financeiro" JÁ VEM MARCADA. Guarde isso, porque é a origem da dúvida mais comum sobre Pix que "não entrou no financeiro".
O campo Cliente é uma busca: você digita e o sistema lista os clientes cadastrados. Ao lado da busca existe a opção de cadastrar um cliente na hora, que abre a tela de cadastro de clientes do ERP em uma janela; ao salvar, o cliente novo já entra selecionado no formulário. É a mesma tela de cadastro de clientes do ERP, não uma tela da PagHiper.
Os botões são Gerar e Cancelar. Depois que o Pix é gerado, o formulário some e a tela passa a mostrar o QR Code; os botões viram Novo Pix e Cancelar. Novo Pix limpa tudo e devolve o formulário em branco, com "Gerar recebimento no financeiro" marcada de novo.
AS QUATRO TRAVAS ANTES DE GERAR
Antes das travas, valem os campos obrigatórios: se Valor do Pix ou Descrição estiverem em branco, não aparece mensagem nenhuma — o campo é que fica marcado em vermelho. Confira isso antes de procurar erro em outro lugar.
Passados os obrigatórios, o sistema confere quatro coisas antes de mandar qualquer pedido para a PagHiper. Se uma delas falhar, nada é enviado e você lê exatamente uma destas mensagens:
"Necessário informar um cliente!"
"Necessário informar um documento para o cliente selecionado!"
"Necessário informar um e-mail para o cliente selecionado!"
"O valor do Pix está abaixo do mínimo permitido de R$ 3,00!"
O porquê das duas do meio: o ERP monta a cobrança com o CPF/CNPJ e o e-mail do pagador, e puxa esses dois dados do cadastro do cliente que você selecionou. Então um cliente sem CPF/CNPJ ou sem e-mail no cadastro trava o Pix mesmo estando selecionado na tela — a tela está certa, o cadastro é que está incompleto.
O conserto não é na tela do Pix: é no cadastro do cliente, que é do ERP principal. Abra o cliente, preencha CPF/CNPJ e e-mail, salve, e volte a gerar. Como preencher o cadastro de cliente está no conteúdo do ERP.
A quarta trava é o valor: abaixo de R$ 3,00 o sistema nem tenta.
QUANDO A PAGHIPER RECUSA
Passadas as quatro travas, o pedido vai para a PagHiper. Se a resposta vier com erro e com uma explicação, o ERP mostra na tela a mensagem que veio de fora — o texto não é do ERP. Se a recusa vier sem mensagem, você lê "Erro ao gerar o Pix!".
Na prática: mensagem diferente das quatro travas acima significa que o problema não está nos campos da tela, e sim na resposta do parceiro (conta, credencial, regra da PagHiper) — é com o suporte da PagHiper que se resolve.
A TELA QUE SE ATUALIZA SOZINHA
Enquanto o QR Code está aberto na sua tela, o sistema fica ouvindo a confirmação do pagamento. Quando o pagamento entra, aparece o aviso "Pagamento recebido com sucesso!", o QR Code ganha um sinal de confirmação (fica esmaecido, com um visto verde por cima) e o painel ao lado deixa de mostrar as instruções de pagamento e passa a mostrar os dados do recebimento: valor, cliente, ID da transação, data e horário do pagamento. Você não precisa atualizar a página nem apertar nada.
Repare que o QR Code não desaparece — ele fica marcado como pago. E isso vale para a tela que está aberta: se você fechou a tela, acompanhe pela lista de Pix.
O COPIA E COLA NA HORA DE GERAR
Ainda na tela de geração, ao lado do QR Code há o passo a passo "Como pagar com Pix" e um bloco "Copie e cole" com o código completo, somente leitura. Clicar no código ou no ícone de cópia copia o código e mostra "Copiado!". Não precisa ir ao detalhe do Pix para pegar o copia e cola de um Pix recém-gerado.
COMPARTILHAR O PIX COM O CLIENTE
Depois de gerar, abaixo do QR Code aparece "Compartilhe" com três ações, e essa lista é fechada: Imprimir QR Code, que abre a página de impressão em outra aba; Enviar link por email; e Compartilhar link por whatsapp.
O envio por e-mail abre a janela "Enviar Pix por e-mail", com estes campos: Nome, E-mail, Responder para, Assunto do e-mail, Mensagem do e-mail e Link. Nome, Responder para, Assunto e Mensagem já vêm preenchidos e podem ser editados. O campo E-mail vem preenchido com o e-mail do cliente e tem um botão de mais para acrescentar outra linha de e-mail e um botão de remover nas linhas extras; o limite é de três e-mails, e ao tentar a quarta você lê "Não é possível enviar para mais de 3 e-mails!". Se o cliente tiver mais de um e-mail cadastrado (o do cadastro e os dos contatos), ao clicar no campo aparece a lista para escolher. O campo Link é somente leitura e tem botão de copiar. Abaixo da mensagem há o aviso "* O link para visualização do boleto será enviado junto com esta mensagem automaticamente." — o texto fala em boleto, mas o que segue é o link do Pix. O botão de envio é Enviar.
Compartilhar link por whatsapp abre a janela "Enviar por WhatsApp", com o número de celular e o texto da mensagem.
Atenção: as páginas de impressão do QR Code e do comprovante abrem sem login. Quem tiver o link vê a cobrança sem entrar no sistema.
A LISTA DE PIX
A lista tem seis colunas, e essa lista é fechada: Data, Devedor, CPF/CNPJ, Valor, Status e Ações.
Em Ações, cada linha tem três botões:
Visualizar, que abre o detalhe do Pix.
Um botão que muda conforme o status: enquanto o status não é Completo, Aprovado ou Recebido ele é o "QR code" e abre a impressão do QR Code; quando é um desses três, ele vira "Comprovante de recebimento" e abre o comprovante. É o mesmo botão, na mesma posição — o que muda é o destino.
"Ver no financeiro", que leva para o financeiro do ERP.
Quando não há nenhum resultado, a lista mostra "Nenhum Pix foi encontrado!". A lista pagina de 30 em 30, com o rodapé mostrando de quantos até quantos você está vendo.
"VER NO FINANCEIRO" APAGADO
O botão fica apagado quando o sistema não tem, naquele Pix, um lançamento financeiro para abrir — ele serve para abrir um recebimento que já exista, e nada além disso. Não é falha de carregamento e não adianta clicar.
O primeiro ponto a conferir é a marcação "Gerar recebimento no financeiro" na hora de gerar: ela é o que pede ao ERP o recebimento, e vem marcada por padrão. Se foi desmarcada naquele Pix, não nasceu lançamento nenhum — e é isso que o botão apagado está mostrando. Se a marcação estava ligada e mesmo assim o botão está apagado, vale abrir chamado para conferirmos aquele Pix especificamente.
Vale a distinção: o Pix pode ter sido cobrado e recebido normalmente pela PagHiper e, ainda assim, não existir o registro financeiro dentro do ERP. Uma coisa não desmente a outra.
Pelas telas de Pix não existe nenhuma ação que crie esse lançamento depois — nem na lista, nem no detalhe. Quem quiser o registro cria o recebimento direto no financeiro do ERP, como qualquer outro recebimento; isso é assunto do ERP principal e está no conteúdo do financeiro.
BUSCAR PIX ANTIGOS
O botão Busca avançada, no alto da lista, abre três filtros, e essa lista é fechada: Período, Status e CPF/CNPJ. Os botões são Buscar e Limpar.
A trava que mais gera chamado: o período máximo é de 60 dias. Assim que você escolhe datas com mais de 60 dias de diferença — sem nem precisar clicar em Buscar — o sistema limpa as duas datas e mostra "O período máximo para consulta é de 60 dias." É por isso que não dá para puxar o histórico do ano de uma vez. O caminho é consultar em blocos de até 60 dias.
O DETALHE DE UM PIX
A tela de detalhe mostra estes campos, e essa lista é fechada: Código, Devedor, E-mail devedor, Documento devedor, Valor, Data expiração, Valor Taxa, Data pagamento, Status, QrCode, Copie e cole e Cadastrado em.
Data pagamento mostra "-" enquanto o Pix não foi pago. O campo Copie e cole traz o código copia e cola completo, somente leitura; clicar no campo ou na ação Copiar, ao lado, copia o código e mostra o aviso "Copiado!". É daqui que você tira o copia e cola de um Pix já gerado.
OS STATUS
Os status que aparecem nas telas vêm da PagHiper. O que o sistema faz com eles: na lista, Pendente aparece em cinza, Completo e Recebido em verde, Cancelado em vermelho, e qualquer outro em cinza; e Completo, Aprovado ou Recebido são o que faz o segundo botão da linha virar comprovante em vez de QR Code. Essa relação não é a lista completa de status possíveis, e a cor não define o sentido: o significado comercial de cada situação e os prazos de compensação são da PagHiper.
O QUE COSTUMA DAR ERRADO
"O Pix não gera": leia a mensagem. Se for uma das quatro travas, o problema está no cliente selecionado ou no valor, e o conserto é no cadastro do cliente ou no valor digitado. Se não aparecer mensagem nenhuma, confira Valor e Descrição em vermelho. Qualquer outra mensagem veio da PagHiper.
"Parou do nada de gerar Pix": se antes gerava e agora aparece uma mensagem que não é nenhuma das quatro travas, é resposta da PagHiper. Trate com o suporte do parceiro. Nunca compartilhe token ou chave em conversa; se precisar trocar, isso se faz no portal da PagHiper.
"Recebi o Pix e não caiu no financeiro": veja se o botão "Ver no financeiro" daquele Pix está apagado. Se estiver, comece conferindo se a marcação "Gerar recebimento no financeiro" foi desmarcada na geração.
"O Pix sumiu da lista": confira os filtros da busca avançada — Período, Status e CPF/CNPJ. Um filtro esquecido esconde o resto, e a consulta é limitada a 60 dias. Use Limpar e refaça a busca.
"A tela do QR Code não atualiza": a atualização automática acontece na tela que está aberta com o QR Code. Se você navegou para outro lugar e voltou, confira o status pela lista ou pelo detalhe do Pix.
O QUE NÃO SE RESOLVE NESTA TELA
Cadastro de cliente (CPF/CNPJ e e-mail), lançamento financeiro e conta bancária são do ERP principal e têm conteúdo próprio. A tela de clientes aberta a partir do Pix e a tela para onde "Ver no financeiro" leva são telas do ERP, não da PagHiper.