# Nel momento in cui arriva un pagamento.

> Ricevi notifiche push per ogni pagamento Stripe, addebito fallito ed evento di abbonamento. Aggiungi un webhook a Stripe o Paddle e tieni d'occhio vendite e abbandoni dal telefono.

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

Ultimo aggiornamento: 2026-10-25

Pocket Alert trasforma i webhook di Stripe in notifiche push sul tuo telefono. Ogni addebito riuscito, pagamento fallito e disdetta arriva in meno di un secondo, con importo e cliente. Scopri un pagamento fallito prima che il cliente ti scriva.

## Tre passaggi per gli avvisi di pagamento

1. **Crea il webhook** — Crea un webhook Pocket Alert con un template GJSON che mappa il payload di Stripe, poi copia il suo URL di ricezione.
2. **Aggiungi un endpoint Stripe** — Incolla l'URL di ricezione in Stripe come endpoint e iscriviti a charge.succeeded, charge.failed e agli eventi che ti interessano.
3. **Guarda le vendite** — Effettua un pagamento di prova. L'addebito arriva sul tuo telefono con importo ed email del cliente.

## I tuoi ricavi in tempo reale

Ogni vendita, addebito fallito e disdetta raggiunge il tuo telefono non appena il processore attiva il webhook.

- **Funziona con qualsiasi processore** — Aggiungi il tuo URL webhook come endpoint in Stripe, PayPal, Paddle o LemonSqueezy, e le vendite iniziano ad arrivare.
- **Importo e cliente** — Mappa importo, email del cliente e tipo di evento così la notifica sembra una vera vendita.
- **Scegli i tuoi eventi** — Iscriviti solo agli eventi che ti servono: addebiti riusciti, pagamenti falliti e disdette.
- **Intercetta fallimenti e disdette** — Crea un webhook per charge.failed e uno per customer.subscription.deleted, così solleciti e disdette suonano ciascuno sul proprio canale.
- **Ricavi in tempo reale** — Una vendita confermata ti raggiunge subito. Niente dashboard da aggiornare, niente report giornaliero da aspettare.
- **Diretto e sicuro** — Ogni URL webhook è dedicato, resta riservato e passa per HTTPS, quindi puoi puntarci Stripe direttamente.

## Collega Stripe

### 1. Crea un webhook Pocket Alert

Definisci un nome e un template GJSON `message` che mappa i campi del payload di Stripe. Otterrai così il tuo URL di ricezione.

```
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%"}'
```

La risposta contiene uno slug, che dà l'URL di ricezione `https://p4a.me/wh/1234abcd`. Puoi crearlo anche nella pagina [Webhooks](https://pocketalert.app/it/webhooks).

### 2. Incolla l'URL di ricezione in Stripe

Nella Dashboard di Stripe apri Workbench, poi la scheda Webhooks, e fai clic su Create an event destination. Scegli Snapshot come stile del payload, perché i thin event contengono solo l'ID dell'oggetto e lasciano vuoto il template; seleziona eventi come `charge.succeeded`, `charge.failed` e `customer.subscription.deleted` e incolla il tuo URL di ricezione di Pocket Alert come endpoint.

### 3. Mappa i campi

Stripe invia tramite POST il JSON dell'evento al tuo URL di ricezione. Il template viene composto su di esso: `%data.object.amount%` (nell'unità monetaria più piccola, ad es. centesimi), `%data.object.currency%` e `%data.object.billing_details.email%`. Usa `%type%` per etichettare l'evento. La [documentazione](https://info.pocketalert.app/api/webhooks/settings.html) spiega nel dettaglio i percorsi GJSON.

## FAQ

### Come ricevo le notifiche di pagamento?

Crea un webhook in Pocket Alert con un template per il messaggio, poi incolla il suo URL di ricezione in Stripe come endpoint. Ogni evento Stripe (charge.succeeded, charge.failed, customer.subscription.deleted) viene composto con il tuo template e arriva come notifica push.

### Posso mostrare importo e cliente?

Sì. Il tuo template GJSON prende i campi direttamente dal payload di Stripe — %data.object.amount% e %data.object.billing_details.email% — così l'avviso dice "Nuovo pagamento 4900 · alex@acme.com". Gli importi di Stripe sono espressi nell'unità monetaria più piccola (centesimi).

### Posso scegliere quali eventi ricevere?

Iscrivi il tuo endpoint Stripe agli eventi che ti interessano, come charge.succeeded, charge.failed e customer.subscription.deleted. Solo questi eventi vengono inviati via POST al tuo URL di ricezione e arrivano sul telefono.

### Quali provider di pagamento sono supportati?

Funzionano Stripe, PayPal, Paddle, LemonSqueezy, Chargebee e qualsiasi processore che invii webhook. Punta il suo endpoint al tuo URL di ricezione di Pocket Alert e mappa i campi del payload nel template.

### Posso separare i pagamenti falliti dalle vendite?

Sì. Crea un webhook Pocket Alert per ogni tipo di evento — uno per charge.failed, uno per customer.subscription.deleted — e assegna a ciascuno una propria applicazione, così i solleciti e le disdette suonano su un canale distinguibile.

### I pagamenti falliti possono suonare più forte delle vendite ordinarie?

Imposta un livello predefinito per ogni webhook: lascia le vendite ordinarie sul livello default, dai al webhook charge.failed il livello alto così supera la modalità Full immersion su iPhone, e invia le disdette in silenzioso se vuoi solo registrarle. Un livello critico supera perfino Non disturbare su Android — utile quando un pagamento fallito significa che un account di produzione ha appena perso il servizio.
