Central de Ajuda Quaza Provedores

Homologação Mercado Pago (Gateway) (PT)

Homologação Mercado Pago (Gateway) — Quaza

Como conectar o Quaza à API do Mercado Pago e validar a integração — o que chamamos de homologar.

Nesta wiki:

O que é o gateway Mercado Pago

O gateway Mercado Pago liga o Quaza diretamente à API do Mercado Pago. Com ele, as cobranças são geradas pela internet e o pagamento volta confirmado automaticamente.

Homologar é validar suas credenciais (Client ID e Client Secret) com o Mercado Pago: você informa as duas, clica em Testar gateway e o Quaza confirma a conexão.

Gateway não é o mesmo que Remessa/Retorno. No gateway tudo acontece pela internet, em tempo real. Veja a diferença em Diferença entre Gateway (API) e Remessa/Retorno .

Como funciona a homologação

Você configura as credenciais, o Quaza pede autorização ao Mercado Pago 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 Mercado Pago. No Quaza, é o botão Testar gateway.
Ambiente	Homologação = ambiente de testes; Produção = valendo de verdade.
Client ID	O identificador da sua aplicação no Mercado Pago. Vai no campo Chave Principal.
Client Secret	A chave secreta da sua aplicação no Mercado Pago. Vai no campo Chave Secreta.
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 Mercado Pago com uma aplicação criada no painel de desenvolvedores.
• O Client ID e o Client Secret dessa aplicação.

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 - Mercado Pago.

2 Em Ambiente, escolha Homologação para testar ou Produção.

3 Em Chave Principal, cole o Client ID.

4 Em Chave Secreta, cole o Client Secret.

Grave e clique em Testar gateway.

Aba Gateway com o Mercado Pago selecionado

Aba Gateway: (1) Integração gateway = Gateway - Mercado Pago, (2) Ambiente, (3) Chave Principal (Client ID), (4) Chave Secreta (Client Secret) e o botão Testar gateway.

O botão "Testar gateway"

O botão Testar gateway pede uma autorização ao Mercado Pago usando o Client ID e o Client Secret. Se as credenciais estiverem corretas, aparece Conectado com sucesso — a integração está homologada.

Deu erro ao testar? Confira o Client ID e o Client Secret (copiados da sua aplicação no Mercado Pago) e o Ambiente. Credenciais de teste não funcionam em Produção.

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. Homologação não é Produção. As credenciais de teste do Mercado Pago só valem no ambiente de testes. Troque pelas de Produção ao entrar no ar.

2. São duas credenciais. O Mercado Pago exige Client ID (Chave Principal) e Client Secret (Chave Secreta).

3. Use as credenciais da aplicação certa. Cada aplicação do Mercado Pago tem suas próprias credenciais; use as da aplicação ligada à sua conta de cobrança.

4. Credenciais exatas. Cole o Client ID e o Client Secret exatamente como aparecem no painel, sem espaços.

Perguntas frequentes

Quem pode configurar a homologação?

O operador do financeiro com acesso à Configuração para cobrança.

Onde consigo o Client ID e o Client Secret?

No painel de desenvolvedores do Mercado Pago, nas credenciais da sua aplicação. 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 o Client ID e o Client Secret e o ambiente. Corrija, grave e teste de novo.

Preciso importar arquivo de retorno?

Não. No gateway o pagamento volta confirmado automaticamente.

Em quanto tempo o pagamento aparece?

Na próxima execução da tarefa de sincronização, dentro da janela "Verificação das cobranças".

Qual a diferença para Remessa/Retorno?

O gateway é via API, em tempo real; a remessa/retorno troca arquivos. Veja Diferença entre Gateway (API) e Remessa/Retorno .

Troquei as credenciais. Preciso testar de novo?

Sim. Sempre que mudar o Client ID, o Client Secret ou o ambiente, grave e clique em Testar gateway.

As credenciais de teste servem em Produção?

Não. São diferentes; troque-as ao ir para Produção.