Como conectar o Quaza à API do Asaas e validar a integração — o que chamamos de homologar.
O que é o gateway Asaas
O gateway Asaas liga o Quaza diretamente à API do Asaas. Com ele, as cobranças (boleto, Pix e cartão) são geradas pela internet e o pagamento volta confirmado automaticamente.
Homologar é validar sua credencial (a Chave de API) com o Asaas: você informa a chave, clica em Testar gateway e o Quaza confirma a conexão.
Como funciona a homologação
Você informa a Chave de API, o Quaza pede autorização ao Asaas 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 sua credencial com o Asaas. No Quaza, é o botão Testar gateway. |
| Ambiente |
Homologação = ambiente de testes (Sandbox) do Asaas; Produção = valendo de verdade. |
| Chave de API |
A credencial de acesso que o Asaas gera para sua conta. É o único campo que o gateway Asaas usa (vai na Chave Principal). |
| 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 Asaas (de Sandbox para testes ou de Produção).
• A Chave de API gerada no painel do Asaas.
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 - Asaas.
2 Em Ambiente, escolha Homologação (Sandbox) para testar ou Produção.
3 Em Chave Principal, cole a Chave de API do Asaas.
Grave e clique em Testar gateway.
Aba Gateway: (1) Integração gateway = Gateway - Asaas, (2) Ambiente, (3) Chave Principal (Chave de API) e o botão Testar gateway.
O botão "Testar gateway"
O botão Testar gateway pede uma autorização ao Asaas usando a sua Chave de API. Se a chave estiver correta, aparece Conectado com sucesso — a integração está homologada.
Deu erro ao testar? Confira a Chave de API (sem espaços) e o Ambiente. A chave de Sandbox 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. |
Pegadinhas frequentes
1. Sandbox não é Produção. A Chave de API de Sandbox do Asaas só funciona no ambiente de testes. Gere e use a chave de Produção ao entrar no ar.
2. É só uma chave. O Asaas usa apenas a Chave de API (Chave Principal). Deixe os demais campos em branco.
3. Chave exata. Cole a Chave de API exatamente como o Asaas gerou, sem espaços no início ou no fim.
4. Guarde a chave com cuidado. A Chave de API dá acesso à sua conta Asaas — trate como uma senha.
Perguntas frequentes
Quem pode configurar a homologação?O operador do financeiro com acesso à Configuração para cobrança.
Onde consigo a Chave de API?No painel do Asaas, em Configurações / Integrações. O Quaza não gera essa chave.
Preciso preencher Chave Secreta ou Token?Não. O Asaas usa apenas a Chave de API, no campo Chave Principal.
O pagamento baixa sozinho?Sim. A tarefa Financeiro - Gateway sincroniza os pagamentos automaticamente.
Posso testar antes de colocar para valer?Sim. Use o ambiente Homologação (Sandbox) com a chave de teste do Asaas.
"Testar gateway" deu erro. O que fazer?Confira a Chave de API e o ambiente. Corrija, grave e teste de novo.
Preciso importar arquivo de retorno?Não. No gateway o pagamento volta confirmado automaticamente.
Troquei a chave. Preciso testar de novo?Sim. Sempre que mudar a Chave de API ou o ambiente, grave e clique em Testar gateway.
A chave de Sandbox serve em Produção?Não. São chaves diferentes; gere a de Produção ao ir para o ar.
Documentos relacionados