---
title: "Webhook Stripe — Pagamentos e Assinaturas"
url: "https://openclaw.ia.br/webhooks/stripe/"
markdown_url: "https://openclaw.ia.br/webhooks/stripe.MD"
description: "Configure webhooks do Stripe com OpenClaw. Receba alertas de pagamentos, assinaturas e eventos financeiros."
date: ""
author: ""
---

# Webhook Stripe — Pagamentos e Assinaturas

Configure webhooks do Stripe com OpenClaw. Receba alertas de pagamentos, assinaturas e eventos financeiros.


# 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

1. Acesse [dashboard.stripe.com/webhooks](https://dashboard.stripe.com/webhooks)
2. Clique "Add endpoint"
3. URL: `https://seu-servidor.com/webhooks/stripe`
4. Selecione eventos desejados
5. Copie o Signing Secret

### 2. No OpenClaw

```yaml
# 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

```bash
openclaw gateway restart
```

## Eventos Recomendados

### Para E-commerce
- `payment_intent.succeeded`
- `payment_intent.payment_failed`
- `charge.refunded`
- `charge.dispute.created`

### Para SaaS
- `customer.subscription.created`
- `customer.subscription.updated`
- `customer.subscription.deleted`
- `invoice.payment_failed`
- `customer.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)

```yaml
webhooks:
  stripe:
    ip_allowlist:
      - "3.18.12.63"
      - "3.130.192.231"
      # IPs do Stripe
```

## Próximos Passos

- [Integração Stripe completa](/integracoes/stripe/)
- [Receitas de e-commerce](/receitas/ecommerce/)
- [Monitoramento de negócio](/casos-uso/empreendedor/)