Central de Ajuda Quaza Provedores

Configurar gateway Gerencianet/Efí (PT)

Configurar gateway Gerencianet/Efí — Quaza

Configurar gateway Gerencianet/Efí

Como integrar o Quaza ao provedor Gerencianet/Efí

Esta wiki ensina a configurar o gateway Gerencianet/Efí no Quaza: cadastrar credenciais, vincular à carteira, validar notificação automática e testar. Tipo: Subadquirente brasileiro — completo PIX/Boleto/Cartão.

Nesta wiki:

Glossário

Termo O que é
Gateway API do provedor que gera/cancela cobranças (boleto, PIX, cartão)
Notificação automática Notificação POST que o provedor envia ao Quaza quando o status muda
Token Credencial de autenticação (chave da API, autenticação por chave, OAuth)
mTLS TLS mútuo — certificado cliente exigido pelo provedor
Ambiente de testes Ambiente de testes — não cobra de verdade
Carteira Conta financeira do Quaza vinculada ao gateway

O que Gerencianet/Efí cobre

  • Boleto
  • PIX
  • Cartão de Crédito
  • Carnê
  • Link de pagamento
Atributo Valor
Autenticação autenticação OAuth + mTLS opcional (PIX exige)
Notificação automática Auto via retorno automático URL
Ambiente de testes ambiente de testes.gerencianet.com.br
Portal https://sejaefi.com.br

Fluxo de configuração

1. Conta no portal Gerencianet/Efí
Crie conta produção (e ambiente de testes separada se for testar).
↓
2. Obter credenciais
autenticação OAuth + mTLS opcional (PIX exige) — extraia do portal.
↓
3. Cadastrar Carteira no Quaza
Financeiro › Carteira → aba Gateway → escolha Gerencianet/Efí e cole as credenciais.
↓
4. Configurar Notificação automática (se aplicável)
Auto via retorno automático URL
↓
5. Testar com cobrança real
Gere uma cobrança de R$ 1,00 — confira que retorna OK e notificação automática chega.

Obter credenciais no portal

Acesse https://sejaefi.com.br e siga o procedimento de criação de aplicação/integração.

📌 Ambiente de testes vs Produção: ambiente de testes.gerencianet.com.br

Configurar carteira no Quaza

Financeiro › Carteira
Tela Carteira no Quaza

Adicione carteira; aba Gateway tem os campos do provider Gerencianet/Efí.

Notificação automática

Auto via retorno automático URL

https://[seu-quaza]/notificação automática/financeiro/gerencianetefí/[id-carteira]

Testar (ambiente de testes)

  1. Cadastre carteira secundária em modo ambiente de testes no Quaza
  2. Crie cliente teste e contrato fictício
  3. Gere cobrança via essa carteira
  4. Verifique no portal Gerencianet/Efí que cobrança aparece
  5. Simule pagamento (ambiente de testes) e confira notificação automática chegou no Quaza

Verificar Gateway Registro de operações

Financeiro › Financeiro Gateway
Gateway Registro de operações

Registro de operações mostra cada chamada API + resposta. Filtre por carteira para ver só as chamadas Gerencianet/Efí.

Passo a passo: configurar este gateway

💡 Cenário: sua empresa abriu conta no provedor e quer começar a emitir cobranças automaticamente pelo Quaza.
  1. Passo 1 — No portal do provedor, gere as credenciais (chave da API ou certificado digital).
  2. Passo 2 — No Quaza, abra: Financeiro › Cartera.
  3. Passo 3 — Clique em + Adicionar carteira de cobro (ou edite a existente).
  4. Passo 4 — Preencha os campos básicos: nome da carteira, banco/instituição, conta.
  5. Passo 5 — Vá na aba Gateway.
  6. Passo 6 — Selecione o provedor na lista.
  7. Passo 7 — Cole a credencial obtida no portal do provedor.
  8. Passo 8 — Marque se é Ambiente de testes ou Produção.
  9. Passo 9 — Salve a configuração.
  10. Passo 10 — Teste: gere uma cobrança de valor baixo e veja se aparece no portal do provedor.

Passo a passo: investigar problema (cliente pagou e Quaza não baixou)

  1. Passo 1 — Abra: Financeiro › Financeiro Gateway (gateway log).
  2. Passo 2 — Filtre pela carteira correspondente.
  3. Passo 3 — Localize a chamada da cobrança em questão.
  4. Passo 4 — Veja a resposta do provedor — se OK, a cobrança foi enviada.
  5. Passo 5 — Se a notificação automática não chegou: confira no portal do provedor se a URL configurada está acessível (HTTPS válido público).
  6. Passo 6 — Última opção: force baixa manual ou aguarde a próxima consulta periódica do Quaza.

Recursos extras de Gerencianet/Efí

  • Marca renomeada Gerencianet → Efí em 2023
  • PIX recorrente nativo
  • Antecipação automática

Pegadinhas

⚠️ 1. Quaza ainda chama "Gerencianet" no código (compat) — UI pode dizer Efí
⚠️ 2. PIX requer chave PIX cadastrada na Efí
⚠️ 3. Cartão tem 3DS opcional

FAQ

Posso ter múltiplas carteiras Gerencianet/Efí?

Sim, uma por conta no portal Gerencianet/Efí. Tokens diferentes.

Cliente paga mas Quaza não baixa.

Verifique notificação automática (URL pública? HTTPS válido?). Se notificação automática não chegar, espere consulta periódica diário ou force baixa manual.

Token expirou.

Renove no portal Gerencianet/Efí e atualize na carteira.

Wikis relacionadas: Gateway Bancário (visão geral) · Geração de Cobrança · Remessa CNAB