Organization Webhooks
Riseact calls your endpoint when something happens in an organization: a supporter created, a checkout paid and so on.
Organization webhooks receive only the events of one organization. For a partner app that needs the events of every organization that installed it, use the application webhooks.
Setting up a webhook
They are managed on the detail page of a private application; access to application management is enough.
- Go to Settings > Apps > Private applications and open (or create) the application.
- In the Webhook section, Organization webhooks card, click Add webhook.
- Choose the events and enter the HTTPS URL that will receive the
POSTcalls. - Click Save.
From the card you can edit or delete the registered webhooks. They apply to the whole organization, whichever private application created them.
Available events
| Event | Description |
|---|---|
supporter.created | A new supporter has been created |
supporter.updated | A supporter has been updated |
supporter.deleted | A supporter has been deleted |
checkout.created | A new checkout has been opened |
checkout.updated | A checkout has been updated |
checkout.paid | A checkout has been completed with payment |
checkout.closed | A checkout has been closed |
donation.created | A new donation has been created |
donation.updated | A donation has been updated |
donation.deleted | A donation has been deleted |
donation.revoked | A donation has been revoked: by hand, by the refund of its last payment, or by the failed payment of a one-off donation |
payment.created | A new payment has been recorded |
payment.updated | A payment has been updated |
campaign.created | A new campaign has been created |
campaign.updated | A campaign has been updated |
campaign.deleted | A campaign has been deleted |
Delivery of the calls
Riseact sends a JSON POST to the registered URL. The payload contains:
organization: the domain of the organization;event: the topic, for exampledonation.created;object: the object of the event;idempotency_key: identifier of the call. The same key can arrive more than once: use it to deduplicate.
The timeout is 10 seconds: respond immediately with 2xx and do heavy work asynchronously.
If the answer is not 2xx, or does not arrive within the timeout, Riseact retries the delivery after 1 minute, 10 minutes, 1 hour, 6 hours and 24 hours, with the same payload and the same idempotency_key. A retried call may therefore arrive after newer events for the same object: compare update_date with the one you stored and drop outdated payloads.
Webhooks an app registers through the API, with its own token, are signed with the app's client secret, in the same format as application webhooks. Webhooks created from the admin are not signed: to verify their origin, use a secret path or a token in the query string of the URL.
If the private app has a URL set it also gets the uninstall call.
Request details
Supporter webhooks
{
"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"
}
Checkout webhooks
{
"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"
}
Payment webhooks
payment.created arrives when the payment is recorded, payment.updated on every later change: refund, PayPal fee recorded after the collection, manual edit, merge of the supporter with a duplicate. The object includes the full donation and supporter.
Fields of the payment itself, besides state, amount and dates:
| Field | Meaning |
|---|---|
processor_fee | Fee withheld by the processor, as the processor reports it. Filled in only for Stripe and PayPal from 2026-10-31; null on earlier payments, for Satispay, SumUp and manual payments. The Riseact fee is not included: it is invoiced separately |
net_amount | amount minus processor_fee; null if the fee is not known, never equal to amount |
import_run_id | Identifier of the import that created the payment |
stripe_intent_id, stripe_charge_id, stripe_payment_method_id | Stripe identifiers of the payment |
paypal_order_id, paypal_capture_id, paypal_sale_id | PayPal identifiers: order and capture for one-off donations, sale for the installments of a subscription |
satispay_payment_id, satispay_external_code | Satispay identifiers |
sumup_transaction_code, sumup_merchant_code, sumup_device_serial_number, sumup_transaction_time | SumUp data, only for payments reconciled from a SumUp report |
They are the same data as the payment ... columns of the payments export, where each one is detailed.
{
"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"
}
Donation webhooks
{
"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"
}