Webhook di Organizzazione
Riseact chiama il tuo endpoint quando in un'organizzazione succede qualcosa: un sostenitore creato, un checkout pagato e così via.
I webhook di organizzazione ricevono solo gli eventi di un'organizzazione. Per una partner app che deve ricevere gli eventi di tutte le organizzazioni che l'hanno installata, usa i webhook di applicazione.
Impostare un webhook
Si gestiscono nel dettaglio di un'applicazione privata; basta l'accesso alla gestione delle applicazioni.
- Vai su Impostazioni > App > Applicazioni private e apri (o crea) l'applicazione.
- Nella sezione Webhook, card Webhook di organizzazione, clicca Aggiungi webhook.
- Scegli gli eventi e inserisci l'URL HTTPS che riceverà le
POST. - Clicca Salva.
Dalla card modifichi o elimini i webhook registrati. Valgono per tutta l'organizzazione, qualunque applicazione privata li abbia creati.
Eventi disponibili
| Evento | Descrizione |
|---|---|
supporter.created | Un nuovo sostenitore è stato creato |
supporter.updated | Un sostenitore è stato aggiornato |
supporter.deleted | Un sostenitore è stato eliminato |
checkout.created | Un nuovo checkout è stato aperto |
checkout.updated | Un checkout è stato aggiornato |
checkout.paid | Un checkout è stato completato con pagamento |
checkout.closed | Un checkout è stato chiuso |
donation.created | Una nuova donazione è stata creata |
donation.updated | Una donazione è stata aggiornata |
donation.deleted | Una donazione è stata eliminata |
donation.revoked | Una donazione è stata revocata: a mano, per il rimborso del suo ultimo pagamento o per il pagamento fallito di una donazione singola |
payment.created | Un nuovo pagamento è stato registrato |
payment.updated | Un pagamento è stato aggiornato |
campaign.created | Una nuova campagna è stata creata |
campaign.updated | Una campagna è stata aggiornata |
campaign.deleted | Una campagna è stata eliminata |
Consegna delle chiamate
Riseact invia una POST JSON all'URL registrato. Il payload contiene:
organization: il dominio dell'organizzazione;event: il topic, per esempiodonation.created;object: l'oggetto dell'evento;idempotency_key: identificativo della chiamata. La stessa chiave può arrivare più volte: usala per deduplicare.
Il timeout è di 10 secondi: rispondi subito con 2xx e fai il lavoro pesante in modo asincrono.
Se la risposta non è 2xx, o non arriva entro il timeout, Riseact ritenta la consegna dopo 1 minuto, 10 minuti, 1 ora, 6 ore e 24 ore, con lo stesso payload e la stessa idempotency_key. Un tentativo ripetuto può quindi arrivare dopo eventi più recenti dello stesso oggetto: confronta update_date con quello che hai salvato e scarta i payload superati.
I webhook che un'app registra tramite API, con il proprio token, sono firmati con il client secret dell'app, nello stesso formato dei webhook di applicazione. Quelli creati dall'admin non sono firmati: per verificarne la provenienza usa un percorso segreto o un token in query string nell'URL.
Se l'app privata ha un URL impostato riceve anche la chiamata di disinstallazione.
Dettagli richiesta
Webhooks di sostenitore
{
"organization": "your-org-domain",
"object": {
"id": 75835,
"create_date": "2023-08-17T16:10:45.354192+00:00",
"update_date": "2023-08-17T16:10:45.367332+00:00",
"image": "",
"business_name": null,
"first_name": "first name",
"last_name": "last name",
"supporter_type": "INDIVIDUAL",
"email": "test@email.com",
"phone": "phone",
"mobile": "mobile",
"sex": "MALE",
"date_of_birth": "1970-01-01",
"place_of_birth": "Place of birth",
"ssn": "ssn",
"vat": "vat",
"address": "address",
"address2": "secondary address",
"city": "city",
"locality": "locality",
"country": "IT",
"postal_code": "code",
"certification_url": null,
"privacy": false,
"email_marketing": false,
"phone_marketing": false,
"sms_marketing": false,
"postal_marketing": false,
"profilation_marketing": false,
"note": "notes",
"tags": [],
"external_ref": null,
"source_campaign": null,
"organization": 33,
"application": 1,
"stripe_customer_id": null
},
"event": "supporter.created",
"idempotency_key": "b1e0c9a2-4f3d-4e2a-9c1b-6a7f8d0e2c34"
}
Webhooks di checkout
{
"organization": "your-org-domain",
"object": {
"id": 901,
"create_date": "2023-08-17T16:15:52.746141+00:00",
"update_date": "2023-08-17T16:15:52.746165+00:00",
"state": "OPEN",
"amount": 10,
"completed_date": null,
"donation": null,
"supporter": 75835,
"frequency": null,
"peer_campaign": null
},
"event": "checkout.created",
"idempotency_key": "b1e0c9a2-4f3d-4e2a-9c1b-6a7f8d0e2c34"
}
Webhooks di pagamento
payment.created arriva quando il pagamento viene registrato, payment.updated a ogni modifica successiva: rimborso, commissione PayPal registrata dopo l'incasso, modifica manuale, unione del sostenitore con un duplicato. L'oggetto contiene la donazione e il sostenitore completi.
Campi propri del pagamento, oltre a stato, importo e date:
| Campo | Significato |
|---|---|
processor_fee | Commissione trattenuta dal processore, come la riporta il processore. Valorizzata solo per Stripe e PayPal dal 31/10/2026; null sui pagamenti precedenti, per Satispay, SumUp e i pagamenti manuali. La commissione Riseact non è inclusa: è fatturata a parte |
net_amount | amount meno processor_fee; null se la commissione non è nota, mai uguale ad amount |
import_run_id | Identificativo dell'importazione che ha creato il pagamento |
stripe_intent_id, stripe_charge_id, stripe_payment_method_id | Identificativi Stripe del pagamento |
paypal_order_id, paypal_capture_id, paypal_sale_id | Identificativi PayPal: ordine e capture per le una tantum, sale per le rate di un abbonamento |
satispay_payment_id, satispay_external_code | Identificativi Satispay |
sumup_transaction_code, sumup_merchant_code, sumup_device_serial_number, sumup_transaction_time | Dati SumUp, solo per i pagamenti riconciliati da un report SumUp |
Sono gli stessi dati delle colonne payment ... dell'esportazione pagamenti, dove trovi il dettaglio di ciascuno.
{
"organization": "your-org-domain",
"object": {
"id": 48213,
"create_date": "2026-11-18T09:14:05.112340+00:00",
"update_date": "2026-11-18T09:14:05.112352+00:00",
"state": "PAID",
"amount": 25.0,
"payment_date": "2026-11-18T09:14:02.000000+00:00",
"payment_method_id": 12,
"payment_method_label": "Carta di credito",
"payment_method_processor": "stripe",
"donation": {
"id": 30455,
"create_date": "2026-11-18T09:13:40.512100+00:00",
"update_date": "2026-11-18T09:14:05.201200+00:00",
"code": "#30455",
"is_deleted": false,
"state": "active",
"amount": 25.0,
"frequency": 12,
"completed_date": "2026-11-18T09:14:05.201000+00:00",
"campaign": 29,
"peer_campaign": null,
"cost_example": null,
"cost_example_quantity": null,
"supporter": 9071,
"tags": [],
"payment_method_id": 12,
"payment_method_label": "Carta di credito",
"payment_method_processor": "stripe"
},
"supporter": {
"id": 9071,
"code": "",
"job": null,
"sex": null,
"ssn": "RSSMRA80A01H501U",
"vat": null,
"city": "Roma",
"note": null,
"email": "mario.rossi@example.com",
"phone": null,
"title": null,
"mobile": null,
"address": "Via Roma 1",
"country": "IT",
"address2": null,
"locality": "RM",
"last_name": "Rossi",
"first_name": "Mario",
"create_date": "2026-11-18T09:13:40.401000+00:00",
"postal_code": "00100",
"update_date": "2026-11-18T09:13:40.401000+00:00",
"external_ref": null,
"business_name": null,
"date_of_birth": null,
"place_of_birth": null,
"supporter_type": "INDIVIDUAL",
"source_campaign_id": 29,
"certification_url": null,
"stripe_customer_id": "cus_Q1a2b3",
"image": null,
"tags": [],
"privacy": true,
"sms_marketing": null,
"email_marketing": true,
"phone_marketing": null,
"postal_marketing": null,
"profilation_marketing": null,
"privacy_values": {}
},
"frequency": 12,
"stripe_intent_id": "pi_3QXa1b2c3d",
"peer_campaign": null,
"processor_fee": 0.6,
"net_amount": 24.4,
"import_run_id": null,
"stripe_charge_id": "ch_3QXa1b2c3d",
"stripe_payment_method_id": "pm_1QXa1b2c3d",
"paypal_order_id": null,
"paypal_capture_id": null,
"paypal_sale_id": null,
"satispay_payment_id": null,
"satispay_external_code": null,
"sumup_transaction_code": null,
"sumup_merchant_code": null,
"sumup_device_serial_number": null,
"sumup_transaction_time": null
},
"event": "payment.created",
"idempotency_key": "b1e0c9a2-4f3d-4e2a-9c1b-6a7f8d0e2c34"
}
Webhooks di donazione
{
"organization": "your-org-domain",
"object": {
"id": 229,
"create_date": "2023-08-17T16:27:04.542168+00:00",
"update_date": "2023-08-17T16:27:04.542168+00:00",
"code": "#1000",
"state": "pending",
"amount": 10,
"frequency": 0,
"completed_date": null,
"campaign": 29,
"peer_campaign": null,
"supporter": 75835,
"tags": [],
"payment_method": "MANUAL"
},
"event": "donation.created",
"idempotency_key": "b1e0c9a2-4f3d-4e2a-9c1b-6a7f8d0e2c34"
}