Passa al contenuto principale

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.

  1. Vai su Impostazioni > App > Applicazioni private e apri (o crea) l'applicazione.
  2. Nella sezione Webhook, card Webhook di organizzazione, clicca Aggiungi webhook.
  3. Scegli gli eventi e inserisci l'URL HTTPS che riceverà le POST.
  4. Clicca Salva.

Dalla card modifichi o elimini i webhook registrati. Valgono per tutta l'organizzazione, qualunque applicazione privata li abbia creati.

Eventi disponibili​

EventoDescrizione
supporter.createdUn nuovo sostenitore è stato creato
supporter.updatedUn sostenitore è stato aggiornato
supporter.deletedUn sostenitore è stato eliminato
checkout.createdUn nuovo checkout è stato aperto
checkout.updatedUn checkout è stato aggiornato
checkout.paidUn checkout è stato completato con pagamento
checkout.closedUn checkout è stato chiuso
donation.createdUna nuova donazione è stata creata
donation.updatedUna donazione è stata aggiornata
donation.deletedUna donazione è stata eliminata
donation.revokedUna donazione è stata revocata: a mano, per il rimborso del suo ultimo pagamento o per il pagamento fallito di una donazione singola
payment.createdUn nuovo pagamento è stato registrato
payment.updatedUn pagamento è stato aggiornato
campaign.createdUna nuova campagna è stata creata
campaign.updatedUna campagna è stata aggiornata
campaign.deletedUna 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 esempio donation.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:

CampoSignificato
processor_feeCommissione 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_amountamount meno processor_fee; null se la commissione non è nota, mai uguale ad amount
import_run_idIdentificativo dell'importazione che ha creato il pagamento
stripe_intent_id, stripe_charge_id, stripe_payment_method_idIdentificativi Stripe del pagamento
paypal_order_id, paypal_capture_id, paypal_sale_idIdentificativi PayPal: ordine e capture per le una tantum, sale per le rate di un abbonamento
satispay_payment_id, satispay_external_codeIdentificativi Satispay
sumup_transaction_code, sumup_merchant_code, sumup_device_serial_number, sumup_transaction_timeDati 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"
}