Português
Español
English
Resposta direta
Webhook é push, API é pull. Webhook notifica você quando algo acontece; API permite que você consulte a Mundpay quando quiser. Para liberar acesso automático, enviar mensagem ou integrar CRM, webhook basta. Para gerar relatório, buscar cliente ou auditar vendas, use API. A maioria das operações usa os dois juntos.
Qual a diferença prática entre webhook e API?
Webhook é notificação em tempo real que Mundpay envia a você. API é uma biblioteca de dados que você consulta quando precisa.
| Aspecto | Webhook | API |
|---|---|---|
| Direção | Push: Mundpay envia para você | Pull: você pede para Mundpay |
| Latência | Segundos, assim que evento acontece | Sob demanda, quando você faz requisição |
| Volume | Um evento por vez | Consultas de lote ou filtro |
| Uso típico | Liberação de acesso, disparo de mensagem, registro em tempo real | Relatório, auditoria, backup, consulta de cliente |
| Complexidade | Simples, não precisa de servidor robusto | Mais pesada, requer tratamento de erro e paginação |
Na prática: Venda aprova, webhook chega no seu CRM em dois segundos. Customer quer saber quanto gastou, sua página consulta API para puxar histórico de vendas. Webhook faz a coisa acontecer na hora. API fornece a verdade quando alguém quer ouvir. A escolha entre os dois não é "ou um ou outro", é uma arquitetura: webhook para os eventos do agora, API para as dúvidas do depois. Uma operação de qualquer tamanho beneficia de ter ambos funcionando juntos, cada um fazendo o que faz melhor.
Quando o webhook basta?
Quando tudo que você precisa fazer é reagir a um evento que aconteceu agora. Venda aprovada, reembolso, novo cliente, venda recusada, dispute aberta. Para cada um, webhook notifica e seu sistema age.
- Liberação de acesso. Comprador compra, webhook chega, você libera acesso à área de membros ou LMS na hora. Sem webhook, você abre painel manualmente ou espera cronjob rodar à noite.
- Disparo de mensagem. Venda aprovada, webhook dispara boas-vindas por WhatsApp ou email. Venda recusada, webhook dispara oferta de outro método de pagamento. Tudo automático.
- Integração com CRM. Webhook envia dados do cliente (nome, email, valor comprado) para ActiveCampaign, RD Station ou outro CRM na mesma hora. Assim o suporte já vê o cliente novo quando ele chegar com dúvida.
- Rastreamento de pixel. Venda aprovada, webhook dispara evento para o Pixel da Meta ou do Google, confirmando a conversão ao mesmo tempo que acontece.
- Auditoria em tempo real. Webhook registra cada venda, reembolso, dispute em sua planilha ou banco de dados, assim você sempre tem a verdade em um só lugar.
Se o seu fluxo é "venda acontece e reage", webhook é o caminho.
O objetivo do marketing é conhecer e entender o cliente tão bem que o produto sirva a ele e se venda sozinho.
Quando precisa de API e não basta webhook?
Quando você precisa consultar o que já aconteceu ou tirar um relatório sob demanda. Webhook não oferece isso. API oferece.
- Relatório de vendas por período. "Quanto vendi na semana passada? Quantas vendas? Qual foi o CAC médio?" API você consulta e puxa. Webhook não oferece isso porque não notifica eventos passados.
- Consulta de cliente específico. "Quantas vezes esse cliente comprou comigo? Quando foi a última compra? Tem alguma disputa aberta?" API permite buscar por email ou ID. Webhook só notifica eventos novos.
- Auditoria de transaction de um produto. "Liste todas as vendas aprovadas do Produto X entre Jan e Mar." API filtra e retorna a lista. Webhook não guarda histórico.
- Backup e reconciliação. Você puxa todas as transações do mês via API para conferir com sua contabilidade. Webhook não faz isso automaticamente.
- Dashboard customizado. Você quer mostrar ao afiliado quantas comissões ele tem em aberto. API você consulta na hora que ele acessa o dashboard. Webhook não funciona assim.
Se o fluxo é "eu preciso buscar informação", API é o caminho.
Posso usar webhook e API juntos?
Sim, e essa é a combinação mais comum. A maioria das operações robutas usa webhook para eventos em tempo real e API para consulta sob demanda.
Exemplo real: Vendedor usa webhook para liberar acesso automático logo após a compra. Usa API para gerar um relatório de vendas toda segunda-feira, mostrando quanto vendeu no fim de semana. Usa API novamente quando um cliente chega dizendo "não recebi a compra", para consultar se a transação realmente aprovou.
Não é ou/ou. É e/e.
Como escolher na prática?
Comece com webhook. Se você precisa fazer algo automático quando uma venda acontece, webhook resolve. Depois, conforme cresce, adiciona API para relatório e auditoria.
O roadmap típico é:
- Semana 1: Implementar webhook genérico para liberar acesso automático no LMS.
- Semana 4: Adicionar webhook para o CRM (ActiveCampaign ou RD Station).
- Mês 2: Consumir API para gerar relatório semanal de vendas e comissões.
- Mês 3: Usar API para dashboard customizado visível ao afiliado.
Comece simples. Adicione quando a operação pedir.
Onde a Mundpay entra na integração?
Mundpay oferece webhook genérico para conectar sua operação com Make, Zapier, n8n, qualquer plataforma No-Code ou serverless. O webhook funciona enviando os dados do checkout (venda aprovada, Pix gerado, reembolso) para a URL que você configurar. Confira na Central de Ajuda da Mundpay como integrar qualquer plataforma via webhook genérico para ver todos os eventos disponíveis e o formato dos dados enviados.
Sobre API: uma API, em geral, serve para consultar dados sob demanda, como relatórios de período, histórico de um cliente, verificação de transação. Se você precisa desse tipo de funcionalidade na Mundpay, consulte a Central de Ajuda para saber o que a plataforma disponibiliza e como implementar.
Fontes consultadas
- Documentação de webhook genérico para checkout de pagamento: baseado em prática comprovada de integração entre gateway e operações de infoproduto.
Em resumo: Webhook ou API para integrar checkout
- Webhook é notificação em tempo real, API é consulta sob demanda.
- Webhook basta para liberar acesso, enviar mensagem, atualizar CRM, rastrear pixel.
- API é necessária para relatório, auditoria, dashboard, consulta de cliente.
- Mundpay oferece webhook genérico que funciona com Make, Zapier, n8n e qualquer plataforma No-Code.
- Comece com webhook. Se precisar de API, verifique na Central de Ajuda o que está disponível.
Perguntas frequentes
Qual a diferença prática entre webhook e API?
Webhook é push: Mundpay envia. API é pull: você pede. Webhook notifica quando algo acontece, API consulta informações quando você quer. Para liberação automática de acesso ou disparo de mensagem, webhook é mais rápido. Para relatório ou auditoria de vendas antigas, API é melhor.
Quando webhook basta e não precisa de API?
Quando você só precisa saber que uma venda aconteceu e reagir na hora. Liberar acesso, enviar email de boas-vindas, disparar WhatsApp, atualizar CRM com dados do cliente. Tudo isso webhook consegue fazer. Não precisa consultar o Mundpay novamente.
Quando preciso de API e não basta webhook?
Quando você precisa buscar informação sob demanda. Relatório de vendas por período, consulta de cliente específico, auditoria de transações, listagem de chargeback de um produto. Webhook não faz isso. API permite ler dados sempre que precisa.
Posso usar webhook e API juntos?
Sim. A maioria das operações usa webhook para eventos em tempo real (venda aprovada, reembolso) e API para consultas de demanda (gerar relatório, buscar cliente). Cada uma faz o que é melhor.
Como testar que minha integração está pronta?
Para webhook: faça uma compra de teste e veja se o evento chega na URL de destino em menos de dez segundos. Use Webhook.site se estiver testando. Para API: use o Postman ou curl para fazer uma requisição GET à API, verifique se a resposta chega com dados esperados e HTTP 200.
