Integrar com Mercado Pago

Conecte sua conta Mercado Pago ao TrackCombo para rastrear pagamentos aprovados (PIX, cartão e boleto) automaticamente via webhook.

# Requisitos

• Conta Mercado Pago com uma aplicação criada no painel de desenvolvedores
• Container criado no TrackCombo

# Passo a Passo

# 1. Adicione a Integração no TrackCombo

1. Abra seu container no TrackCombo
2. Vá em Integrações
3. Clique em + Nova Integração
4. Selecione Mercado Pago
5. Copie a URL do webhook gerada pelo TrackCombo

# 2. Configure o Access Token no TrackCombo

O Access Token é necessário para que o TrackCombo consulte os dados completos do pagamento no Mercado Pago.

1. Acesse o painel de desenvolvedores do Mercado Pago
2. Clique na aplicação que você usa no seu checkout (ou crie uma nova)
3. No menu lateral, vá em Credenciais de produção
4. Copie o Access Token
5. Volte ao TrackCombo, na integração que você criou
6. Cole no campo Access Token (produção) nas configurações da integração
7. Clique em Salvar

Use sempre a credencial de produção. Credenciais de teste não conseguem ler pagamentos reais.

# 3. Configure o Webhook no Mercado Pago

1. No painel de desenvolvedores, dentro da mesma aplicação, vá em Webhooks
2. Clique em Configurar notificações
3. Selecione a aba Modo produtivo
4. Cole a URL do webhook copiada do TrackCombo no campo de URL
5. Em Eventos, marque apenas Pagamentos
6. Clique em Salvar configuração

# 4. Teste a Integração

1. Faça um pagamento real de teste (pode ser um PIX de valor baixo)
2. No TrackCombo, acesse o container e vá em Logs
3. Verifique se o evento de venda apareceu corretamente após a aprovação do pagamento

# Dados Rastreados

A integração envia automaticamente:

• Nome e email do comprador (quando informados no pagamento)
• Documento do comprador (CPF/CNPJ, armazenado como hash SHA256)
• Telefone (quando informado)
• Valor e moeda da transação
• ID do pagamento e referência externa do pedido
• Método de pagamento (PIX, cartão, boleto)
• Itens do pagamento (quando informados)
• IP do comprador

# Problemas Comuns

Vendas não aparecem no TrackCombo?

• Verifique se o Access Token de produção está configurado corretamente na integração
• Confirme que a URL do webhook foi salva no Modo produtivo (não no modo de teste)
• Verifique se o evento Pagamentos está marcado na configuração do webhook
• Aguarde até 5 minutos para processamento

Erro 401 nos logs?

• O Access Token está inválido, expirado ou é de teste. Copie novamente a credencial de produção
• Verifique se não há espaços extras antes ou depois do token

O pagamento apareceu como pendente e depois sumiu?

• Isso é esperado. Só o pagamento aprovado vira venda no TrackCombo