Como Integrar Qualquer Plataforma via Webhook Genérico

Como Integrar Qualquer Plataforma via Webhook Genérico

1. O que é o Webhook da Mundpay e por que devo usá-lo?

O Webhook é uma ferramenta de notificação instantânea. Sempre que um evento ocorre no seu checkout (como uma venda aprovada, um Pix gerado ou um reembolso), a Mundpay envia automaticamente um "pacote de dados" (payload JSON) para uma URL que você cadastrou.

Por que utilizar? Ele elimina a necessidade de checar o painel manualmente e permite:

• Liberar acesso automático a áreas de membros e cursos.
• Disparar mensagens imediatas no WhatsApp (boas-vindas, cobrança ou recuperação).
• Atualizar dados em plataformas como Zapier, Make, n8n ou CRMs.

1.1. Passo a Passo: Como Configurar o Webhook no Painel Mundpay

1. Acesse o Dashboard: No menu lateral da Mundpay, navegue até a seção de Integrações.
2. Adicione a Integração: Vá até "Webhook Genérico".
3. Clique em "Conectar Integração"
4. Nomeie sua integração
5. Selecione os produtos de onde receberá os eventos
6. Defina a URL de Destino: Cole o endereço da plataforma receptora (ex: link do Webhook gerado pelo Zapier, Make, n8n ou do seu próprio servidor).
7. Selecione os Eventos: Escolha quais etapas da venda deseja monitorar (recomendamos selecionar todos para acompanhar todo o ciclo de vida do cliente).
8. Salve: Clique em Salvar para ativar o envio automático.

2. Qual é a URL de destino (Endpoint) que devo cadastrar?

A URL de destino é o endereço do sistema do seu servidor ou da plataforma que vai receber as notificações da Mundpay (ex: [https://seu-sistema.com/webhook-vendas](https://seu-sistema.com/webhook-vendas) ou o link gerado pelo seu fluxo no Make/Zapier).

3. Tabela de Status das Vendas e Ações Recomendadas

Entenda o significado de cada status enviado no pacote de dados para configurar suas automações de forma eficiente:

4. Como integrar com plataformas No-Code (Zapier, Make, n8n)?

Se você não é desenvolvedor, pode conectar sistemas sem programar uma única linha de código:

1. Na ferramenta No-Code (Make/Zapier): Crie um novo cenário/zap e defina o gatilho inicial como Webhooks (opção Custom Webhook ou Catch Hook).
2. Copie a URL: A plataforma vai gerar um link exclusivo de webhook (ex: [https://hook.us1.make.com/](https://hook.us1.make.com/)...).
3. Cole na Mundpay: Insira essa URL no painel da Mundpay seguindo o passo a passo da Seção 2.
4. Envie um Teste: Realize uma venda de teste no checkout (ou gere um Pix/Boleto) para que a Mundpay envie os dados em tempo real e a ferramenta externa reconheça a estrutura das variáveis.

5. Estrutura Técnica dos Dados (Payload JSON)

Para desenvolvedores que farão o consumo direto da API no backend, as requisições são disparadas via método POST com o cabeçalho Content-Type: application/json.

Exemplo do Payload enviado:

JSON

{
 "event": "paid",
 "data": {
 "transaction_id": "tx_987654321",
 "status": "paid",
 "amount": 19700,
 "currency": "BRL",
 "payment_method": "credit_card",
 "customer": {
 "name": "João da Silva",
 "email": "joao@email.com",
 "document": "12345678900",
 "phone": "+5511999999999"
 },
 "product": {
 "id": "prod_12345",
 "name": "Curso Avançado de Tráfego"
 },
 "tracking": {
 "utm_source": "google",
 "utm_campaign": "campanha_natal",
 "src": "afiliado_01"
 },
 "created_at": "2026-08-12T14:00:00Z"
 }
}

Atenção (Valores Financeiros): O campo amount é sempre enviado em centavos. No exemplo acima, 19700 representa R$ 197,00.

6. Como testar minha integração antes de ir para produção?

Para validar o funcionamento sem afetar seu sistema oficial:

1. Acesse o site gratuito Webhook.site.
2. Copie a Unique URL gerada na página.
3. Cadastre essa URL temporária na Mundpay.
4. Gere um Pix ou finalize um teste no seu checkout.
5. Veja os dados chegando em tempo real no Webhook.site para inspecionar os headers e o corpo da requisição.

7. Validação de Segurança e Boas Práticas (Suporte L2)

• Assinatura de Segurança (HMAC SHA-256): Para assegurar que as requisições foram de fato enviadas pela Mundpay e prevenir ataques de falsificação (spoofing), enviamos a assinatura no cabeçalho X-Mundpay-Signature. Valide esse hash na sua API utilizando a sua chave secreta.
• Resposta Rápida (Status 200): O seu servidor deve responder à Mundpay com um código HTTP 200 dentro de 10 segundos. Recomendamos receber a notificação, responder 200 OK imediatamente e processar fluxos mais pesados (envio de e-mails, consumo de APIs de terceiros) de forma assíncrona.
• Idempotência: Sempre use o campo transaction_id como chave única no seu banco de dados para evitar reprocessamento ou duplicidade de acessos em caso de retentativas automáticas de envio do webhook.

Dúvidas ou consultas avançadas de schema? Acesse a nossaDocumentação Oficial para Desenvolvedores.