Como conectar o Quaza à API do Santander para cobrar por boleto bancário e validar a integração — o que chamamos de homologar.
O que é o gateway Santander
O gateway Santander liga o Quaza diretamente à API do Santander. Com ele, as cobranças são geradas pela internet e o pagamento volta confirmado automaticamente.
Homologar é validar suas credenciais com o Santander: você as informa, clica em Testar gateway e o Quaza confirma a conexão.
Como funciona a homologação
Você configura as credenciais, o Quaza pede autorização ao Santander e, se estiverem corretas, 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 Santander. No Quaza, é o botão Testar gateway. |
| Ambiente |
Homologação = ambiente de testes; Produção = valendo de verdade. |
| Chave Principal |
o Client ID da sua conta no Santander |
| Chave Secreta |
o Client Secret da sua conta no Santander |
| Token Privado |
a senha do certificado digital |
| Certificado |
Arquivo digital exigido pelo Santander em Produção, enviado pelo botão Importar certificado. |
| 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 Santander com a API de cobrança/integração habilitada.
• As credenciais de API: Chave Principal, Chave Secreta, Token Privado.
• Para o ambiente de Produção: o certificado digital fornecido pelo Santander.
Passo a passo
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 - Santander.
2 Em Ambiente, escolha Homologação para testar ou Produção.
3 Em Chave Principal, cole o Client ID da sua conta no Santander.
4 Em Chave Secreta, cole o Client Secret da sua conta no Santander.
5 Em Token Privado, cole a senha do certificado digital.
Grave e clique em Testar gateway.
Aba Gateway: (1) Integração gateway, (2) Ambiente, (3) Chave Principal, (4) Chave Secreta, (5) Token Privado e o botão Testar gateway.
Em Produção, importe o certificado. Antes de testar, use o botão Importar certificado para enviar o certificado digital do Santander. Sem ele, a conexão em Produção falha. Em Homologação normalmente não é exigido.
O botão "Testar gateway"
O botão Testar gateway pede uma autorização ao Santander usando as credenciais informadas. Se estiverem corretas (e, em Produção, com o certificado importado), aparece Conectado com sucesso — a integração está homologada.
Deu erro ao testar? Confira as credenciais (sem espaços sobrando) e o Ambiente selecionado. Em Produção, confira também o certificado importado e a senha. Credenciais de Homologação não funcionam 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. |
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. Credenciais de teste só valem no ambiente de Homologação. Troque para as de Produção ao entrar no ar.
2. São 3 credenciais. O Santander exige todas preenchidas — faltando uma, o teste falha.
3. Produção exige certificado. Importe o certificado digital pelo botão Importar certificado; em Homologação normalmente não é preciso.
4. Credenciais exatas. Cole cada valor exatamente como o Santander forneceu, sem espaços no início ou no fim.
Perguntas frequentes
Quem pode configurar a homologação?O operador do financeiro com acesso à Configuração para cobrança. Como envolve credenciais, costuma ser feito por quem cuida da cobrança da empresa.
Onde consigo as credenciais?São fornecidas pelo Santander — com o seu gerente de conta ou no portal de desenvolvedores do Santander. O Quaza não gera essas credenciais.
O pagamento baixa sozinho?Sim. A tarefa Financeiro - Gateway sincroniza os pagamentos automaticamente, dentro da janela de dias configurada.
Posso testar antes de colocar para valer?Sim. Selecione o ambiente Homologação, valide a conexão e só depois troque para Produção.
"Testar gateway" deu erro. O que fazer?Confira as credenciais e o ambiente, e — em Produção — o certificado importado. Corrija, grave e teste de novo.
Preciso importar arquivo de retorno?Não. No gateway o pagamento volta confirmado automaticamente.
Troquei as credenciais. Preciso testar de novo?Sim. Sempre que alterar uma credencial, o certificado ou o ambiente, grave e clique em Testar gateway.
Em quanto tempo o pagamento aparece como pago?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)".
Para que servem os campos "Verificação das cobranças"?Definem a janela de dias (anterior e posterior ao vencimento) que a tarefa olha ao buscar pagamentos. O padrão costuma ser 60 e 60.
Documentos relacionados