# Webhooks

Receba notificações em tempo real quando eventos acontecem na plataforma.

---

## O que são webhooks?

Webhooks são chamadas HTTP que a Kobana faz para sua URL quando determinados eventos acontecem.

---

## Eventos disponíveis

### Cobranças

- `charge.created` - Cobrança criada
- `charge.paid` - Cobrança paga
- `charge.canceled` - Cobrança cancelada
- `charge.expired` - Cobrança expirada
- `charge.refunded` - Cobrança devolvida

### Pagamentos

- `payment.created` - Pagamento criado
- `payment.confirmed` - Pagamento confirmado
- `payment.failed` - Pagamento falhou

### Transferências

- `transfer.created` - Transferência criada
- `transfer.confirmed` - Transferência confirmada

---

## Configuração

### 1. Cadastre sua URL

No dashboard, acesse Configurações > Webhooks e adicione sua URL.

### 2. Selecione os eventos

Escolha quais eventos deseja receber.

### 3. Receba as notificações

Sua URL receberá POSTs com os dados do evento.

---

## Formato do payload

```json
{
  "event": "charge.paid",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "uid": "charge_123",
    "amount": 100.00,
    "paid_at": "2025-01-15T10:29:55Z",
    "payer": {
      "name": "João Silva"
    }
  }
}
```

---

## Validação

Todas as requisições incluem um header `X-Kobana-Signature` para validar a autenticidade.

---

## Retry automático

Se sua URL retornar erro, tentamos novamente:

- 1ª retry: 5 minutos
- 2ª retry: 30 minutos
- 3ª retry: 2 horas
- 4ª retry: 12 horas

---

[Ver documentação completa](https://docs.banking.kobana.com.br/pt/api/overview)