Neste manual vamos demonstrar como homologar a cobrança através do Gerencianet - Efí no sistema Quaza.
Neste manual vamos demonstrar como homologar a cobrança através do Gerencianet - Efí no sistema Quaza.
1º. Abra o site do Gerencianet, e faça o login com seu usuário e senha, segue abaixo link do site:
https://login.sejaefi.com.br/oauth/authorize?redirect_to=https://app.sejaefi.com.br/
2º. Após logar role a página para baixo até encontrar a opção "API";
3º. Clique em "Criar aplicação", e dê um nome a esta aplicação, exemplo "API Quaza";
4º. Clique em abrir e ative a opção de "API Emissão", conforme imagem abaixo:
5º. Em seguida abra a opção "API PIX", e selecione todos os campos de Produção e Homologação, conforme imagem abaixo:
6º. Clique em continuar;
7º. Irá solicitar uma assinatura eletrônica, caso você não tenha segue abaixo orientação de como criar:;
Como fazer a assinatura eletrônica:
- acesse a conta pelo aplicativo da Efí;
- clique no seu perfil, disponível no canto superior direito da tela inicial;
- a seguir, selecione “Configurações de segurança”;
- depois, clique no botão “Alterar assinatura eletrônica”.
- faça uma selfie em local com boa iluminação;
- insira sua senha de acesso .
8º. Após inserir a assinatura eletrônica, clique em continuar;
9º. Ao finalizar a solicitação as chaves serão geradas, conforme imagem abaixo:
10º. Copie estas chaves e cole em sua carteira que está sendo homologada no sistema Quaza, para isto acesse Menu> Controle financeiro > Carteira de cobrança > Acesse a carteira na qual deseja incluir esta forma de cobrança Gateway > Acesse a aba Configurações para cobranças > Clique em editar caso já tenha criado a forma de cobrança gateway, ou então crie uma nova > Na aba Gateway adicione as chaves, conforme imagem abaixo:
OBS: A chave Client ID vai no campo Chave Principal, e a chave Chave Secret vai no campo Chave Secreta.
Nesta aba será possível também habilitar para que estas cobranças tenham nota gerada automaticamente, esta habilitação é através do campo "Habilitar Geração de Notas". O campo ambiente deixe sempre em "produção".
Para saber mais sobre como fazer o cadastro da carteira de cobrança no sistema Quaza acesse a nossa documentação Explicação da tela Carteira de Cobrança.
11º. No seu aplicativo EFÍ acesse: Configurações > Configurações de cobrança > Boletos bancários e carnês > ativar a opção do Bolix, conforme imagem abaixo:
Caso não estiver ativo o Bolix não irá aparecer o QRCode PIX no boleto.
12. Ao final sugerimos que crie um boleto e faça o pagamento por QRCode e Código de Barras para confirmar que está sendo possível pagar das duas formas e que o valor está entrando na conta;
13º. Após confirmar que a homologação está ok através do pagamento de um boleto, poderá vincular os clientes a esta forma de cobrança e gerar o boleto;
ATENÇÃO:
Os valores de tarifas (registro e baixa) são estipulados pela plataforma de pagamento (Gateway), e o provedor deve estar ciente das tarifas cobradas. Bem como, ciente de que o valor do boleto (tarifa) quando é pago por pix pode ser diferente do pago por código de barras.
Em caso de dúvidas ou problemas, não hesite em contatar nosso suporte. Estamos aqui para ajudar!
Agradecemos por utilizar nossa documentação!
Visão geral
Documento de homologação da integração Quaza × Gerencianet via Gateway de cobrança. Hoje Efí — gateway popular pra PIX. Esse fluxo emite boleto/PIX direto via API do gateway, sem CNAB.
Pegadinhas frequentes
1. Credenciais de homologação ≠ produção. Use ambiente de homologação primeiro. Credenciais e endpoints diferentes — confira antes de mudar pra prod.
2. Webhook precisa estar acessível. Gerencianet envia notificação de pagamento via webhook. Servidor Quaza precisa estar acessível pela internet (HTTPS).
3. Token/API key expirando. Muitos gateways expiram credenciais. Configure renovação automática ou monitore.
4. Limite de taxa (rate limit). Gerencianet pode limitar requests/min. Em geração em massa, espace as requisições.
5. Confirmação por timestamp. Webhook pode vir 5-30min após pagamento. Não dependa de tempo real.
FAQ
Onde obtenho credenciais de homologação?
Painel do Gerencianet → API → criar credenciais de teste.
Tempo de homologação típico?
1-7 dias úteis (depende do banco — alguns instantâneos, outros analisam contrato).
Posso usar produção sem homologar?
Não — banco bloqueia. Homologação é obrigatória.
Quanto custa por transação?
Gerencianet cobra taxa por boleto/PIX/cartão. Confira tarifário.
Como debugar webhook não chegando?
Logs do Quaza → Request Log. Se nada chegou, problema é do banco (verifique configuração de URL).