Como conectar o Quaza direto à API de cobrança do Sicredi (gateway) e validar a integração — o que chamamos de homologar.
O que é o gateway Sicredi
O gateway Sicredi liga o Quaza diretamente à API de cobrança do banco. Com ele, os boletos são registrados pela internet e o pagamento volta confirmado automaticamente — sem precisar importar arquivo de retorno.
Homologar é o ato de validar suas credenciais com o Sicredi: você informa a chave de acesso, clica em Testar gateway e o Quaza confirma a conexão.
Como funciona a homologação
Você configura a chave, o Quaza pede autorização ao Sicredi e, se a chave estiver correta, a integração fica conectada:
Glossário
| Termo |
O que significa |
| Gateway |
Integração via API: a cobrança e a baixa do pagamento acontecem em tempo real, pela internet. |
| Homologar |
Validar suas credenciais com o banco. No Quaza, é o botão Testar gateway. |
| Ambiente |
Homologação = ambiente de testes; Produção = valendo de verdade. |
| Chave Principal |
A chave de acesso que o Sicredi fornece. É o único campo de credencial que o gateway Sicredi usa.
|
| Cooperativa e conta |
Identificam sua conta no Sicredi. Ficam cadastradas na Carteira de cobrança, não na aba Gateway. |
| Convênio de cobrança |
Contrato no Sicredi que habilita a emissão de boletos via API. |
| Tarefa "Financeiro - Gateway" |
Rotina automática que sincroniza os pagamentos das cobranças do gateway. |
Antes de começar
Você vai precisar de:
• Uma conta no Sicredi com convênio de cobrança via API habilitado.
• A chave de acesso fornecida pelo Sicredi (gerente ou internet banking).
• A cooperativa e a conta já cadastradas na Carteira de cobrança.
Passo a passo
Primeiro confira os dados bancários da carteira:
Financeiro → Carteira de cobrança
Confirme que a cooperativa (agência) e a conta do Sicredi estão preenchidas. Em seguida, abra a configuração para cobrança e vá na aba Gateway:
Configuração para cobrança → aba Gateway
1 Em Integração gateway, selecione Gateway - Sicredi.
2 Em Ambiente, escolha Homologação para testar ou Produção para valer.
3 Em Chave Principal, cole a chave de acesso do Sicredi.
4 Clique em Gravar configuração para cobrança e depois em Testar gateway.
Aba Gateway: (1) Integração gateway = Gateway - Sicredi, (2) Ambiente, (3) Chave Principal e (4) o botão Testar gateway.
Verificação das cobranças (Dias anterior / posterior). Esses dois campos definem a janela de dias que a tarefa olha para buscar pagamentos. O padrão costuma ser 60 e 60.
O botão "Testar gateway"
O botão Testar gateway pede uma autorização ao Sicredi usando a sua Chave Principal. Se a chave e a conta estiverem corretas, aparece a mensagem Conectado com sucesso — a integração está homologada.
Deu erro ao testar? Confira, nesta ordem: a Chave Principal (sem espaços sobrando), a cooperativa e a conta na Carteira de cobrança, e o Ambiente selecionado. Uma chave de Homologação não funciona em Produção e vice-versa.
Tarefas automáticas
Depois de homologado, você não precisa baixar pagamento manualmente — o Quaza faz isso por tarefas que rodam sozinhas:
| Tarefa |
O que faz |
| Financeiro - Gateway |
Sincroniza o status de pagamento das cobranças do gateway, dentro da janela de dias configurada (campos "Verificação das cobranças"). É a tarefa principal da integração. |
| Financeiro - Gateway (aviso) |
Gera os avisos e notificações relacionados às cobranças do gateway. |
| Financeiro - Gateway (pagamento) |
Processa pagamentos por cartão quando a carteira usa cobrança recorrente. Não se aplica ao boleto Sicredi comum. |
Manual ou automático. A baixa acontece sozinha pela tarefa; você também pode forçar a reconferência abrindo a cobrança na tela quando precisar de confirmação imediata.
Pegadinhas frequentes
1. Homologação não é Produção. Boletos gerados no ambiente de Homologação são de teste e não são pagáveis de verdade. Troque para Produção ao entrar no ar.
2. Cooperativa e conta vão na Carteira. A aba Gateway só recebe a Chave Principal. Os dados bancários (cooperativa/conta) ficam na Carteira de cobrança.
3. O Sicredi tem variações no menu. Para boleto/cobrança use Gateway - Sicredi. Existem ainda Sicredi Pix, Sicredi Pagamento de Cartão e Sicredi Transação Simples — cada um para uma finalidade diferente.
4. Chave Principal exata. Cole a chave exatamente como o Sicredi forneceu, sem espaços no início ou no fim.
Perguntas frequentes
Quem pode configurar a homologação?O operador do financeiro que tem acesso à Configuração para cobrança. Como envolve credenciais bancárias, costuma ser feito por quem cuida da cobrança da empresa.
Onde consigo a Chave Principal?Com o Sicredi — no internet banking PJ ou com o seu gerente, junto ao convênio de cobrança via API. O Quaza não gera essa chave.
Preciso importar arquivo de retorno?Não. No gateway o pagamento volta confirmado automaticamente. A importação de retorno é usada no modelo de Remessa/Retorno, não no gateway.
O pagamento baixa sozinho?Sim. A tarefa Financeiro - Gateway sincroniza os pagamentos automaticamente, dentro da janela de dias configurada.
Em quanto tempo o pagamento aparece?Na próxima execução da tarefa de sincronização, desde que o vencimento esteja dentro da janela "Verificação das cobranças (Dias anterior/posterior)".
"Testar gateway" deu erro. O que fazer?Confira a Chave Principal (sem espaços), a cooperativa e a conta na Carteira, e o Ambiente. Corrija, grave e teste de novo.
E o Pix do Sicredi?O Pix tem integrações próprias no menu — Sicredi Pix e Sicredi Pix Automático. Esta wiki trata do gateway de boleto/cobrança.
Posso testar antes de colocar para valer?Sim. Selecione o ambiente Homologação, valide a conexão e só depois troque para Produção.
Troquei a chave. Preciso testar de novo?Sim. Sempre que alterar a Chave Principal ou o ambiente, grave e clique em Testar gateway novamente.
Documentos relacionados