PagHiper: visão geral da integração e índice — por onde começar e qual fonte responde o quê
O QUE É A PAGHIPER NO ERP
A PagHiper é uma das integrações de meio de pagamento do sistema. Ela serve para cobrar por boleto e por Pix, e roda dentro do próprio ERP — não é executada por um serviço externo. Isso importa no diagnóstico: quando alguma coisa não funciona, o roteiro é o do ERP (forma de pagamento, conta bancária, vínculo com a loja, plano), e não o das integrações bancárias que rodam fora.
Esta fonte é a visão geral e o índice da PagHiper. Ela responde o que a integração é, o que precisa existir antes dela funcionar e para onde ir depois. O detalhe de cada tela está nas fontes apontadas no fim.
O PIX AQUI É CAMPO DA MESMA INTEGRAÇÃO
Na PagHiper, receber por Pix não exige uma segunda integração. O Pix é um campo dentro da mesma integração que você cadastra para o boleto: o formulário traz "Forma para recebimento boleto Pix" e "Forma para recebimento Pix", lado a lado. Saber disso evita mandar o cliente procurar uma tela de Pix separada, que aqui não existe.
Não estenda isso a outras integrações de pagamento sem confirmar. Cada integração tem o seu desenho, e o que vale para a PagHiper não vale automaticamente para as outras.
DUAS FORMAS DE PAGAMENTO, UMA PARA CADA CAMPO
Mesmo sendo uma integração só, boleto e Pix precisam de formas de pagamento diferentes. A própria tela impõe isso: a forma escolhida em um dos dois campos sai da lista do outro, na hora.
E vale o pré-requisito comum a todas as integrações de pagamento: antes de a integração funcionar precisa existir uma forma de pagamento apontando para ela. Se a forma que você quer não aparece na lista, ou ela já está no outro campo desta mesma integração, ou já está vinculada a outra integração. Esse é o passo que mais se pula, e a causa mais comum de "integrei e não funcionou".
Como se cadastra forma de pagamento e conta bancária é assunto do ERP principal, tem fonte própria, e esta não repete.
O CAMINHO CURTO PARA COMEÇAR
Confira primeiro se a PagHiper está liberada para a sua empresa. Se o aplicativo não abre para ninguém, nem para o usuário master, não é permissão nem configuração de tela — a fonte de permissões diz o que olhar antes de tratar como contratação.
Depois cadastre no ERP a forma de pagamento que a PagHiper vai usar (duas, se você também for cobrar por Pix).
Então abra a PagHiper, vá em Integrações e cadastre a integração, informando a API Key e o Token gerados no painel da PagHiper.
Por fim, use essa forma de pagamento nos recebimentos que você quer cobrar pela PagHiper. É a forma de pagamento do lançamento que diz ao sistema por qual integração cobrar.
O QUE É DO PARCEIRO E NÃO SE RESPONDE AQUI
Taxas, tarifas, prazos de repasse, limites, aprovação e abertura de conta são o seu contrato com a PagHiper. Os passos dentro do painel dela mudam sem aviso.
A tela de apresentação da integração, a que aparece enquanto ainda não há integração cadastrada, traz textos de divulgação sobre custo e sobre cobrar só pelo que for compensado. Eles são material de divulgação da tela, não confirmação do que você paga. Quem confirma isso é a PagHiper. O suporte do sistema não informa nem confirma valor, taxa, tarifa ou condição comercial, e não compara parceiros.
Credencial também não passa por aqui. O suporte não pede, não pergunta e não repete API Key, token ou senha. Se você já enviou a sua para alguém, gere outra no painel da PagHiper e substitua na tela de editar a integração.
O QUE COSTUMA DAR ERRADO, EM UMA LINHA CADA
"Integrei e não funciona", sem mensagem: quase sempre não existe forma de pagamento apontando para a integração, ou o lançamento está com outra forma.
"Minha forma de pagamento sumiu da lista": ela está no outro campo da mesma integração, ou vinculada a outra integração.
"Parou do nada": se a mensagem veio da PagHiper, é com o parceiro; se sumiu de uma loja virtual, o vínculo da conta bancária com a loja é o primeiro suspeito.
"Não abre para ninguém": não é permissão, é liberação do aplicativo.
Cada um desses tem o diagnóstico completo na fonte específica, abaixo.
PARA ONDE IR DEPOIS: O ÍNDICE DA PAGHIPER
Campos do cadastro da integração, a regra dos dois campos de forma de pagamento, onde ficam a API Key e o Token depois de salvar, a listagem de integrações e as mensagens de erro do cadastro: fonte "PagHiper: os campos do cadastro da integração".
Gerar, acompanhar e compartilhar Pix, as travas que impedem a geração, a lista de Pix, o limite de 60 dias na busca e o botão "Ver no financeiro": fonte "PagHiper — Pix".
O mapa das telas, ou seja, o que dentro do aplicativo é mesmo da PagHiper e o que é o ERP inteiro, os recursos desligados na lista de Recebimentos e o cartão Recebimentos da tela inicial: fonte "PagHiper: o que é do aplicativo e o que é do ERP".
Permissões: onde elas ficam, por que só aparece o lado de receber, e o aviso sobre os links públicos de impressão do Pix: fonte "Permissões da PagHiper".
A PagHiper fora do aplicativo dela — loja virtual, Agenda PRO, catálogo da Gestão de Cobranças e o retorno do pedido pela API: fonte "PagHiper fora do próprio aplicativo".
O roteiro comum de integrar um meio de pagamento e o funcionamento geral do Pix estão na pasta de Meios de pagamento. O índice geral das integrações, o vínculo por loja e o efeito de remover uma integração estão na fonte de Integrações. O desenho comum dos canais de venda está na pasta de Marketplaces e e-commerce. Recebimento, forma de pagamento, conta bancária, cliente e nota fiscal se respondem pelas fontes do ERP.