Sviluppatori · WebhookEventi firmati
Eventi firmati
per ogni pagamento.
Aggiungi un endpoint in Impostazioni → API e webhook, scegli gli eventi e verifica ogni invio con il tuo secret.
14:02payment.succeeded200
14:05subscription.renewed200
14:09dispute.created500 · nuovo tentativo
14:10dispute.created200
Ogni tentativo registrato
SIGNED WITHHMACSHA-256 su ogni invio
EVENT TYPES9pagamenti, contestazioni, abbonamenti
FAILED DELIVERIES↻ritentati e registrati
FirmatoOgni invio porta un header UP-Signature: l’HMAC-SHA256 del timestamp e del body.
RitentatoGli invii non riusciti vengono ritentati e ogni tentativo viene registrato.
I tuoi eventiScegli gli eventi che ti servono, o tutti.
JSONOgni evento ha un id, un tipo, un’ora di creazione e i suoi dati.
| Evento | Quando |
|---|---|
payment.succeeded | Un pagamento è stato approvato |
payment.voided | Un pagamento è stato annullato |
refund.succeeded | Un rimborso è andato a buon fine |
dispute.created | Una nuova contestazione |
dispute.updated | Una contestazione è cambiata |
subscription.created | Un nuovo abbonato |
subscription.renewed | Un rinnovo è stato pagato |
subscription.payment_failed | Un rinnovo non è riuscito |
subscription.cancelled | Un abbonamento è terminato |
UP-Signature: t=1762340000,v1=5f8c…
// Verify: HMAC-SHA256(secret, t + "." + body) == v1Le domande degli esercenti
Come verifico un invio?
Calcola l’HMAC-SHA256 del timestamp e del body con il tuo secret e confrontalo con l’header UP-Signature.
Posso scegliere quali eventi ricevere?
Sì, scegli gli eventi che ti servono o tutti.