> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://mundpay.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como Integrar Qualquer Plataforma via Webhook Genérico

# Como Integrar Qualquer Plataforma via Webhook Genérico

Este guia ensina como utilizar o **Webhook Genérico da Mundpay** para conectar suas vendas em tempo real a qualquer ferramenta externa — como CRMs, plataformas de cursos (LMS), sistemas de automação de WhatsApp, planilhas ou APIs próprias — garantindo a automação total do seu pós-venda.

### 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 ${color}[#87d33c](**"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:
| **Status** | **O que significa?** | **Ação Recomendada no Pós-Venda** |
| `incomplete` | **Carrinho Abandonado:** O cliente iniciou o cadastro, mas não concluiu. | Disparar e-mail ou WhatsApp de recuperação de carrinho. |
| `awaiting_payment` | **Aguardando Pagamento:** Boleto ou Pix gerado, pendente de liquidação. | Enviar lembrete com a chave Copia e Cola ou código de barras. |
| `paid` | **Venda Aprovada:** Pagamento confirmado com sucesso! | Liberar acesso ao produto/serviço e enviar mensagem de boas-vindas. |
| `refused` | **Recusada:** A transação foi negada pelo emissor do cartão/antifraude. | Ofertar outro método de pagamento ou entrar em contato para suporte. |
| `refunded` | **Reembolsada:** O valor da venda foi estornado ao cliente. | Bloquear o acesso ao produto/serviço e cancelar assinaturas. |
| `chargedback` | **Chargeback:** Disputa/contestação de compra aberta pelo comprador. | Suspender acesso e acionar a equipe de defesa contra disputas. |
| `canceled` | **Cancelada:** Pedido cancelado por falta de pagamento ou erro. | Registrar o motivo para análise de conversão. |

### 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](https://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 nossa*[*Documentação Oficial para Desenvolvedores*](https://www.google.com/search?q=https://docs.mundpay.com/api-reference/webhooks/sells)*.*