Webhook Stripe — Pagamentos e Assinaturas
Configure webhooks do Stripe com OpenClaw. Receba alertas de pagamentos, assinaturas e eventos financeiros.
⏱️ 2 min de leitura
Webhook: Stripe
Receba notificações de pagamentos e assinaturas diretamente no seu chat.
O Que Você Recebe
- 💳 Pagamentos - Aprovados, falhos, reembolsados
- 🔄 Assinaturas - Criadas, canceladas, renovadas
- Disputas - Chargebacks e contestações
- 🧾 Invoices - Geradas, pagas, vencidas
- 👥 Clientes - Novos, atualizados
Configuração
1. No Stripe Dashboard
- Acesse dashboard.stripe.com/webhooks
- Clique “Add endpoint”
- URL:
https://seu-servidor.com/webhooks/stripe - Selecione eventos desejados
- Copie o Signing Secret
2. No OpenClaw
# config.yaml
webhooks:
stripe:
enabled: true
signing_secret: "whsec_xxx"
events:
- payment_intent.succeeded
- payment_intent.payment_failed
- customer.subscription.created
- customer.subscription.deleted
- invoice.payment_failed
3. Reiniciar
openclaw gateway restart
Eventos Recomendados
Para E-commerce
payment_intent.succeededpayment_intent.payment_failedcharge.refundedcharge.dispute.created
Para SaaS
customer.subscription.createdcustomer.subscription.updatedcustomer.subscription.deletedinvoice.payment_failedcustomer.subscription.trial_will_end
Exemplos de Alertas
Pagamento Aprovado
PAGAMENTO APROVADO
Cliente: João Silva
Email: joao@email.com
Valor: R$ 297,00
Produto: Plano Pro Anual
Ver no Stripe
Assinatura Cancelada
⚠ ASSINATURA CANCELADA
Cliente: Maria Costa
Plano: Pro Mensal (R$ 49/mês)
MRR perdido: R$ 49
Motivo: Não informado
Considere enviar email de win-back
Ver no Stripe
Pagamento Falhou
🔴 PAGAMENTO FALHOU
Cliente: Pedro Santos
Plano: Enterprise
Valor: R$ 997,00
Erro: Cartão recusado (insufficient_funds)
Tentativas: 1/3
Próxima: Em 3 dias
Ver no Stripe | Contatar cliente
Automações
Notificar Vendas
Quando payment_intent.succeeded:
- Me notifique no Telegram
- Se valor > R$500, notifique também no Slack #vendas
Alerta de Churn
Quando subscription.deleted:
- Me avise imediatamente
- Inclua histórico do cliente
- Sugira ação de win-back
Relatório Diário
Todo dia às 19h:
- Total de vendas do dia
- Novos assinantes
- Cancelamentos
- MRR atual
Cobranças Falhadas
Quando invoice.payment_failed:
- Me avise com dados do cliente
- Após 3 falhas, alerta urgente
Métricas Automáticas
"Quanto faturamos hoje?"
"MRR atual"
"Churn do mês"
"Ticket médio"
Segurança
Validar Assinatura
O OpenClaw valida automaticamente usando o signing_secret.
HTTPS Obrigatório
Webhook deve usar HTTPS em produção.
IP Allowlist (Opcional)
webhooks:
stripe:
ip_allowlist:
- "3.18.12.63"
- "3.130.192.231"
# IPs do Stripe