🔗 Guia Completo de Webhooks - Gateways de Pagamento

Referência rápida para integração de webhooks de cada gateway suportado

---

📋 Índice Rápido

• Visão Geral
• Kirvano
• WitePay
• Yampi
• Vega Checkout
• Luna

---

🎯 Visão Geral

O que são Webhooks?

Webhooks são notificações automáticas que seu gateway de pagamento envia para nossa API sempre que um evento importante acontece (carrinho abandonado, PIX expirado, compra aprovada, etc.).

Como Funciona o Fluxo?

┌─────────────┐         ┌──────────────┐         ┌─────────────────┐
│   Gateway   │ ─────→  │  Wite API    │ ─────→  │  Agente IA      │
│  (Kirvano)  │ webhook │  Normaliza   │ dispara │  Conversa com   │
│             │         │  Dados       │         │  Cliente        │
└─────────────┘         └──────────────┘         └─────────────────┘
      │                                                    │
      │ Cliente abandona carrinho                         │
      └─────────────────────────────────────────────────  │
                                                           │
                                                    Cliente compra ✅

URL Base

Cada agente criado tem uma URL única:

https://api.witerecuperation.com/api/webhooks/{WEBHOOK_URL_DO_AGENTE}

Como obter: Painel → Agentes → Copiar URL de Webhook

---

🛒 Kirvano

Configuração

Painel Kirvano:

1. Acesse Configurações → Webhooks
2. Clique em "Adicionar Webhook"
3. Cole a URL: https://api.witerecuperation.com/api/webhooks/{SUA_URL}
4. Selecione os eventos (veja abaixo)
5. Método: POST
6. Content-Type: application/json
7. Salve

Eventos Suportados

Evento	Quando Dispara	Nossa Ação
CART_ABANDONED	Cliente sai sem finalizar	✅ Inicia recuperação
CHECKOUT_ABANDONED	Cliente sai na página de checkout	✅ Inicia recuperação
PIX_EXPIRED	PIX expira sem pagamento	✅ Recuperação PIX
PAYMENT_PENDING	Aguardando pagamento	⏸️ Monitora
SALE_APPROVED	Pagamento aprovado	✅ Marca como recuperado
SALE_PENDING	Venda pendente	⏸️ Aguarda
SALE_REFUSED	Pagamento recusado	❌ Não recupera
SALE_CHARGEBACK	Chargeback solicitado	❌ Não recupera
SALE_REFUNDED	Reembolso efetuado	❌ Não recupera

---

💳 WitePay

Configuração

Painel WitePay:

1. Acesse Integrações → Webhooks
2. Adicione webhook
3. URL: https://api.witerecuperation.com/api/webhooks/{SUA_URL}
4. Eventos: Selecione conforme tabela abaixo
5. Formato: JSON
6. Salve e teste

Eventos Suportados

Evento	Quando Dispara	Nossa Ação
CART_ABANDONED	Carrinho abandonado	✅ Inicia recuperação
CHECKOUT_ABANDONED	Checkout abandonado	✅ Inicia recuperação
PIX_EXPIRED	PIX expira	✅ Recuperação PIX
PAYMENT_PENDING	Pagamento pendente	⏸️ Monitora
PAYMENT_APPROVED	Pagamento aprovado	✅ Marca recuperado
ORDER_PAID	Pedido pago	✅ Marca recuperado
PAYMENT_REFUSED	Pagamento recusado	❌ Não recupera

---

🛍️ Yampi

Configuração

Painel Yampi:

1. Acesse Configurações → Webhooks
2. Criar novo webhook
3. URL: https://api.witerecuperation.com/api/webhooks/{SUA_URL}
4. Eventos: cart.reminder, order.paid, order.created
5. Salvar

Eventos Suportados

Evento	Quando Dispara	Nossa Ação
cart.reminder	Carrinho abandonado	✅ Inicia recuperação
order.created	Pedido criado	⏸️ Monitora
order.paid	Pedido pago	✅ Marca recuperado
order.status.updated	Status atualizado	📊 Atualiza status

📦 Vega Checkout

Configuração

Entre em contato com suporte da Vega para configurar webhook apontando para:

https://api.witerecuperation.com/api/webhooks/{SUA_URL}

Eventos Suportados

Evento	Quando Dispara	Nossa Ação
CART_ABANDONED	Carrinho abandonado	✅ Inicia recuperação
Status approved	Transação aprovada	✅ Marca recuperado

---

🌙 Luna

Configuração

Configure webhook na Luna apontando para:

https://api.witerecuperation.com/api/webhooks/{SUA_URL}

Eventos Suportados

Evento	Quando Dispara	Nossa Ação
sale_cart_abandoned	Carrinho abandonado	✅ Inicia recuperação
event_sale_pending	Venda pendente	⏸️ Monitora
event_sale_paid	Venda paga	✅ Marca recuperado

---