PagHiper: os campos do cadastro da integração, a regra das duas formas de pagamento e onde ficam a API Key e o Token

O QUE ESTA FONTE RESOLVE

Você já sabe que, na PagHiper, o Pix não é uma integração separada: é um campo dentro da mesma integração, e que antes de tudo precisa existir uma forma de pagamento apontando para ela. Esta fonte parte daí e responde o que vem depois: quais campos a tela pede, por que a forma de pagamento que você quer não aparece na lista, e onde ficam a API Key e o Token depois que a integração é salva.

OS CAMPOS DA TELA DE CADASTRO E DE EDIÇÃO

Adicionar integração e Editar integração usam o mesmo formulário. Ele tem exatamente estes campos, e esta lista é fechada — não existe outro campo escondido, aba ou passo adicional:

Forma para recebimento boleto Pix (obrigatório). É a forma de pagamento do financeiro que a PagHiper vai usar para emitir o boleto.

Forma para recebimento Pix. A dica do campo diz: "Associa uma forma de pagamento do financeiro para emissão de Pix no PagHiper". Ele não é marcado como obrigatório na tela, diferente do primeiro.

API Key (obrigatório). Vem do painel da PagHiper.

Token (obrigatório). Também vem do painel da PagHiper.

Juros de multa (%) (seleção). A dica do campo diz: "O percentual máximo autorizado é de 2%, de acordo artigo 52, parágrafo primeiro do Código de Defesa do Consumidor, Lei 8.078/90".

Juros de mora (%) (seleção). A dica do campo diz: "Aplicar 1% de juros máximo ao mês, esse percentual será cobrado proporcionalmente aos dias de atraso".

Dias para saque (obrigatório). Em integração nova ele já vem preenchido com 2.

Tarifa (R$). A dica do campo diz: "Taxa cobrada pelo PagHiper (ex: taxa por boleto pago). Obs.: Este valor será lançado somente em recebimentos confirmados". Ou seja, o valor que você informar aqui só entra no financeiro quando o recebimento é confirmado — não no momento em que o boleto é emitido. Qual é o valor da sua tarifa é assunto do seu contrato com a PagHiper; o sistema apenas lança o que você digitou.

A REGRA QUE MAIS CONFUNDE: OS DOIS CAMPOS DE FORMA DE PAGAMENTO SE EXCLUEM

Os dois seletores de forma de pagamento não mostram a mesma lista. A tela remove da lista do Pix a forma que você escolheu para o boleto, e remove da lista do boleto a forma que você escolheu para o Pix. Isso acontece na hora, assim que você troca a seleção, e também já vale quando você abre uma integração para editar.

O efeito prático é este: se você escolheu "Boleto PagHiper" no campo Forma para recebimento boleto Pix e em seguida abre o campo Forma para recebimento Pix, "Boleto PagHiper" não vai estar lá. Não sumiu, não foi apagada, não está faltando cadastro. Ela está ocupada no outro campo da mesma integração.

O motivo é evitar que a mesma forma de pagamento signifique duas coisas diferentes na mesma integração. Cada um dos dois campos precisa de uma forma de pagamento própria.

POR QUE A FORMA QUE VOCÊ QUER NÃO APARECE NA LISTA

Comece pelo mais comum: ela está selecionada no outro campo desta mesma integração. Olhe o campo vizinho antes de qualquer outra coisa.

Se não for isso, vale saber que a lista dos dois campos não é a lista completa das formas de pagamento do financeiro — ela vem montada e já filtrada pelo servidor. Uma forma de pagamento fica vinculada a uma integração só, então uma forma presa a outra integração não é oferecida aqui. Se a forma existe no financeiro, não está em nenhum dos dois campos e mesmo assim não aparece, me diga o nome dela que eu verifico a que integração ela está vinculada.

ONDE FICAM A API KEY E O TOKEN DEPOIS DE SALVAR

Nem a listagem nem a tela de Visualizar mostram credencial.

A tela Visualizar integração mostra exatamente isto, e é uma lista fechada: Recebimento Boleto/Pix, Recebimento Pix, Juros de multa (%), Juros de mora (%), Tarifa (R$), Dias para saque, Cadastrado por, Cadastrado em e Modificado em. Chave e token não estão na lista. Na listagem também não: cada linha traz só as duas formas de pagamento e as ações.

