# No momento em que um pagamento cai.

> Receba alertas push de cada pagamento do Stripe, cobrança com falha e evento de assinatura. Adicione um webhook no Stripe ou no Paddle e acompanhe vendas e churn no celular.

<!-- source: https://pocketalert.app/pt/use-cases/payment-alerts -->

Última atualização: 2026-10-25

O Pocket Alert transforma webhooks do Stripe em notificações push no seu celular. Cada cobrança bem-sucedida, pagamento recusado e cancelamento chega em menos de um segundo, com valor e cliente incluídos. Fique sabendo de um pagamento recusado antes que o seu cliente mande um e-mail.

## Três passos para alertas de pagamento

1. **Crie o webhook** — Crie um webhook do Pocket Alert com um modelo GJSON que mapeie o payload do Stripe e copie a URL de recebimento.
2. **Adicione um endpoint no Stripe** — Cole a URL de recebimento no Stripe como endpoint e assine charge.succeeded, charge.failed e os eventos que você quiser.
3. **Veja as vendas** — Faça um pagamento de teste. A cobrança chega ao seu celular com o valor e o e-mail do cliente.

## Sua receita em tempo real

Cada venda, cobrança recusada e cancelamento chega ao seu celular assim que o processador dispara o webhook.

- **Funciona com qualquer processador** — Adicione a URL do seu webhook como endpoint no Stripe, PayPal, Paddle ou LemonSqueezy, e as vendas começam a chegar.
- **Valor e cliente** — Mapeie o valor, o e-mail do cliente e o tipo de evento para que a notificação pareça uma venda de verdade.
- **Escolha seus eventos** — Assine apenas os eventos que você quer: cobranças bem-sucedidas, pagamentos recusados e cancelamentos.
- **Capture falhas e cancelamentos** — Crie um webhook para charge.failed e outro para customer.subscription.deleted, para que cobranças recusadas e cancelamentos toquem cada um em seu próprio canal.
- **Receita em tempo real** — Uma venda confirmada chega até você na hora. Sem painel para atualizar, sem relatório diário para esperar.
- **Direto e seguro** — Cada URL de webhook é exclusiva, permanece secreta via HTTPS, e por isso você pode apontar o Stripe diretamente para ela.

## Conecte o Stripe

### 1. Crie um webhook do Pocket Alert

Defina um nome e um modelo GJSON `message` que mapeie os campos do payload do Stripe. Isso retorna a sua URL de recebimento.

```
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Stripe Payments","application_id":"qm47b9pzxzxg","message":"Payment %data.object.amount% %data.object.currency% from %data.object.billing_details.email%"}'
```

A resposta contém um slug, que gera a URL de recebimento `https://p4a.me/wh/1234abcd`. Você também pode criá-lo na página de [Webhooks](https://pocketalert.app/pt/webhooks).

### 2. Cole a URL de recebimento no Stripe

No Painel do Stripe, abra o Workbench e depois a aba Webhooks, e clique em Create an event destination. Escolha Snapshot como estilo de payload, já que eventos thin carregam apenas o ID do objeto e deixam o modelo vazio. Em seguida, selecione eventos como `charge.succeeded`, `charge.failed` e `customer.subscription.deleted` e cole a sua URL de recebimento do Pocket Alert como URL do endpoint.

### 3. Mapeie os campos

O Stripe envia o JSON do evento por POST para a sua URL de recebimento. O modelo é renderizado com base nele: `%data.object.amount%` (na menor unidade monetária, por exemplo centavos), `%data.object.currency%` e `%data.object.billing_details.email%`. Use `%type%` para identificar o evento. A [documentação](https://info.pocketalert.app/api/webhooks/settings.html) cobre os caminhos GJSON em detalhes.

## Perguntas frequentes

### Como recebo notificações de pagamento?

Crie um webhook no Pocket Alert com um modelo de mensagem e cole a URL de recebimento no Stripe como endpoint. Cada evento do Stripe (charge.succeeded, charge.failed, customer.subscription.deleted) é renderizado com o seu modelo e chega como notificação push.

### Posso mostrar o valor e o cliente?

Sim. Seu modelo GJSON puxa os campos direto do payload do Stripe — %data.object.amount% e %data.object.billing_details.email% — então o alerta diz "Novo pagamento 4900 · alex@acme.com". Os valores do Stripe vêm na menor unidade monetária (centavos).

### Posso escolher quais eventos receber?

Assine o endpoint do Stripe apenas nos eventos que você quer, como charge.succeeded, charge.failed e customer.subscription.deleted. Somente esses eventos são enviados por POST para a sua URL de recebimento e chegam ao seu celular.

### Quais provedores de pagamento são suportados?

Stripe, PayPal, Paddle, LemonSqueezy, Chargebee e qualquer processador que envie webhooks funcionam. Aponte o endpoint dele para a sua URL de recebimento do Pocket Alert e mapeie os campos do payload no modelo.

### Posso separar pagamentos recusados das vendas?

Sim. Crie um webhook do Pocket Alert por tipo de evento — um para charge.failed, outro para customer.subscription.deleted — e dê a cada um o seu próprio aplicativo, para que cobranças recusadas e cancelamentos toquem em um canal que você consiga distinguir.

### Pagamentos recusados podem tocar mais alto que vendas comuns?

Defina um nível padrão por webhook: deixe as vendas comuns no padrão, dê ao webhook de charge.failed nível alto para que ele atravesse o Foco no iPhone, e envie eventos de cancelamento silenciosos se você só quiser registrá-los. Um nível crítico chega até mesmo ao Não perturbe no Android — útil quando um pagamento recusado significa que uma conta de produção acabou de perder o serviço.