Quem tem os campos API Key e Token é a tela de Editar — é lá que eles são informados e trocados.

E, para "esqueci meu token" ou "quero trocar de conta PagHiper", o caminho seguro é sempre o mesmo, e não depende de conseguir reler a credencial: entre no painel da PagHiper, gere as credenciais de novo lá, abra Editar na integração e cole os valores novos.

Um aviso importante para os dois lados: chave e token são credenciais. O suporte não pede, não pergunta e não repete esses valores. Se você já enviou a sua para alguém, gere outra no painel da PagHiper e substitua em Editar.

Sobre o campo Forma para recebimento Pix ficar vazio: a tela não obriga o preenchimento e permite salvar sem ele. O que o servidor faz com a integração salva assim não está descrito aqui — se for o seu caso e o Pix não estiver gerando, avise que verificamos.

A TELA DE INTEGRAÇÕES

Enquanto não existe nenhuma integração cadastrada, a tela de Integrações mostra uma apresentação da PagHiper com um botão Adicionar integração, e o aplicativo leva você direto para lá. Abrir a PagHiper e cair em Integrações não é erro: é o sistema dizendo que ainda não há integração cadastrada. O mapa completo das telas do aplicativo está na fonte "PagHiper: o que é do aplicativo e o que é do ERP"; esta aqui trata do cadastro da integração.

Existe também um aviso "Esta loja não está integrada ao PagHiper." Ele aparece quando o próprio sistema te joga na tela de Integrações vindo de outra tela do aplicativo, e não naquela ida direta pela abertura do aplicativo. A leitura é a mesma nos dois casos: não há integração cadastrada nesta loja.

Um cuidado com essa tela de apresentação: os textos dela são material de divulgação da PagHiper, inclusive sobre custo e sobre cobrança por boleto compensado. Não os trate como confirmação do que você paga — preço, taxa e condição são do seu contrato com a PagHiper.

Depois que há integração, na listagem cada uma aparece com duas colunas de informação: Recebimento Boleto/Pix (a forma do primeiro campo) e Recebimento Pix (a forma do segundo). Cada linha tem três ações: Visualizar, Editar e Deletar. Ao clicar em Deletar, o sistema pergunta "Deseja remover a integração <nome da forma>?" antes de excluir. Se você buscar e nada bater, aparece "Nenhuma integração foi encontrada" — o que quase sempre é filtro de busca, não integração perdida.

O QUE COSTUMA DAR ERRADO, E A CAUSA REAL

A forma de pagamento não aparece na lista. Causa real: está no outro campo desta mesma integração, ou está vinculada a outra integração. Não é falha de cadastro.

Na hora de gerar o boleto ou o Pix, o sistema responde 'Forma de pagamento "<nome>" não vinculada a integração!'. Causa real: a forma de pagamento usada no lançamento financeiro existe, mas não está apontando para a PagHiper. É o lançamento que está com a forma errada, ou a forma que não foi vinculada. Confira qual forma está no lançamento e compare com as duas que estão na integração.

O sistema responde "O seu plano atual não lhe permite acessar a integração com o PagHiper. Por favor, contrate outro plano!". Causa real: o recurso da PagHiper não está liberado no plano da empresa. Isso é do comercial, não é configuração da tela.

Na tela inicial do aplicativo aparece uma tarja dizendo que a versão de demonstração deste aplicativo expira (com a contagem de dias, ou avisando que já expirou), com um link para contratar. Causa real: o recurso está liberado em demonstração, com prazo. Também é assunto de plano.

"Integrei e não funciona" sem mensagem nenhuma. Antes de abrir chamado, confira nesta ordem: existe integração cadastrada na lista; a forma de pagamento do lançamento é uma das duas que estão na integração; e as credenciais foram coladas de uma conta PagHiper ativa e verificada. Se a suspeita for a chave, o caminho mais rápido é gerar uma nova no painel da PagHiper e colar em Editar.

O QUE ESTÁ EM OUTRAS FONTES

A visão geral da PagHiper e o índice de qual fonte responde o quê estão na fonte "PagHiper: visão geral da integração e índice". Cadastro de forma de pagamento, conta bancária e cliente são do ERP principal e se respondem pelas fontes do ERP. 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 de integrações, o vínculo por loja e o efeito de remover uma integração estão na fonte de Integrações. Permissões de acesso têm fonte própria.