Riseact – API & Developer Guide Guide Integrarsi con Riseact Riseact offre 2 modi per integrarsi con la piattaforma: tramite applicazioni private o applicazioni partner. Le applicazioni private possono essere installate solo dalla stessa organizzazione che le crea, mentre le applicazioni partner possono essere installate da una o più organizzazioni Riseact. In entrambi i casi, è necessario autenticarsi e ottenere un token di accesso per utilizzare le API di Riseact e accedere ai dati della tua organizzazione. In questa guida, esploreremo cosa sono e quali sono i casi d'uso per le applicazioni private e partner. Applicazioni partner Le applicazioni partner possono essere installate da una o più organizzazioni Riseact. Le applicazioni partner possono richiedere l'accesso a risorse e dati delle organizzazioni che le installano. Le applicazioni Partner richiedono un processo di approvazione da parte di Riseact per garantire che rispettino le linee guida e le politiche della piattaforma, devono essere accessibili tramite un URL pubblico per poter garantire l'autenticazione tramite OAuth 2. Segui le indicazioni riportate in questa guida per integrarti con Riseact tramite applicazione partner. Applicazioni private Le applicazioni private possono essere installate dalla sola organizzazione che la crea. Le applicazioni private possono richiedere l'accesso a risorse e dati della sola organizzazione che le installa, e utilizzano un sistema di autenticazione a token per accedere ai servizi di Riseact. Segui le indicazioni riportate in questa guida per integrarti con Riseact tramite applicazione privata. Contenuto importato da https://dev.riseact.org/docs/getting-started il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Entità di Riseact Riseact dispone di diverse entità che consentono di gestire le iniziative di raccolta fondi delle organizzazioni non profit. In questa guida, esploreremo le diverse entità di Riseact e come funzionano. Campagne : Le campagne sono le iniziative o progetti specifici all'interno di Riseact. Ogni campagna può essere associata a un form e pubblicata su diversi canali. Per ulteriori dettagli su come funzionano le campagne, puoi consultare la Guida alle Campagne su Riseact . Progetti : I progetti sono aggregazioni di campagne correlate. Consentono di organizzare le iniziative e le campagne in modo strutturato. Per una guida più dettagliata sui progetti, puoi consultare la Guida ai Progetti su Riseact . Forms : I forms rappresentano la configurazione con cui viene generato un checkout per una campagna specifica. Puoi personalizzare i campi e le opzioni di donazione nel form. Per una guida approfondita sui forms, puoi consultare la Guida ai Forms su Riseact . Checkouts : I checkouts sono le pagine in cui i sostenitori possono effettuare donazioni per le campagne. Puoi monitorare lo stato dei checkouts e gestire i pagamenti associati. Per maggiori informazioni sui checkouts, puoi consultare la Guida ai Checkouts su Riseact . Canali : I canali rappresentano le diverse piattaforme o applicazioni su cui puoi pubblicare le campagne. Puoi selezionare i canali desiderati per raggiungere il pubblico appropriato. Per una guida completa sui canali, puoi consultare la Guida ai Canali di Pubblicazione su Riseact . Donazioni : Le donazioni rappresentano i contributi dei sostenitori all'organizzazione non profit. Puoi gestire le donazioni, distinguendo tra oneoff (unica) e ricorrenti (periodiche). Per una guida dettagliata sulle donazioni, puoi consultare la Guida alle Donazioni su Riseact . Pagamenti : I pagamenti sono le transazioni effettive associate alle donazioni. Puoi registrare i pagamenti e associarli alle donazioni corrispondenti. Per una guida completa sui pagamenti, puoi consultare la Guida ai Pagamenti su Riseact . Contenuto importato da https://dev.riseact.org/docs/guides/entities il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Campagne, progetti, forms e checkout Campagne Le campagne sono entità che rappresentano iniziative specifiche. Ogni campagna può essere associata ad un solo form e pubblicata su diversi canali. È possibile configurare l'immagine, il titolo, la descrizione e i metadati per la SEO di ogni campagna. Inoltre, è possibile impostare un obiettivo di raccolta fondi per la campagna che verrà mostrato sulla pagina della campagna e aggiornato automaticamente alla chiusura di ogni checkout. Progetti I progetti sono aggregazioni di campagne correlate. Consentono di organizzare le iniziative e le relative campagne in modo strutturato. Ogni progetto può includere più campagne. Forms I forms sono set di configurazioni per la generazione dei checkouts delle le campagne. Un form definisce le informazioni richieste durante il processo di donazione, come nome, indirizzo e altre informazioni. Ogni campagna può essere associata a un form specifico. Per maggiori informazioni sui forms, consulta la guida Forms . Checkouts I checkouts sono pagine generate dalla configurazione di form e campagna in cui i sostenitori possono effettuare donazioni che verranno associate ad una campagna. I checkouts possono avere diversi stati, come bozza, attivo, scaduto, completato o revocato. Le donazioni vengono registrate solo se lo stato del checkout è attivo o completato. I dati del checkout diventano effettivi quando lo stato è completato, e i sostenitori vengono registrati nel sistema solo se non erano già presenti. Per maggiori informazioni sui checkouts, consulta la guida Checkouts . Contenuto importato da https://dev.riseact.org/docs/guides/campaings-and-forms il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Forms e checkouts Riseact offre funzionalità avanzate per la gestione dei form e dei checkouts, semplificando il processo di fundraising per le organizzazioni. In questa guida, esploreremo come funzionano i form e i checkouts su Riseact. Form Un form rappresenta la configurazione con cui viene generato un checkout. Ogni form può essere associato a più campagne, consentendo di utilizzare la stessa configurazione di checkout per diverse iniziative di raccolta fondi. Ogni campagna, a sua volta, può essere associata a un solo form, garantendo una corrispondenza diretta tra campagna e configurazione di checkout. Durante la configurazione del form, puoi prendere decisioni importanti come quali campi mostrare al sostenitore e quali di essi devono essere obbligatori. Inoltre, puoi specificare il tipo di donazione (oneoff o ricorrente) e definire gli importi consentiti, inclusa la possibilità di inserire un importo personalizzato. Checkout Il checkout rappresenta la pagina in cui i sostenitori possono effettuare le donazioni. Esso viene generato prendendo informazioni sia dal form che dalla campagna associata. Durante il processo di donazione, il checkout può essere in uno stato "aperto" o "chiuso". Quando un checkout viene completato, avvengono diverse operazioni significative. Viene creata una donazione, che può essere di tipo "oneoff" o "ricorrente", associata alla campagna corrispondente. Viene generato un pagamento, ad esempio tramite carta di credito, se la transazione è immediata. Se il sostenitore non è già registrato nel sistema, viene creato un nuovo profilo di sostenitore. In caso contrario, il pagamento viene associato a un sostenitore esistente. Infine, lo stato del checkout viene aggiornato a "chiuso" e l'importo totale della campagna viene visualizzato sulla relativa pagina, se presente, permettendo di monitorare il progresso verso l'obiettivo di raccolta fondi. L'utilizzo dei form e dei checkouts su Riseact consente di creare un'esperienza di donazione personalizzata e intuitiva per i sostenitori. Gestendo le configurazioni dei form e monitorando gli stati dei checkouts, è possibile tenere traccia delle donazioni ricevute e visualizzare l'importo totale raggiunto per ciascuna campagna. Contenuto importato da https://dev.riseact.org/docs/guides/forms-and-checkouts il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Donazioni e pagamenti Su Riseact esistono 2 entita' per la gestione della raccolta fondi, le donazioni e i pagamenti. Ogni pagamento è associato ad una donazione e corrisponde all'effettiva transazione di denaro dal sostenitore all'ente. le donazioni posso essere di 2 tipi: oneoff, e ricorrenti le donazioni oneoff possono essere bozze (promesse), scadute (abbandonate) o completate. In caso di completate il pagamento è associato alla donazione. le donazioni ricorrenti possono essere bozze (promesse), attive o revocate. In caso di ricorrenti attive, i pagamenti verranno associati alla donazione ad ogni transazione, che ricorrerà ogni mese nel giorno di attivazione della donazione. I pagamenti sono creati in automatico (in caso di utilizzo di gateway di pagamento esterni, come Stripe o Paypal) o manualmente (in caso di utilizzo di bonifici bancari o altri metodi di pagamento non automatizzati), e possono essere creati sul pannello di amministrazione o tramite APIs. Riseact offre due entità principali per la gestione della raccolta fondi delle organizzazioni non profit: le donazioni e i pagamenti. In questa guida, esploreremo come funzionano le donazioni e i pagamenti su Riseact. Donazioni Le donazioni rappresentano le promesse o i contributi dei sostenitori all'organizzazione. Le donazioni possono essere di due tipi: Donazioni Oneoff : Le donazioni oneoff sono contributi unici o singoli. Possono trovarsi in uno dei seguenti stati: Bozza : Le donazioni oneoff possono essere create come bozze, rappresentando una promessa di donazione. In questo stato, la donazione non è ancora completata o associata a un pagamento. Scaduta : Se una donazione oneoff viene abbandonata o non completata entro un certo periodo di tempo, assume lo stato di "scaduta". In questo caso, la donazione non viene associata a un pagamento. Completata : Quando una donazione oneoff viene effettivamente completata, viene associata a un pagamento corrispondente. Questo rappresenta l'effettiva transazione di denaro dal sostenitore all'organizzazione non profit. Donazioni Ricorrenti : Le donazioni ricorrenti rappresentano contributi periodici che si ripetono nel tempo. Possono essere in uno dei seguenti stati: Bozza : Le donazioni ricorrenti possono essere create come bozze, indicando una promessa di donazione periodica. In questo stato, la donazione non è ancora attiva o associata a un pagamento. Attiva : Quando una donazione ricorrente è attiva, i pagamenti verranno associati ad essa ad ogni transazione periodica. Questi pagamenti si ripeteranno ogni mese nel giorno di attivazione della donazione. Revocata : Se una donazione ricorrente viene revocata o annullata, assume lo stato di "revocata". In questo caso, i pagamenti futuri non saranno più associati alla donazione. Pagamenti I pagamenti su Riseact rappresentano le transazioni effettive di denaro associato a una donazione. I pagamenti possono essere associati a una donazione specifica e rappresentano l'effettiva transazione di denaro dal sostenitore all'organizzazione. Questi possono essere creati automaticamente utilizzando gateway di pagamento esterni come Stripe o Paypal. In questo caso, il pagamento viene creato automaticamente al momento della transazione. In alternativa, i pagamenti possono essere creati manualmente se vengono utilizzati metodi di pagamento non automatizzati, come bonifici bancari o altri mezzi. In questo caso, l'amministratore può creare manualmente il pagamento nel pannello di amministrazione di Riseact o tramite APIs. Riseact offre un'interfaccia intuitiva per gestire le donazioni e i pagamenti. Grazie alla registrazione e all'associazione dei pagamenti alle donazioni, è possibile tenere traccia delle transazioni finanziarie e monitorare il flusso di denaro delle donazioni all'interno dell'organizzazione. Contenuto importato da https://dev.riseact.org/docs/guides/donations-and-payments il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Canali di pubblicazione I canali di pubblicazione rappresentano le diverse piattaforme o applicazioni su cui è possibile pubblicare le campagne. Ogni campagna può essere pubblicata su uno o più canali, consentendo una maggiore visibilità e la possibilità di raggiungere diversi tipi di pubblico. Riseact offre alcuni canali di pubblicazione predefiniti, che sono: Sito Web : Il sito web dell'organizzazione è uno dei canali principali di pubblicazione. Le campagne possono essere visualizzate sul sito web, consentendo ai visitatori di effettuare donazioni direttamente dalla pagina della campagna. Totem : Riseact Kiosk è un'applicazione che funge da totem o chiosco per la raccolta fondi. Le campagne possono essere pubblicate sul Totem, consentendo alle persone di effettuare donazioni tramite l'app Riseact Kiosk. Point of Donation (POD) : Riseact POD è un'applicazione mobile che consente alle organizzazioni di raccogliere donazioni direttamente in punti fisici, come eventi o fiere. Le campagne possono essere pubblicate su Riseact POD, offrendo un modo facile per i partecipanti effettuare donazioni. Oltre ai canali predefiniti, è possibile installare applicazioni esterne che fungono da canali di pubblicazione aggiuntivi. Ogni volta che viene installata un'applicazione esterna, questa verrà visualizzata come un canale di pubblicazione su Riseact. È possibile selezionare se pubblicare una campagna su quella specifica applicazione e raggiungere un pubblico più ampio. Utilizzo dei Canali di Pubblicazione Per pubblicare una campagna su un determinato canale, è sufficiente selezionare il canale desiderato durante la configurazione della campagna. Questo consente di scegliere dove la campagna sarà visibile e accessibile al pubblico. Puoi selezionare uno o più canali di pubblicazione per ogni campagna, garantendo una maggiore visibilità e la possibilità di raggiungere diversi tipi di pubblico. Con l'utilizzo dei canali di pubblicazione su Riseact, puoi promuovere le tue campagne attraverso diverse piattaforme e raggiungere un pubblico più ampio. Questo aumenta le possibilità di coinvolgere sostenitori e ricevere donazioni per le tue iniziative di raccolta fondi. Contenuto importato da https://dev.riseact.org/docs/guides/channels il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Applicazioni private Creare un'applicazione privata Per utilizzare le API di Riseact e accedere ai dati della tua organizzazione, è necessario autenticarsi e ottenere un token di accesso. Il token di accesso è un codice univoco che ti permette di accedere ai servizi di Riseact in modo sicuro e controllato. I token di Riseact possono essere configurati per fornire diversi livelli di accesso e autorizzazioni, in base alle tue esigenze. In questa guida, esploreremo come ottenere un token di accesso per utilizzare le API di Riseact. Richiesta del token Accedi alla tua organizzazione Riseact, vai alla sezione "Applicazioni", clicca su "Applicazioni private" e poi su "Nuova applicazione privata". Inserisci un nome per la tua applicazione, seleziona i permessi che vuoi fornire ad essa e clicca su "Crea". Una volta creata l'applicazione, verrà generato un token di accesso univoco per la tua organizzazione. Contenuto importato da https://dev.riseact.org/docs/private-apps/getting-started il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Utilizzo delle APIs (private apps) Riseact offre 2 modi per consumare le APIs: tramite GraphQL o REST . Per utilizzare le APIs GraphQL, puoi inviare una richiesta HTTP POST al server GraphQL di Riseact, specificando il token di accesso come header di autorizzazione. Authorization: Bearer Contenuto importato da https://dev.riseact.org/docs/private-apps/api-usage il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Applicazioni partner Creare un account partner Per poter pubblicare le tue applicazioni e temi per le organizzazioni presenti su Riseact, è necessario creare un account Partner. Segui i passaggi di seguito per creare il tuo account Partner: Visita il sito web di Riseact e accedi alla pagina di registrazione tramite il seguente link: https://accounts.riseact.org/signup/ . Una volta sulla pagina di registrazione, nella parte superiore destra della pagina, troverai l'icona del tuo avatar. Fai clic sull'icona per aprire il menu a tendina. All'interno del menu a tendina, individua l'opzione "Diventa un partner" e selezionala. Verrà visualizzata una schermata in cui dovrai inserire il nome del tuo profilo partner. Assicurati di scegliere un nome appropriato e rappresentativo. Dopo aver inserito il nome del profilo partner, fai clic su "Attiva il profilo" per completare il processo di creazione dell'account Partner. Una volta completati questi passaggi, avrai creato con successo il tuo account Partner su Riseact. Ora sarai in grado di pubblicare le tue applicazioni e temi per le organizzazioni presenti sulla piattaforma. Assicurati di seguire le linee guida e i requisiti specifici forniti da Riseact per garantire la conformità e la qualità delle tue pubblicazioni. Contenuto importato da https://dev.riseact.org/docs/partner-apps/getting-started il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Creare un'applicazione partner Per poter interagire con le APIs di Riseact è necessario creare un applicazione. Segui i passaggi descritti in questa pagina per crearne una. Accedi al tuo account Riseact Partner su Riseact. Una volta effettuato l'accesso, troverai un menu laterale. Seleziona "Applicazioni" per accedere alla sezione delle applicazioni. Clicca su "Crea applicazione" per iniziare la creazione della tua nuova applicazione. Ora dovrai inserire alcune informazioni di base sull'applicazione: Nome : Scegli un nome significativo per la tua applicazione. Descrizione : Fornisci una breve descrizione dell'applicazione per spiegare di cosa si tratta. Tipo di distribuzione : Seleziona "public" se desideri che l'applicazione sia disponibile per tutte le organizzazioni. Se preferisci che l'applicazione sia disponibile solo per organizzazioni selezionate, scegli "private". Logo : Puoi scegliere di caricare un logo per l'applicazione. Questo passaggio è facoltativo. URL dell'applicazione : Inserisci l'URL del sito web che verrà incorporato nell'admin di Riseact. Homepage : Inserisci l'URL della homepage del sito di dettaglio dell'applicazione. Assicurati di fornire informazioni dettagliate sull'applicazione per coinvolgere gli utenti. Questo URL verrà mostrato solo nella pagina dell'applicazione nello store. Redirect URL per OAuth : Questo è l'URL di reindirizzamento per il protocollo OAuth. Di solito è qualcosa come " https://url-della-tua-app.it/oauth/callback" . Assicurati di inserire l'URL corretto per consentire l'autenticazione tramite OAuth. Una volta completati tutti i campi richiesti, fai clic su "Salva" per salvare le modifiche e creare l'applicazione. Seguendo questi passaggi, ti verranno forniti un client_id e client_secret che potrai utilizzare per ottenere un Access Token attraverso il processo di OAuth. Per ulteriori informazioni, consulta la prossima pagina Autenticazione con OAuth . Una volta creata l'applicazione, potrai iniziare a sviluppare e distribuire l'applicazione su Riseact. Per semplicità, ti consigliamo di utilizzare la CLI di Riseact per creare e distribuire l'applicazione. Per maggiori informazioni, consulta la pagina Panoramica della CLI . Contenuto importato da https://dev.riseact.org/docs/partner-apps/create-application il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Autenticazione con OAuth L'implementazione dell'autenticazione OAuth è essenziale per ottenere un Access Token e poter utilizzare le API. Segui i passaggi di questa guida per comprendere il processo di OAuth e integrarlo correttamente nella tua applicazione. Comprendi il concetto di OAuth : OAuth è un protocollo standard che consente di delegare l'autenticazione di un utente a un servizio terzo in modo sicuro. Il processo coinvolge tre attori principali: il client (la tua applicazione), il server di autorizzazione (Riseact Account) e il server di risorse (Riseact Core, che fornisce accesso alle APIs). OAuth garantisce che il client ottenga un Access Token valido per accedere alle risorse protette dal server a nome dell'organizzazione che installa l'applicazione. Registra la tua applicazione : Prima di implementare l'autenticazione OAuth, è necessario registrare la tua applicazione su Riseact Parnters per ottenere le credenziali necessarie. Queste credenziali includono un Client ID e un Client Secret, che verranno utilizzati per identificare e autenticare la tua applicazione durante il processo di autorizzazione. Configura l'autenticazione nel tuo backend : Nel tuo backend, dovrai implementare la logica per gestire il flusso di autorizzazione OAuth. Ciò comporta la creazione di un endpoint per l'autorizzazione che reindirizzerà l'utente al server di autorizzazione per l'autenticazione. Durante questa fase, dovrai includere il tuo Client ID e generare le chiavi PKCE che verranno utilizzate per scambiare il codice di autorizzazione nella callback e che quindi dovrai temporaneamente salvare. Quando un organizzazione installerà la tua applicazione su Riseact, dal pannello di amministrazione verrà visualizzato un iframe che punta all'url dell'app che hai indicato in fase di registrazione. Insieme all'url che hai fornito, verrà passato un parametro __organization che potrai utilizzare per identificare l'organizzazione che sta utilizzando la tua applicazione e saltare il roundtrip di selezione dell'organizzazione su Riseact Admin. Per farlo, dovrai reindirizzare l'utente al server di autorizzazione con un parametro __organization che contiene lo slug dell'organizzazione che hai ricevuto dal parametro __organization dell'url di reindirizzamento. Ecco un esempio in node.js: app . get ( '/oauth/authorize' , ( req , res ) => { const { codeChallenge , codeVerifier } = generatePkceKeys ( ) ; // Salva le chiavi PKCE come preferisci. In questo caso utilizziamo un database db . savePkceKey ( codeChallenge , codeVerifier ) ; const params = { client_id : "CLIENT_ID" , redirect_uri : 'https://your-app.com/oauth/callback' , response_type : 'code' , code_challenge_method : 'S256' , code_challenge : 'YOUR_CODE_CHALLENGE' , __organization : req . query . __organization , } ; res . redirect ( ` https://accounts.riseact.org/oauth/authorize/? ${ qs . stringify ( params ) } ` ) ; } ) ; Esempio della chiamata con curl: curl -X GET \ "https://accounts.riseact.org/oauth/authorize/\ ?client_id=CLIENT_ID\ &redirect_uri=https://your-app.com/oauth/callback\ &response_type=code\ &code_challenge_method=S256\ &code_challenge=YOUR_CODE_CHALLENGE\ &__organization=YOUR_ORGANIZATION" Gestisci il reindirizzamento di callback : Dopo che l'utente si è autenticato con successo presso il server di autorizzazione, verrà reindirizzato alla tua applicazione tramite un URL di callback specificato nel precedente passaggio. Nel caso l'URL non corrispondesse a uno di quelli autorizzati in fase di registrazione la richiesta fallirà. Il tuo backend dovrà gestire questo reindirizzamento e recuperare il codice di autorizzazione restituito dal Riseact Accounts. Verifica l'autenticità della richiesta controllando che il codice di autorizzazione corrisponda a quello generato in precedenza. Utilizzando il codice di autorizzazione ricevuto, effettua una richiesta al server di autorizzazione per ottenere un Access Token. Questo Access Token sarà utilizzato per autenticare le successive richieste alle API protette. Ecco un esempio in node.js: app . get ( '/oauth/callback' , async ( req , res ) => { const { code , state } = req . query ; if ( state !== 'YOUR_CODE_CHALLENGE' ) { return res . status ( 400 ) . send ( 'Invalid state' ) ; } // Recupera le chiavi PKCE dal database const { codeChallenge , codeVerifier } = await db . getPkceKey ( state ) ; const formData = { client_id : CLIENT_ID , client_secret : CLIENT_SECRET , grant_type : 'authorization_code' , code , redirect_uri : 'https://your-app.com/oauth/callback' , code_verifier : codeVerifier , } ; const { data } = await axios . post ( 'https://accounts.riseact.org/oauth/token/' , qs . stringify ( formData ) , { headers : { 'Content-Type' : 'application/x-www-form-urlencoded' , } , } ) ; // Salva le credenziali ottenute come preferisci. In questo caso utilizziamo un database db . saveCredentials ( data . access_token , data . refresh_token , data . expires_in ) ; } ) ; Esempio della chiamata con curl: curl -X POST \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "client_id=YOUR_CLIENT_ID" \ -d "client_secret=YOUR_CLIENT_SECRET" \ -d "grant_type=authorization_code" \ -d "code=YOUR_CODE" \ -d "redirect_uri=https://your-app.com/oauth/callback" \ -d "code_verifier=YOUR_CODE_VERIFIER" \ https://accounts.riseact.org/oauth/token/ Utilizza l'Access Token per accedere alle risorse protette dell'organizzazione : Ogni volta che desideri accedere alle risorse protette dalle API, dovrai includere l'Access Token nella tua richiesta nell'header Authorization . Le API utilizzeranno l'Access Token per verificare l'autenticità della richiesta e fornire le risorse richieste solo se l'Access Token è valido. Ecco un esempio in node.js: const { data } = await axios . get ( 'https://core.riseact.org/admin/graphql/' , { headers : { Authorization : ` Bearer ${ access_token } ` , } , } ) ; Esempio della chiamata con curl: curl -X GET \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ https://core.riseact.org/admin/graphql/ Gestisci il rinnovo dell'Access Token : Gli Access Token hanno una durata limitata. Per garantire un'esperienza utente senza interruzioni, dovrai implementare la logica per rinnovare automaticamente l'Access Token prima che scada. Ciò può essere fatto utilizzando il processo di aggiornamento dell'Access Token fornito dal server di autorizzazione. Ecco un esempio in node.js: app . get ( '/oauth/refresh' , async ( req , res ) => { const { refresh_token } = req . query ; const formData = { client_id : CLIENT_ID , client_secret : CLIENT_SECRET , grant_type : 'refresh_token' , refresh_token , } ; const { data } = await axios . post ( 'https://accounts.riseact.org/oauth/token/' , qs . stringify ( formData ) , { headers : { 'Content-Type' : 'application/x-www-form-urlencoded' , } , } ) ; // Salva le credenziali ottenute come preferisci. In questo caso utilizziamo un database db . saveCredentials ( data . access_token , data . refresh_token , data . expires_in ) ; } ) ; Esempio della chiamata con curl: curl -X POST \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "client_id=YOUR_CLIENT_ID" \ -d "client_secret=YOUR_CLIENT_SECRET" \ -d "grant_type=refresh_token" \ -d "refresh_token=YOUR_REFRESH_TOKEN" \ https://accounts.riseact.org/oauth/token/ Implementando correttamente l'autenticazione OAuth nella tua applicazione, sarai in grado di ottenere un Access Token valido e accedere alle risorse protette tramite le API. Assicurati di seguire le specifiche e le documentazioni fornite da Riseact per un'implementazione corretta e sicura. Buona implementazione! Contenuto importato da https://dev.riseact.org/docs/partner-apps/oauth-authentication il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Utilizzo delle APIs (partner apps) Riseact offre 2 modi per consumare le APIs: tramite GraphQL o REST . Per utilizzare le APIs GraphQL, puoi inviare una richiesta HTTP POST al server GraphQL di Riseact, specificando il token di accesso come header di autorizzazione. Authorization: Bearer Contenuto importato da https://dev.riseact.org/docs/partner-apps/api-usage il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Interfaccia utente dell'applicazione Le applicazioni di Riseact vengono renderizzate all'interno di un iframe incorporato nel portale di amministrazione nella pagina della tua applicazione. Se vuoi fornire una interfaccia dell'applicazione ai tuoi utenti, puoi farlo servendola all'url che hai fornito in fase di registrazione dell'applicazione. Tieni presente che l'autenticazione tra il tuo frontend e il backend della tua app non è gestita da Riseact e dovrai implementarla tu stesso. Un sistema valido è sicuro potrebbe essere quelle di utilizzare un token JWT per autenticare le richieste al tuo backend. Ricorda che se il tuo backend necessita di accedere alle APIs di Riseact in momenti in cui non è presente un utente loggato (es per sincronizzazioni o invio email) dovrai salvare i token di autenticazione per OAuth in modo accessibile al backend (es in un database). Contenuto importato da https://dev.riseact.org/docs/partner-apps/application-frontend il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Webhook di Applicazione I webhook di applicazione sono webhook che vengono chiamati da Riseact quando si verificano determinati eventi in tutte le organizzazioni che che hanno installato l'applicazione. A differenza dei webhook di organizzazione, questi vengono registrati una sola volta (per esempio alla creazione dell'applicazione) e i riferimenti all'organizzazione saranno inclusi nel payload della chiamata. Per aggiungere un webhook di applicazione, devi registrare l'URL del webhook e selezionare gli eventi che vuoi ricevere dalla pagina impostazioni dell'applicazione sul portale Riseact Partner. Contenuto importato da https://dev.riseact.org/docs/partner-apps/application-webhooks il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Webhook di Organizzazione I webhook di organizzazione sono webhook che vengono chiamati da Riseact quando si verificano determinati eventi in una organizzazione. Per aggiungere un webhook di organizzazione, devi registrare l'URL del webhook e selezionare gli eventi che vuoi ricevere con la chiamata al relativo endpoint o mutation. Dettagli richiesta Di seguito alcuni esempio di richiesta lanciata da Riseact verso il tuo webhook. 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" : "SupporterType.INDIVIDUAL" , "email" : "test@email.com" , "phone" : "phone" , "mobile" : "mobile" , "sex" : "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 , "note" : "notes" , "tags" : [ ] , "external_ref" : null , "source_campaign" : null , "organization" : 33 , "application" : 1 , "stripe_customer_id" : null } , "event" : "supporter.created" } 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" } Webhooks di pagamento { "organization" : "your-org-domain" , "object" : { "id" : 230 , "create_date" : "2023-08-17T16:27:04.647182+00:00" , "update_date" : "2023-08-17T16:27:04.647204+00:00" , "state" : "PAID" , "amount" : 10 , "payment_date" : "2023-08-17T16:26:59.889000+00:00" , "payment_method" : "MANUAL" , "donation" : 229 , "supporter" : 75835 , "frequency" : 0 , "peer_campaign" : null } , "event" : "payment.created" } 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" } Contenuto importato da https://dev.riseact.org/docs/partner-apps/organization-webhooks il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Pubblicazione Una volta completata e testata la tua applicazione, puoi pubblicarla su Riseact im modo che sia a disposizione di tutti gli utenti. Per pubblicare la tua applicazione, devi andare alla pagina impostazioni della tua app e modificare la distribuzione dell'app da Privata a Pubblica. Contenuto importato da https://dev.riseact.org/docs/partner-apps/publishing il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. API - GraphQL Utilizzo delle API GraphQL Riseact fornisce un set di APIs GraphQL per consentire agli sviluppatori di interagire con le risorse di Riseact. Queste APIs sono disponibili per tutti gli sviluppatori che hanno creato un'applicazione su Riseact. Per poter utilizzare le APIs GraphQL di Riseact, è necessario ottenere un Access Token attraverso i processi descritti in questa pagina . Una volta ottenuto un token, puoi utilizzare le APIs GraphQL per interagire con le risorse di Riseact. Per ulteriori informazioni, consulta la pagina Risorse di Riseact e la pagina di references delle API GraphQL . Esempio di utilizzo curl 'https://core.riseact.org/admin/graphql/' \ -H 'authorization: Bearer ' \ --data-raw '{"query":"query Organization {\n organization {\n name\n domain\n }\n}","variables":{},"operationName":"Organization"}' Contenuto importato da https://dev.riseact.org/docs/apis/graphql-api-usage il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. GraphQL - Queries activities Type: ActivityConnection! Arguments Name Description pagination PaginationInput filters ActivityFilters activity Type: Activity! Arguments Name Description id Int! article Type: Article! Arguments Name Description id Int! articles Type: ArticleConnection! Arguments Name Description pagination PaginationInput filters ArticlesFiltersInput blog Type: Blog! Arguments Name Description id Int! blogs Type: BlogConnection! Arguments Name Description pagination PaginationInput filters BlogsFiltersInput campaign Type: Campaign! Arguments Name Description id Int! campaignComment Type: CampaignComment! Arguments Name Description id Int! campaignComments Type: CampaignCommentConnection! Arguments Name Description pagination PaginationInput filters CampaignCommentsFilters campaigns Type: CampaignConnection! Arguments Name Description pagination PaginationInput filters CampaignFilters campaignTags Type: StrConnection! Arguments Name Description pagination PaginationInput q String checkout Type: Checkout! Arguments Name Description token String! checkouts Type: CheckoutConnection! Arguments Name Description pagination PaginationInput filters CheckoutFilters checkoutsAbandoned Type: CheckoutConnection! Arguments Name Description pagination PaginationInput filters CheckoutFilters checkoutsAdminGenerated Type: CheckoutConnection! Arguments Name Description pagination PaginationInput filters CheckoutFilters customfieldDefinition Type: CustomFieldDefinition! Arguments Name Description id Int! customfieldDefinitions Type: [CustomFieldDefinition!]! Arguments Name Description pagination PaginationInput filters CustomFieldFilters donation Type: Donation! Arguments Name Description id Int! donations Type: DonationConnection! Arguments Name Description pagination PaginationInput filters DonationFiltersInput donationTags Type: StrConnection! Arguments Name Description pagination PaginationInput q String manualPaymentMethod Type: PaymentMethod! Arguments Name Description id Int! manualPaymentMethods Type: [PaymentMethod!]! media Type: MediaConnection! Arguments Name Description pagination PaginationInput mediaSingle Type: Media! Arguments Name Description id Int! menu Type: Menu! Arguments Name Description id Int! menuByHandle Type: Menu! Arguments Name Description handle String! menus Type: [Menu!]! organization Type: Organization! organizations Type: [Organization!]! Arguments Name Description filters OrganizationsFilters owner Type: Staff! page Type: Page! Arguments Name Description id Int! pages Type: PageConnection! Arguments Name Description pagination PaginationInput filters PagesFiltersInput payment Type: Payment! Arguments Name Description id Int! paymentMethods Type: [PaymentMethod!]! payments Type: PaymentConnection! Arguments Name Description pagination PaginationInput filters PaymentFiltersInput peerCampaign Type: PeerCampaign! Arguments Name Description id Int! peerCampaigns Type: PeerCampaignConnection! Arguments Name Description pagination PaginationInput filters PeerCampaignFilters privacyDefinition Type: PrivacyDefinition! Arguments Name Description id Int! privacyDefinitions Type: PrivacyDefinitionConnection! Arguments Name Description pagination PaginationInput filters PrivacyDefinitionFilters project Type: Project! Arguments Name Description id Int! projects Type: ProjectConnection! Arguments Name Description pagination PaginationInput filters ProjectFilters redirect Type: Redirect! Arguments Name Description id Int! redirects Type: RedirectConnection! Arguments Name Description pagination PaginationInput filters RedirectsFiltersInput segment Type: Segment! Arguments Name Description id Int! segments Type: SegmentConnection! Arguments Name Description pagination PaginationInput filters SegmentFiltersInput stripe Type: StripeAccount stripeCustomerCards Type: [StripeCard!]! Arguments Name Description stripeCustomerId String! sumupAccount Type: SumUpAccount supporter Type: Supporter! Arguments Name Description id Int! supporters Type: SupporterConnection! Arguments Name Description pagination PaginationInput filters SupporterFiltersInput supporterTags Type: StrConnection! Arguments Name Description pagination PaginationInput q String terminal Type: StripeTerminal! Arguments Name Description id String! terminalLocation Type: StripeTerminalLocation! Arguments Name Description id String! terminalLocations Type: [StripeTerminalLocation!]! Arguments Name Description filters TerminalLocationFilters terminals Type: [StripeTerminal!]! terminalsByLocation Type: [StripeTerminal!]! Arguments Name Description locationId String! Contenuto importato da https://dev.riseact.org/docs/graphql-references/queries il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. GraphQL - Mutations activityCreate Type: ActivityResponse! Arguments Name Description data ActivityCreateInput! activityDelete Type: ActivityResponse! Arguments Name Description id Int! activityDone Type: ActivityResponse! Arguments Name Description id Int! activityUndone Type: ActivityResponse! Arguments Name Description id Int! activityUpdate Type: ActivityResponse! Arguments Name Description id Int! data ActivityUpdateInput! articlesCreate Type: ArticlesResponse! Arguments Name Description data ArticleInput! articlesDelete Type: ArticlesResponse! Arguments Name Description id Int! articlesUpdate Type: ArticlesResponse! Arguments Name Description id Int! data ArticleInput! blogsCreate Type: BlogsResponse! Arguments Name Description data BlogInput! blogsDelete Type: BlogsResponse! Arguments Name Description id Int! blogsUpdate Type: BlogsResponse! Arguments Name Description id Int! data BlogInput! campaignCommentCreate Type: CampaignCommentResponse! Arguments Name Description data CampaignCommentCreateInput! campaignCommentDelete Type: CampaignCommentResponse! Arguments Name Description id Int! campaignCommentUpdate Type: CampaignCommentResponse! Arguments Name Description id Int! data CampaignCommentUpdateInput! campaignCreate Type: CampaignResponse! Arguments Name Description data CampaignInput! campaignDelete Type: CampaignResponse! Arguments Name Description id Int! campaignDuplicate Type: CampaignResponse! Arguments Name Description id Int! campaignUpdate Type: CampaignResponse! Arguments Name Description id Int! data CampaignInput! checkoutComplete Type: CheckoutResponse! Arguments Name Description token String! data CheckoutCompleteInput! checkoutCreate Type: CheckoutResponse! Arguments Name Description data CheckoutInput! checkoutRegisterPayment Type: CheckoutResponse! Arguments Name Description token String! data CheckoutPaymentInput! checkoutSendRecoveryEmail Type: CheckoutResponse! Arguments Name Description token String! checkoutUpdate Type: CheckoutResponse! Arguments Name Description token String! data CheckoutInput! customfieldDefinitionCreate Type: CustomFieldDefinitionResponse! Arguments Name Description data CustomFieldDefinitionCreateInput! customfieldDefinitionDelete Type: CustomFieldDefinitionResponse! Arguments Name Description id Int! customfieldDefinitionUpdate Type: CustomFieldDefinitionResponse! Arguments Name Description id Int! data CustomFieldDefinitionUpdateInput! donationDelete Type: Donation! Arguments Name Description id Int! donationExport Type: String! Arguments Name Description format ExportFormat! domain DonationDomain! donationImport Type: Task! Arguments Name Description file Upload! createMissingCampaigns Boolean! createMissingPaymentMethod Boolean! importAnonymousPayments Boolean! fallbackCampaignId Int donationReceiptSend Type: Boolean! Arguments Name Description id Int! donationRegisterPayment Type: DonationResponse! Arguments Name Description id Int! data DonationPaymentInput! donationRevoke Type: Donation! Arguments Name Description id Int! donationUpdate Type: Donation! Arguments Name Description id Int! data DonationInput! manualPaymentMethodCreate Type: PaymentMethodResponse! Arguments Name Description data ManualPaymentMethodInput! manualPaymentMethodDelete Type: PaymentMethodResponse! Arguments Name Description id Int! manualPaymentMethodUpdate Type: PaymentMethodResponse! Arguments Name Description id Int! data ManualPaymentMethodInput! mediaCreate Type: Media! Arguments Name Description file Upload! mediaDelete Type: MediaResponse! Arguments Name Description id Int! menuCreate Type: MenuResponse! Arguments Name Description data MenuInput! menuDelete Type: MenuResponse! Arguments Name Description id Int! menuUpdate Type: MenuResponse! Arguments Name Description id Int! data MenuInput! organizationUpdate Type: OrganizationResponse! Arguments Name Description data OrganizationInput! organizationUpdateLegalData Type: OrganizationResponse! Arguments Name Description data OrganizationLegalInput! pagesCreate Type: PagesResponse! Arguments Name Description data PageInput! pagesDelete Type: PagesResponse! Arguments Name Description id Int! pagesUpdate Type: PagesResponse! Arguments Name Description id Int! data PageInput! paymentExport Type: String! Arguments Name Description format ExportFormat! domain PaymentDomain! paymentRefund Type: PaymentResponse! Arguments Name Description id Int! paymentUpdate Type: PaymentResponse! Arguments Name Description id Int! data ManualPaymentInput! peerCampaignCreate Type: PeerCampaignResponse! Arguments Name Description data PeerCampaignInput! peerCampaignDelete Type: PeerCampaignResponse! Arguments Name Description id Int! peerCampaignUpdate Type: PeerCampaignResponse! Arguments Name Description id Int! data PeerCampaignInput! privacyDefinitionCreate Type: PrivacyDefinitionResponse! Arguments Name Description data PrivacyDefinitionCreateInput! privacyDefinitionDelete Type: PrivacyDefinitionResponse! Arguments Name Description id Int! privacyDefinitionUpdate Type: PrivacyDefinitionResponse! Arguments Name Description id Int! data PrivacyDefinitionUpdateInput! projectCreate Type: ProjectResponse! Arguments Name Description data ProjectInput! projectDelete Type: ProjectResponse! Arguments Name Description id Int! projectRemoveItem Type: ProjectResponse! Arguments Name Description id Int! campaignId Int! projectUpdate Type: ProjectResponse! Arguments Name Description id Int! data ProjectInput! projectUpdateItems Type: ProjectResponse! Arguments Name Description id Int! campaignIds [Int!]! redirectsCreate Type: RedirectResponse! Arguments Name Description data RedirectInput! redirectsDelete Type: RedirectResponse! Arguments Name Description id Int! redirectsUpdate Type: RedirectResponse! Arguments Name Description id Int! data RedirectInput! satispayPaymentCreate Type: SatispayPaymentResponse! Arguments Name Description checkoutToken String! segmentCreate Type: SegmentResponse! Arguments Name Description data SegmentInput! segmentDelete Type: SegmentResponse! Arguments Name Description id Int! segmentUpdate Type: SegmentResponse! Arguments Name Description id Int! data SegmentInput! stripeActivate Type: StripeAccount! stripeCheckoutIntentCreate Type: StripeCheckoutResponse! Arguments Name Description checkoutToken String! paymentTypes StripePaymentTypeInput! stripeGenerateDashboardLink Type: StripeLink! stripeGenerateOnboardingLink Type: StripeLink! stripeTerminalCheckoutIntentCreate Type: StripeCheckoutResponse! Arguments Name Description checkoutToken String! sumupAccountCreate Type: SumUpAccount! Arguments Name Description data SumUpAccountInput! sumupAccountUpdate Type: SumUpAccount! Arguments Name Description data SumUpAccountInput! supporterBulkTags Type: Boolean! Arguments Name Description action SupporterBulkTagAction! filters SupporterFiltersInput! tags [String!]! supporterCreate Type: Supporter! Arguments Name Description data SupporterInput! supporterDelete Type: Supporter! Arguments Name Description id Int! supporterExport Type: String! Arguments Name Description format ExportFormat! domain SupporterDomain! supporterImport Type: Task! Arguments Name Description file Upload! overrideSupporters Boolean! supporterMerge Type: Supporter! Arguments Name Description masterId Int! duplicatesIds [Int!]! data SupporterInput! supporterRemovePrivacy Type: SupporterResponse! Arguments Name Description id Int! code String! supporterSendTaxCertificate Type: Supporter! Arguments Name Description id Int! method NotificationMethods! supporterSetPrivacy Type: SupporterResponse! Arguments Name Description id Int! data SupporterPrivacyInput! supporterUpdate Type: Supporter! Arguments Name Description id Int! data SupporterInput! terminalConnectionTokenCreate Type: String! Arguments Name Description locationId String terminalDelete Type: String! Arguments Name Description id String! terminalLocationCreate Type: StripeTerminalLocation! Arguments Name Description data TerminalLocationInput! terminalLocationDelete Type: Void Arguments Name Description id String! terminalLocationUpdate Type: StripeTerminalLocation! Arguments Name Description id String! data TerminalLocationInput! terminalRegister Type: StripeTerminal! Arguments Name Description data TerminalRegisterInput! terminalUpdateLabel Type: StripeTerminal! Arguments Name Description id String! label String! Contenuto importato da https://dev.riseact.org/docs/graphql-references/mutations il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. GraphQL - Objects AccessToken Fields Name Description token String! Activity Fields Name Description id Int! createDate DateTime! updateDate DateTime! category ActivityCategory! deadlineDate Date doneDate Date note String staff ActivityStaff! ActivityConnection Fields Name Description pageInfo PageInfo! edges [ActivityEdge!]! ActivityEdge Fields Name Description cursor String! node Activity! ActivityResponse Fields Name Description userErrors [UserError!] activity Activity ActivityStaff Fields Name Description id Int! name String! email String! Application Fields Name Description id Int! name String! description String logoUrl String type ApplicationType! appUrl String installUrl String authorName String authorHomepageUrl String authorEmail String isEmbedded Boolean! permissions [StaffPermission!]! clientId String! clientSecret String! partner String accessToken AccessToken! isInstalled Boolean! AppMutation Fields Name Description articlesCreate ArticlesResponse! Arguments Name Description data ArticleInput! articlesUpdate ArticlesResponse! Arguments Name Description id Int! data ArticleInput! articlesDelete ArticlesResponse! Arguments Name Description id Int! activityCreate ActivityResponse! Arguments Name Description data ActivityCreateInput! activityDone ActivityResponse! Arguments Name Description id Int! activityUndone ActivityResponse! Arguments Name Description id Int! activityUpdate ActivityResponse! Arguments Name Description id Int! data ActivityUpdateInput! activityDelete ActivityResponse! Arguments Name Description id Int! blogsCreate BlogsResponse! Arguments Name Description data BlogInput! blogsUpdate BlogsResponse! Arguments Name Description id Int! data BlogInput! blogsDelete BlogsResponse! Arguments Name Description id Int! campaignCreate CampaignResponse! Arguments Name Description data CampaignInput! campaignDuplicate CampaignResponse! Arguments Name Description id Int! campaignUpdate CampaignResponse! Arguments Name Description id Int! data CampaignInput! campaignDelete CampaignResponse! Arguments Name Description id Int! campaignCommentCreate CampaignCommentResponse! Arguments Name Description data CampaignCommentCreateInput! campaignCommentUpdate CampaignCommentResponse! Arguments Name Description id Int! data CampaignCommentUpdateInput! campaignCommentDelete CampaignCommentResponse! Arguments Name Description id Int! peerCampaignCreate PeerCampaignResponse! Arguments Name Description data PeerCampaignInput! peerCampaignUpdate PeerCampaignResponse! Arguments Name Description id Int! data PeerCampaignInput! peerCampaignDelete PeerCampaignResponse! Arguments Name Description id Int! checkoutCreate CheckoutResponse! Arguments Name Description data CheckoutInput! checkoutUpdate CheckoutResponse! Arguments Name Description token String! data CheckoutInput! checkoutComplete CheckoutResponse! Arguments Name Description token String! data CheckoutCompleteInput! checkoutRegisterPayment CheckoutResponse! Arguments Name Description token String! data CheckoutPaymentInput! checkoutSendRecoveryEmail CheckoutResponse! Arguments Name Description token String! donationUpdate Donation! Arguments Name Description id Int! data DonationInput! donationExport String! Arguments Name Description format ExportFormat! domain DonationDomain! donationReceiptSend Boolean! Arguments Name Description id Int! donationRegisterPayment DonationResponse! Arguments Name Description id Int! data DonationPaymentInput! donationImport Task! Arguments Name Description file Upload! createMissingCampaigns Boolean! createMissingPaymentMethod Boolean! importAnonymousPayments Boolean! fallbackCampaignId Int donationRevoke Donation! Arguments Name Description id Int! donationDelete Donation! Arguments Name Description id Int! mediaCreate Media! Arguments Name Description file Upload! mediaDelete MediaResponse! Arguments Name Description id Int! menuCreate MenuResponse! Arguments Name Description data MenuInput! menuUpdate MenuResponse! Arguments Name Description id Int! data MenuInput! menuDelete MenuResponse! Arguments Name Description id Int! organizationUpdate OrganizationResponse! Arguments Name Description data OrganizationInput! organizationUpdateLegalData OrganizationResponse! Arguments Name Description data OrganizationLegalInput! terminalLocationCreate StripeTerminalLocation! Arguments Name Description data TerminalLocationInput! terminalLocationUpdate StripeTerminalLocation! Arguments Name Description id String! data TerminalLocationInput! terminalLocationDelete Void Arguments Name Description id String! terminalRegister StripeTerminal! Arguments Name Description data TerminalRegisterInput! terminalUpdateLabel StripeTerminal! Arguments Name Description id String! label String! terminalDelete String! Arguments Name Description id String! terminalConnectionTokenCreate String! Arguments Name Description locationId String pagesCreate PagesResponse! Arguments Name Description data PageInput! pagesUpdate PagesResponse! Arguments Name Description id Int! data PageInput! pagesDelete PagesResponse! Arguments Name Description id Int! manualPaymentMethodCreate PaymentMethodResponse! Arguments Name Description data ManualPaymentMethodInput! manualPaymentMethodUpdate PaymentMethodResponse! Arguments Name Description id Int! data ManualPaymentMethodInput! manualPaymentMethodDelete PaymentMethodResponse! Arguments Name Description id Int! paymentExport String! Arguments Name Description format ExportFormat! domain PaymentDomain! paymentUpdate PaymentResponse! Arguments Name Description id Int! data ManualPaymentInput! paymentRefund PaymentResponse! Arguments Name Description id Int! satispayPaymentCreate SatispayPaymentResponse! Arguments Name Description checkoutToken String! projectCreate ProjectResponse! Arguments Name Description data ProjectInput! projectUpdate ProjectResponse! Arguments Name Description id Int! data ProjectInput! projectUpdateItems ProjectResponse! Arguments Name Description id Int! campaignIds [Int!]! projectRemoveItem ProjectResponse! Arguments Name Description id Int! campaignId Int! projectDelete ProjectResponse! Arguments Name Description id Int! supporterCreate Supporter! Arguments Name Description data SupporterInput! supporterUpdate Supporter! Arguments Name Description id Int! data SupporterInput! supporterDelete Supporter! Arguments Name Description id Int! supporterSendTaxCertificate Supporter! Arguments Name Description id Int! method NotificationMethods! supporterImport Task! Arguments Name Description file Upload! overrideSupporters Boolean! supporterBulkTags Boolean! Arguments Name Description action SupporterBulkTagAction! filters SupporterFiltersInput! tags [String!]! supporterExport String! Arguments Name Description format ExportFormat! domain SupporterDomain! supporterMerge Supporter! Arguments Name Description masterId Int! duplicatesIds [Int!]! data SupporterInput! supporterSetPrivacy SupporterResponse! Arguments Name Description id Int! data SupporterPrivacyInput! supporterRemovePrivacy SupporterResponse! Arguments Name Description id Int! code String! segmentCreate SegmentResponse! Arguments Name Description data SegmentInput! segmentUpdate SegmentResponse! Arguments Name Description id Int! data SegmentInput! segmentDelete SegmentResponse! Arguments Name Description id Int! stripeActivate StripeAccount! stripeGenerateOnboardingLink StripeLink! stripeGenerateDashboardLink StripeLink! stripeCheckoutIntentCreate StripeCheckoutResponse! Arguments Name Description checkoutToken String! paymentTypes StripePaymentTypeInput! stripeTerminalCheckoutIntentCreate StripeCheckoutResponse! Arguments Name Description checkoutToken String! sumupAccountCreate SumUpAccount! Arguments Name Description data SumUpAccountInput! sumupAccountUpdate SumUpAccount! Arguments Name Description data SumUpAccountInput! redirectsCreate RedirectResponse! Arguments Name Description data RedirectInput! redirectsUpdate RedirectResponse! Arguments Name Description id Int! data RedirectInput! redirectsDelete RedirectResponse! Arguments Name Description id Int! customfieldDefinitionCreate CustomFieldDefinitionResponse! Arguments Name Description data CustomFieldDefinitionCreateInput! customfieldDefinitionUpdate CustomFieldDefinitionResponse! Arguments Name Description id Int! data CustomFieldDefinitionUpdateInput! customfieldDefinitionDelete CustomFieldDefinitionResponse! Arguments Name Description id Int! privacyDefinitionCreate PrivacyDefinitionResponse! Arguments Name Description data PrivacyDefinitionCreateInput! privacyDefinitionUpdate PrivacyDefinitionResponse! Arguments Name Description id Int! data PrivacyDefinitionUpdateInput! privacyDefinitionDelete PrivacyDefinitionResponse! Arguments Name Description id Int! AppQuery Fields Name Description activities ActivityConnection! Arguments Name Description pagination PaginationInput filters ActivityFilters activity Activity! Arguments Name Description id Int! articles ArticleConnection! Arguments Name Description pagination PaginationInput filters ArticlesFiltersInput article Article! Arguments Name Description id Int! blogs BlogConnection! Arguments Name Description pagination PaginationInput filters BlogsFiltersInput blog Blog! Arguments Name Description id Int! campaigns CampaignConnection! Arguments Name Description pagination PaginationInput filters CampaignFilters campaign Campaign! Arguments Name Description id Int! campaignTags StrConnection! Arguments Name Description pagination PaginationInput q String campaignComments CampaignCommentConnection! Arguments Name Description pagination PaginationInput filters CampaignCommentsFilters campaignComment CampaignComment! Arguments Name Description id Int! peerCampaigns PeerCampaignConnection! Arguments Name Description pagination PaginationInput filters PeerCampaignFilters peerCampaign PeerCampaign! Arguments Name Description id Int! checkouts CheckoutConnection! Arguments Name Description pagination PaginationInput filters CheckoutFilters checkoutsAbandoned CheckoutConnection! Arguments Name Description pagination PaginationInput filters CheckoutFilters checkoutsAdminGenerated CheckoutConnection! Arguments Name Description pagination PaginationInput filters CheckoutFilters checkout Checkout! Arguments Name Description token String! donations DonationConnection! Arguments Name Description pagination PaginationInput filters DonationFiltersInput donation Donation! Arguments Name Description id Int! donationTags StrConnection! Arguments Name Description pagination PaginationInput q String media MediaConnection! Arguments Name Description pagination PaginationInput mediaSingle Media! Arguments Name Description id Int! menus [Menu!]! menu Menu! Arguments Name Description id Int! menuByHandle Menu! Arguments Name Description handle String! organizations [Organization!]! Arguments Name Description filters OrganizationsFilters organization Organization! owner Staff! pages PageConnection! Arguments Name Description pagination PaginationInput filters PagesFiltersInput page Page! Arguments Name Description id Int! paymentMethods [PaymentMethod!]! manualPaymentMethods [PaymentMethod!]! manualPaymentMethod PaymentMethod! Arguments Name Description id Int! payments PaymentConnection! Arguments Name Description pagination PaginationInput filters PaymentFiltersInput payment Payment! Arguments Name Description id Int! projects ProjectConnection! Arguments Name Description pagination PaginationInput filters ProjectFilters project Project! Arguments Name Description id Int! supporters SupporterConnection! Arguments Name Description pagination PaginationInput filters SupporterFiltersInput supporter Supporter! Arguments Name Description id Int! supporterTags StrConnection! Arguments Name Description pagination PaginationInput q String segments SegmentConnection! Arguments Name Description pagination PaginationInput filters SegmentFiltersInput segment Segment! Arguments Name Description id Int! terminalLocations [StripeTerminalLocation!]! Arguments Name Description filters TerminalLocationFilters terminalLocation StripeTerminalLocation! Arguments Name Description id String! terminals [StripeTerminal!]! terminalsByLocation [StripeTerminal!]! Arguments Name Description locationId String! terminal StripeTerminal! Arguments Name Description id String! stripe StripeAccount stripeCustomerCards [StripeCard!]! Arguments Name Description stripeCustomerId String! sumupAccount SumUpAccount redirects RedirectConnection! Arguments Name Description pagination PaginationInput filters RedirectsFiltersInput redirect Redirect! Arguments Name Description id Int! customfieldDefinitions [CustomFieldDefinition!]! Arguments Name Description pagination PaginationInput filters CustomFieldFilters customfieldDefinition CustomFieldDefinition! Arguments Name Description id Int! privacyDefinitions PrivacyDefinitionConnection! Arguments Name Description pagination PaginationInput filters PrivacyDefinitionFilters privacyDefinition PrivacyDefinition! Arguments Name Description id Int! Article Fields Name Description id Int! title String! content String visibility WebDocumentVisibility! slug String! url String! seoTitle String template String seoDescription String createDate DateTime! updateDate DateTime! sitefrontUrl String! blog Blog! cover Media ArticleConnection Fields Name Description pageInfo PageInfo! edges [ArticleEdge!]! ArticleEdge Fields Name Description cursor String! node Article! ArticlesResponse Fields Name Description userErrors [UserError!] article Article Blog Fields Name Description id Int! title String! content String visibility WebDocumentVisibility! slug String! url String! seoTitle String template String seoDescription String createDate DateTime! updateDate DateTime! sitefrontUrl String! cover Media BlogConnection Fields Name Description pageInfo PageInfo! edges [BlogEdge!]! BlogEdge Fields Name Description cursor String! node Blog! BlogsResponse Fields Name Description userErrors [UserError!] blog Blog Campaign Fields Name Description id Int! title String! content String visibility WebDocumentVisibility! slug String! url String! seoTitle String template String seoDescription String createDate DateTime! updateDate DateTime! type CampaignType! goal Float note String tags [String!]! allowPeerToPeer Boolean isGoalEnabled Boolean! costExamples [CostExample!]! excludedChannels [Int!]! thankyouTemplate String receiptNotificationId Int hasOneOff Boolean! hasSubscription Boolean! hasSubscriptionCustomOptions Boolean! allowCustomAmount Boolean! allowCustomSubscriptionAmount Boolean! defaultAmount Float defaultSubscriptionAmount Float minAmount Float maxAmount Float minSubscriptionAmount Float maxSubscriptionAmount Float asks [Float!]! asksSubscription [Float!]! shownFields [String!]! requiredFields [String!]! privacyNote String sitefrontUrl String! privacyFields [PrivacyDefinition!]! cover Media CampaignComment Fields Name Description id Int! createDate DateTime! updateDate DateTime! message String! status CampaignCommentStatus! supporter Supporter! campaign Campaign! public Boolean! anonymous Boolean! peerCampaign PeerCampaign CampaignCommentConnection Fields Name Description pageInfo PageInfo! edges [CampaignCommentEdge!]! CampaignCommentEdge Fields Name Description cursor String! node CampaignComment! CampaignCommentResponse Fields Name Description userErrors [UserError!] comment CampaignComment CampaignConnection Fields Name Description pageInfo PageInfo! edges [CampaignEdge!]! CampaignEdge Fields Name Description cursor String! node Campaign! CampaignResponse Fields Name Description userErrors [UserError!] campaign Campaign Checkout Fields Name Description id Int! token String! state CheckoutState! errorMessage String completedDate DateTime supporterBusinessName String supporterFirstName String supporterLastName String supporterType String supporterEmail String supporterPhone String supporterMobile String supporterSex String supporterDateOfBirth Date supporterPlaceOfBirth String supporterSsn String supporterVat String supporterAddress String supporterAddress2 String supporterCity String supporterLocality String supporterCountry String supporterPostalCode String supporterPrivacy Boolean supporterEmailMarketing Boolean supporterPhoneMarketing Boolean supporterPrivacyValues Boolean donationAmount Float donationFrequency Frequency costExampleQuantity Int! recoveryMailSentDate DateTime applicationMetadata JSON tags [String!]! createDate DateTime! updateDate DateTime! supporterFullname String! campaign Campaign! peerCampaign PeerCampaign enabledPaymentMethods [PaymentMethod!]! supporter Supporter donation Donation checkoutUrl String! application Application CheckoutConnection Fields Name Description pageInfo PageInfo! edges [CheckoutEdge!]! CheckoutEdge Fields Name Description cursor String! node Checkout! CheckoutResponse Fields Name Description userErrors [UserError!] checkout Checkout CostExample Fields Name Description amount Float! name String! description String! uuid String! monitorQuantity Boolean! quantity Int! availableQuantity Int! image Media Country Fields Name Description name String! code String! CustomField Fields Name Description key String! type CustomFieldType! value String meta CustomFieldDefinition! CustomFieldDefinition Fields Name Description id Int! entity CustomFieldEntity! name String! key String! description String type CustomFieldType! position Int! options [String!] archived Boolean! CustomFieldDefinitionResponse Fields Name Description userErrors [UserError!] customFieldDefinition CustomFieldDefinition Donation Fields Name Description id Int! code String! state DonationState! amount Float! frequency Frequency note String completedDate DateTime createDate DateTime! updateDate DateTime! device String tags [String!]! isPublic Boolean! costExampleQuantity Int! receiptUrl String campaign Campaign! peerCampaign PeerCampaign costExample CostExample paymentMethod PaymentMethod supporter Supporter! checkout Checkout totalPayments Int! totalPaid Float! customfields [CustomField!]! DonationConnection Fields Name Description pageInfo PageInfo! edges [DonationEdge!]! DonationEdge Fields Name Description cursor String! node Donation! DonationResponse Fields Name Description userErrors [UserError!] donation Donation Media Fields Name Description id Int! name String! url String! height Int! width Int! size Int! createDate String! alt String! square String! small String! medium String! MediaConnection Fields Name Description pageInfo PageInfo! edges [MediaEdge!]! MediaEdge Fields Name Description cursor String! node Media! MediaResponse Fields Name Description userErrors [UserError!] media Media Menu Fields Name Description id Int! name String! handle String! items [MenuItem!]! MenuItem Fields Name Description id Int! label String! link String! type MenuItemType! MenuResponse Fields Name Description userErrors [UserError!] menu Menu Organization Fields Name Description id Int! reference String! name String! currency Currencies! domain String! contactEmail String senderEmail String legalName String isInvoiceRequired Boolean vat String vatExchange String taxIdentificationNumber String contactPhone String addressLine1 String addressLine2 String city String state String postalCode String country Country tos String consentScopes [String!]! privacyPolicy String baseSitefrontUrl String! planType BillingPlanType annualCertificateAutoSend Boolean! annualCertificateSendMonth Int! annualCertificateSendDay Int! annualCertificateLastSentYear Int onboardingStatus OnboardingStatus! sitefrontUrl String! logo Media senderEmailStatus OrganizationSenderEmailStatus! owner User! jwtPassKey String! OrganizationResponse Fields Name Description userErrors [UserError!] organization Organization OrganizationSenderEmailStatus Fields Name Description spf Boolean! spfValue String dkim Boolean! dkimValue String verified Boolean! verificationString String readyToSend Boolean Page Fields Name Description id Int! title String! content String visibility WebDocumentVisibility! slug String! url String! seoTitle String template String seoDescription String createDate DateTime! updateDate DateTime! sitefrontUrl String! cover Media PageConnection Fields Name Description pageInfo PageInfo! edges [PageEdge!]! PageEdge Fields Name Description cursor String! node Page! PageInfo Fields Name Description hasNextPage Boolean! hasPreviousPage Boolean! startCursor String endCursor String total Int! PagesResponse Fields Name Description userErrors [UserError!] page Page Payment Fields Name Description id Int! state PaymentState! amount Float! paymentDate DateTime stripeIntentId String createDate DateTime! updateDate DateTime! supporter Supporter donation Donation paymentMethod PaymentMethod netAmount Float PaymentConnection Fields Name Description pageInfo PageInfo! edges [PaymentEdge!]! PaymentEdge Fields Name Description cursor String! node Payment! PaymentMethod Fields Name Description id Int! processor PaymentProcessor! hasOneoffSupport Boolean! hasSubscriptionSupport Boolean! label String description String instructions String channels [Int!]! includeInCertificate Boolean! PaymentMethodResponse Fields Name Description userErrors [UserError!] paymentMethod PaymentMethod PaymentResponse Fields Name Description userErrors [UserError!] payment Payment PeerCampaign Fields Name Description id Int! title String! content String visibility WebDocumentVisibility! slug String! url String! seoTitle String template String seoDescription String createDate DateTime! updateDate DateTime! supporterName String customMessage String goal Float isGoalEnabled Boolean! thankyouTemplate String receiptNotificationId Int sitefrontUrl String! supporter Supporter campaign Campaign PeerCampaignConnection Fields Name Description pageInfo PageInfo! edges [PeerCampaignEdge!]! PeerCampaignEdge Fields Name Description cursor String! node PeerCampaign! PeerCampaignResponse Fields Name Description userErrors [UserError!] peerCampaign PeerCampaign PrivacyDefinition Fields Name Description id Int! code String! label String! message String isDefault Boolean! isRequired Boolean! consentScopes [String!]! createDate DateTime! updateDate DateTime! PrivacyDefinitionConnection Fields Name Description pageInfo PageInfo! edges [PrivacyDefinitionEdge!]! PrivacyDefinitionEdge Fields Name Description cursor String! node PrivacyDefinition! PrivacyDefinitionResponse Fields Name Description userErrors [UserError!] privacyDefinition PrivacyDefinition Project Fields Name Description id Int! title String! content String visibility WebDocumentVisibility! slug String! url String! seoTitle String template String seoDescription String createDate DateTime! updateDate DateTime! type ProjectType! rulesMatch ProjectRuleMatchType! campaignsOrder ProjectCampaignsOrder! cover Media sitefrontUrl String! rules [ProjectRule!]! items [ProjectCampaignItem!]! ProjectCampaignItem Fields Name Description id Int! position Int! campaign Campaign! ProjectConnection Fields Name Description pageInfo PageInfo! edges [ProjectEdge!]! ProjectEdge Fields Name Description cursor String! node Project! ProjectResponse Fields Name Description userErrors [UserError!] project Project ProjectRule Fields Name Description uuid String! field ProjectRuleField! operator ProjectRuleOperator! value String! Redirect Fields Name Description id Int! sourcePath String! destinationUrl String! RedirectConnection Fields Name Description pageInfo PageInfo! edges [RedirectEdge!]! RedirectEdge Fields Name Description cursor String! node Redirect! RedirectResponse Fields Name Description userErrors [UserError!] redirect Redirect SatispayPaymentResponse Fields Name Description id String codeIdentifier String type String amountUnit Int currency String status String expired Boolean insertDate String expireDate String description String flow String externalCode String redirectUrl String Segment Fields Name Description id Int! createDate DateTime! updateDate DateTime! name String! entity SegmentEntity! filters JSON! SegmentConnection Fields Name Description pageInfo PageInfo! edges [SegmentEdge!]! SegmentEdge Fields Name Description cursor String! node Segment! SegmentResponse Fields Name Description userErrors [UserError!] segment Segment Staff Fields Name Description id Int! userId Int partnerId Int name String email String! state StaffStatus! lang String! timezone String! createDate String role StaffRole! bio String lastLoginDate String isOwner Boolean! permissions [StaffPermission!]! StrConnection Fields Name Description pageInfo PageInfo! edges [StrEdge!]! StrEdge Fields Name Description cursor String! node String! StripeAccount Fields Name Description accountId String hasOneoffSupport Boolean! hasSubscriptionSupport Boolean! detailsSubmitted Boolean chargesEnabled Boolean pubKey String! hasSepaEnabled Boolean! StripeCard Fields Name Description id String! brand StripeCardBrand! country String! expMonth Int! expYear Int! fingerprint String! funding StripeCardFunding! last4 String! StripeCheckoutIntent Fields Name Description clientSecret String! StripeCheckoutResponse Fields Name Description userErrors [UserError!] checkout StripeCheckoutIntent StripeLink Fields Name Description url String! StripeTerminal Fields Name Description id String! label String! serialNumber String! status String! locationId String location StripeTerminalLocation StripeTerminalLocation Fields Name Description id String! displayName String! addressCity String! addressCountry String! addressLine1 String! addressLine2 String addressPostalCode String! addressState String! terminalCount Int! SumUpAccount Fields Name Description merchantCode String hasPayments Boolean! Supporter Fields Name Description id Int! archived Boolean code String! createDate DateTime! image String businessName String firstName String lastName String fullName String supporterType SupporterType email String phone String mobile String sex Sex dateOfBirth Date placeOfBirth String ssn String vat String title String job String address String address2 String city String locality String country String postalCode String certificationUrl String privacy Boolean emailMarketing Boolean phoneMarketing Boolean smsMarketing Boolean postalMarketing Boolean profilationMarketing Boolean tags [String!]! note String stripeCustomerId String customfields [CustomField!]! privacyValues [SupporterPrivacyValue!]! sourceCampaign Campaign sourcePeerCampaign PeerCampaign totalDonations Int! totalDonated String! averageDonation String! lastOneoffDonation Donation activeRegularDonations [Donation!]! savedCards [StripeCard!]! SupporterConnection Fields Name Description pageInfo PageInfo! edges [SupporterEdge!]! SupporterEdge Fields Name Description cursor String! node Supporter! SupporterPrivacyValue Fields Name Description code String! label String! value Boolean! date DateTime SupporterResponse Fields Name Description userErrors [UserError!] supporter Supporter Task Fields Name Description taskId String! User Fields Name Description id Int! email String! name String verificationToken String UserError Fields Name Description code ErrorCode! field String message String Contenuto importato da https://dev.riseact.org/docs/graphql-references/objects il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. GraphQL - Enums ActivityCategory Values Value Description PHONE_CALL EMAIL MEETING TODO REMINDER LETTER WHATSAPP ActivitySubject Values Value Description SUPPORTER DONATION ApplicationType Values Value Description ADMIN POD KIOSK CLI PARTNERS SITEFRONT INTERNAL PUBLIC PRIVATE BillingPlanType Values Value Description DEVELOPMENT HERO TEAM GROW PAY_AS_YOU_GO PLATFORM MASTER CampaignCommentStatus Values Value Description PENDING APPROVED REJECTED CampaignType Values Value Description LEAD DONATION CheckoutState Values Value Description OPEN CLOSED Currencies Values Value Description EUR USD GBP CustomFieldEntity Values Value Description SUPPORTER DONATION CustomFieldType Values Value Description TEXT BOOLEAN SELECT DonationState Values Value Description DRAFT PENDING ACTIVE PAST_DUE DONE REVOKED ErrorCode Values Value Description BAD_INPUT NOT_FOUND NOT_UNIQUE PROTECTED ExportFormat Values Value Description XLSX CSV Frequency Values Value Description ONEOFF MONTHLY ANNUALLY MenuItemType Values Value Description EXTERNAL HOMEPAGE PAGE ARTICLE BLOG CAMPAIGN PROJECT NotificationMethods Values Value Description EMAIL SMS OnboardingStatus Values Value Description MISSING_DATA FREE_PLAN ACTIVE EXPIRED PaymentProcessor Values Value Description MANUAL STRIPE PAYPAL SATISPAY SUMUP PaymentState Values Value Description PENDING PAID REFUNDED FAILED ProjectCampaignsOrder Values Value Description NEWER OLDER ALPHA_AZ ALPHA_ZA MANUAL ProjectRuleField Values Value Description TAGS TITLE ProjectRuleMatchType Values Value Description ANY ALL ProjectRuleOperator Values Value Description EQUALS_TO NOT_EQUALS_TO CONTAINS NOT_CONTAINS STARTS_WITH ENDS_WITH ProjectType Values Value Description MANUAL DYNAMIC SegmentEntity Values Value Description SUPPORTER Sex Values Value Description MALE FEMALE SexFilter Values Value Description MALE FEMALE NOT_SPECIFIED StaffPermission Values Value Description SUPPORTER_READ SUPPORTER_WRITE SUPPORTER_EXPORT DONATION_READ DONATION_WRITE DONATION_EXPORT PAYMENT_READ PAYMENT_WRITE CAMPAIGN_READ CAMPAIGN_WRITE PROJECT_READ PROJECT_WRITE ACTIVITY_READ ACTIVITY_WRITE REPORTS_READ APPLICATION_READ APPLICATION_INSTALL SITEFRONT_THEMES SITEFRONT_THEMES_CODE SITEFRONT_CONTENT SITEFRONT_NAVIGATION DBOX_READ DBOX_WRITE StaffRole Values Value Description ADMIN USER StaffStatus Values Value Description ACTIVE SUSPENDED DELETED StripeCardBrand Values Value Description AMEX DINERS DISCOVER JCB MASTERCARD UNIONPAY VISA UNKNOWN StripeCardFunding Values Value Description CREDIT DEBIT PREPAID UNKNOWN StripePaymentType Values Value Description SEPA_DIRECT_DEBIT CREDIT_CARD POS SupporterBulkTagAction Values Value Description ADD REMOVE SupporterType Values Value Description INDIVIDUAL COMPANY ORGANIZATION FAMILY GROUP WebDocumentVisibility Values Value Description UNPUBLISHED PUBLISHED ARCHIVED Contenuto importato da https://dev.riseact.org/docs/graphql-references/enums il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. GraphQL - Input objects ActivityCreateInput Arguments Name Description subject ActivitySubject! subjectId Int! category ActivityCategory! deadlineDate Date doneDate Date note String staffId Int ActivityFilters Arguments Name Description q String order String dueDate DateRange userId Int supporterId Int donationId Int ActivityUpdateInput Arguments Name Description category ActivityCategory deadlineDate Date doneDate Date note String staffId Int ArticleInput Arguments Name Description title String content String visibility WebDocumentVisibility slug String seoTitle String seoDescription String template String coverId Int blogId Int ArticlesFiltersInput Arguments Name Description q String BlogInput Arguments Name Description title String content String visibility WebDocumentVisibility slug String seoTitle String seoDescription String template String coverId Int BlogsFiltersInput Arguments Name Description q String CampaignCommentCreateInput Arguments Name Description donationId Int! message String! status CampaignCommentStatus! public Boolean! anonymous Boolean! CampaignCommentsFilters Arguments Name Description q String supporterId Int campaignId Int donationId Int status CampaignCommentStatus CampaignCommentUpdateInput Arguments Name Description message String status CampaignCommentStatus public Boolean anonymous Boolean CampaignFilters Arguments Name Description q String order String tags [String!] tagsNot [String!] channels [String!] ids [Int!] visibility WebDocumentVisibility CampaignInput Arguments Name Description title String content String visibility WebDocumentVisibility slug String seoTitle String seoDescription String template String thankyouTemplate String receiptNotificationId Int coverId Int isGoalEnabled Boolean code String goal Float type CampaignType tags [String!] excludedChannels [Int!] allowPeerToPeer Boolean costExamples [CostExampleInput!] hasOneOff Boolean hasSubscription Boolean hasSubscriptionCustomOptions Boolean defaultAmount Float minAmount Float maxAmount Float asks [Float!] allowCustomAmount Boolean defaultSubscriptionAmount Float minSubscriptionAmount Float maxSubscriptionAmount Float asksSubscription [Float!] allowCustomSubscriptionAmount Boolean shownFields [String!] requiredFields [String!] privacyFields [String!] privacyNote String CheckoutCompleteInput Arguments Name Description paymentMethodId Int CheckoutFilters Arguments Name Description q String state CheckoutState order String tags [String!] tagsNot [String!] createDate DateRange updateDate DateRange completedDate DateRange CheckoutInput Arguments Name Description campaignId Int supporterId Int costExampleQuantity Int peerCampaignId Int amount Float frequency Frequency isPromise Boolean tags [String!] paymentMethodId Int supporterData SupporterInput donationData DonationInput device String applicationId Int applicationMetadata JSON CheckoutPaymentInput Arguments Name Description state PaymentState amount Float paymentDate DateTime donationId Int paymentMethodId Int peerCampaignId Int creditCardId Int sepaBankAccountId Int stripePaymentIntentId String satispayPaymentIntentId String CostExampleInput Arguments Name Description uuid String! name String! description String! amount Float! imageId Int monitorQuantity Boolean! quantity Int! availableQuantity Int! CustomFieldDefinitionCreateInput Arguments Name Description entity CustomFieldEntity! name String! description String type CustomFieldType! position Int options [String!] CustomFieldDefinitionUpdateInput Arguments Name Description name String description String position Int options [String!] archived Boolean CustomFieldEntityFilter Arguments Name Description key String! value String defined Boolean CustomFieldFilters Arguments Name Description entity CustomFieldEntity archived Boolean CustomFieldInput Arguments Name Description key String! value String DateRange Arguments Name Description start Date end Date DateTimeRange Arguments Name Description start DateTime end DateTime DonationDomain Arguments Name Description filters DonationFiltersInput ids [Int!] DonationFiltersInput Arguments Name Description q String archived Boolean order String tags [String!] tagsNot [String!] createDate DateRange createDatetime DateTimeRange updateDate DateRange updateDatetime DateRange completedDate DateRange completedDatetime DateTimeRange totalPaid IntRange totalPayments IntRange supporterType SupporterType campaigns [Int!] peerCampaigns [Int!] supporters [Int!] paymentMethods [Int!] frequencies [Frequency!] customfields [CustomFieldEntityFilter!] DonationInput Arguments Name Description amount Float frequency Frequency note String tags [String!] device String isPublic Boolean customfields [CustomFieldInput!] DonationPaymentInput Arguments Name Description amount Float frequency Frequency paymentDate DateTime paymentMethodId Int IntRange Arguments Name Description start Int end Int ManualPaymentInput Arguments Name Description amount Float! paymentDate DateTime! paymentMethodId Int ManualPaymentMethodInput Arguments Name Description label String! hasOneoffSupport Boolean hasSubscriptionSupport Boolean description String instructions String channels [Int!] includeInCertificate Boolean MenuInput Arguments Name Description name String! handle String! items [MenuItemInput!]! MenuItemInput Arguments Name Description label String! link String OrganizationInput Arguments Name Description name String! logo Int legalName String currency Currencies! isInvoiceRequired Boolean vat String vatExchange String taxIdentificationNumber String senderEmail String contactEmail String contactPhone String addressLine1 String addressLine2 String city String state String country String postalCode String annualCertificateAutoSend Boolean annualCertificateSendMonth Int annualCertificateSendDay Int OrganizationLegalInput Arguments Name Description tos String! privacyPolicy String! consentScopes [String!]! OrganizationsFilters Arguments Name Description name String PageInput Arguments Name Description title String content String visibility WebDocumentVisibility slug String seoTitle String seoDescription String template String coverId Int PagesFiltersInput Arguments Name Description q String PaginationInput Arguments Name Description first Int last Int after String before String PaymentDomain Arguments Name Description filters PaymentFiltersInput ids [Int!] PaymentFiltersInput Arguments Name Description q String supporter Int donation Int paymentMethod Int paymentDate DateRange state [PaymentState!] order String createDate DateRange updateDate DateRange PeerCampaignFilters Arguments Name Description q String ids [Int!] order String tags [String!] tagsNot [String!] channels [String!] supporterId Int campaignId Int PeerCampaignInput Arguments Name Description supporterId Int! campaignId Int! title String content String visibility WebDocumentVisibility slug String seoTitle String seoDescription String template String thankyouTemplate String coverId Int isGoalEnabled Boolean goal Float supporterName String customMessage String receiptNotificationId Int PrivacyDefinitionCreateInput Arguments Name Description code String! label String! message String isDefault Boolean isRequired Boolean consentScopes [String!] PrivacyDefinitionFilters Arguments Name Description code String label String isDefault Boolean isRequired Boolean PrivacyDefinitionUpdateInput Arguments Name Description code String label String message String isDefault Boolean isRequired Boolean consentScopes [String!] ProjectFilters Arguments Name Description q String order String ProjectInput Arguments Name Description title String! content String visibility WebDocumentVisibility slug String seoTitle String seoDescription String template String coverId Int type ProjectType rulesMatch ProjectRuleMatchType campaignsOrder ProjectCampaignsOrder rules [ProjectRuleInput!] ProjectRuleInput Arguments Name Description field ProjectRuleField! operator ProjectRuleOperator! value String! uuid String! RedirectInput Arguments Name Description sourcePath String! destinationUrl String! RedirectsFiltersInput Arguments Name Description q String SegmentFiltersInput Arguments Name Description entity SegmentEntity! q String order String SegmentInput Arguments Name Description name String! entity SegmentEntity! filters String! StripePaymentTypeInput Arguments Name Description types [StripePaymentType!]! SumUpAccountInput Arguments Name Description merchantCode String SupporterDomain Arguments Name Description filters SupporterFiltersInput ids [Int!] SupporterFiltersInput Arguments Name Description q String archived Boolean ids [Int!] order String type SupporterType city String country String createDate DateRange updateDate DateRange sex SexFilter campaigns [Int!] firstDonationDate DateRange lastDonationDate DateRange totalDonated IntRange totalDonations IntRange peerCampaigns [Int!] havePhone Boolean haveEmail Boolean haveVat Boolean haveSsn Boolean dateOfBirth DateRange placeOfBirth String emailMarketing Boolean phoneMarketing Boolean smsMarketing Boolean postalMarketing Boolean profilationMarketing Boolean privacyValues [String!] tags [String!] tagsNot [String!] isOneoffSupporter Boolean isRegularSupporter Boolean email String ssn String phone String customfields [CustomFieldEntityFilter!] query String SupporterInput Arguments Name Description businessName String firstName String lastName String title String externalRef String supporterType SupporterType email String phone String mobile String job String sex Sex dateOfBirth Date placeOfBirth String ssn String vat String address String address2 String city String locality String country String postalCode String emailMarketing Boolean phoneMarketing Boolean smsMarketing Boolean postalMarketing Boolean profilationMarketing Boolean note String certificationUrl String image String tags [String!] customfields [CustomFieldInput!] privacyValues [SupporterPrivacyInput!] sourceCampaignId Int sourcePeerCampaignId Int SupporterPrivacyInput Arguments Name Description code String! value Boolean! date String TerminalLocationFilters Arguments Name Description q String TerminalLocationInput Arguments Name Description displayName String! addressCity String! addressCountry String! addressLine1 String! addressLine2 String addressPostalCode String! addressState String! TerminalRegisterInput Arguments Name Description label String! registrationCode String! locationId String! Contenuto importato da https://dev.riseact.org/docs/graphql-references/inputObjects il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. GraphQL - Scalars Boolean The Boolean scalar type represents true or false . Date Date (isoformat) DateTime Date with time (isoformat) Float The Float scalar type represents signed double-precision fractional values as specified by IEEE 754 . Int The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1. JSON The JSON scalar type represents JSON values as specified by ECMA-404 . String The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text. Upload Void Represents NULL values Contenuto importato da https://dev.riseact.org/docs/graphql-references/scalars il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. API - REST Utilizzo delle API REST Riseact fornisce un set di APIs REST per consentire agli sviluppatori di interagire con le risorse di Riseact. Queste APIs sono disponibili per tutti gli sviluppatori che hanno creato un'applicazione su Riseact. Per poter utilizzare le APIs GraphQL di Riseact, è necessario ottenere un Access Token attraverso i processi descritti in questa pagina . Una volta ottenuto un Access Token, puoi utilizzare le APIs REST per interagire con le risorse di Riseact. Per ulteriori informazioni, consulta la pagina Risorse di Riseact e la pagina di references delle API REST . Esempio di utilizzo curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" https://core.riseact.com/api/v1/organization L'esempio sopra mostra come effettuare una richiesta alle API REST di Riseact utilizzando il comando cURL. Devi sostituire "YOUR_ACCESS_TOKEN" con il tuo effettivo Access Token ottenuto tramite OAuth. L'URL " https://api.riseact.com/v1/resources" rappresenta l'endpoint delle risorse di Riseact a cui desideri accedere. Puoi personalizzare la richiesta cURL in base alle tue esigenze specifiche, specificando i parametri appropriati o utilizzando metodi diversi come POST, PUT o DELETE. Contenuto importato da https://dev.riseact.org/docs/apis/rest-api-usage il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. RiseAct Admin API Version: 1.0.0 Authentication HTTP: Bearer Auth Security Scheme Type: http HTTP Authorization Scheme: bearer Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-admin-api il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Activity Create Activity Create Api Activity Create Api application/json Request Body required category ActivityCategory required Possible values: [ phone_call , email , meeting , todo , reminder , letter , whatsapp ] An enumeration. deadline_date date done_date date note Note staff_id Staff Id subject_id Subject Id required subject ActivitySubject required Possible values: [ supporter , donation ] An enumeration. Responses 200 OK application/json Schema Example (from schema) Schema id Id required create_date date-time required update_date date-time required category ActivityCategory required Possible values: [ phone_call , email , meeting , todo , reminder , letter , whatsapp ] An enumeration. deadline_date date done_date date note Note staff_id Staff Id subject_id Subject Id required subject ActivitySubject required Possible values: [ supporter , donation ] An enumeration. { "id" : 0 , "create_date" : "2026-04-16T14:13:28.404Z" , "update_date" : "2026-04-16T14:13:28.404Z" , "category" : "phone_call" , "deadline_date" : "2026-04-16" , "done_date" : "2026-04-16" , "note" : "string" , "staff_id" : 0 , "subject_id" : 0 , "subject" : "supporter" } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-activities-rest-api-activity-create-api il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Campaigns Get Campaigns Get Campaigns Get Path Parameters campaign_id Campaign Id required Responses 200 OK application/json Schema Example (from schema) Schema id Id required create_date date-time required update_date date-time required title Title required code Code type Type required tags string[] required { "id" : 0 , "create_date" : "2026-04-16T14:13:28.418Z" , "update_date" : "2026-04-16T14:13:28.418Z" , "title" : "string" , "code" : "string" , "type" : "string" , "tags" : [ "string" ] } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-campaigns-rest-api-campaigns-get il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Campaigns List Campaigns List Campaigns List Query Parameters q Q limit Limit Possible values: >= 1 Default value: 100 offset Offset Responses 200 OK application/json Schema Example (from schema) Schema items object[] Array [ id Id required create_date date-time required update_date date-time required title Title required code Code type Type required tags string[] required ] count Count required { "items" : [ { "id" : 0 , "create_date" : "2026-04-16T14:13:28.417Z" , "update_date" : "2026-04-16T14:13:28.417Z" , "title" : "string" , "code" : "string" , "type" : "string" , "tags" : [ "string" ] } ] , "count" : 0 } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-campaigns-rest-api-campaigns-list il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Checkout Create Checkout Create Checkout Create application/json Request Body required campaign_slug Campaign Slug required peer_campaign_slug Peer Campaign Slug supporter_id Supporter Id supporter_data object image Image business_name Business Name first_name First Name last_name Last Name supporter_type object An enumeration. email Email phone Phone mobile Mobile sex Sex Possible values: [ MALE , FEMALE ] An enumeration. date_of_birth date place_of_birth Place Of Birth job Job ssn Ssn vat Vat address Address address2 Address2 city City locality Locality country Country postal_code Postal Code email_marketing Email Marketing Default value: false phone_marketing Phone Marketing Default value: false sms_marketing Sms Marketing Default value: false postal_marketing Postal Marketing Default value: false profilation_marketing Profilation Marketing Default value: false note Note certification_url Certification Url tags string[] Default value: [] amount Amount required frequency FrequencyString required Possible values: [ ONEOFF , MONTHLY , ANNUALLY ] An enumeration. cost_example_id Cost Example Id cost_example_quantity Cost Example Quantity tags string[] payment_method_id Payment Method Id application_id Application Id application_metadata object Responses 200 OK application/json Schema Example (from schema) Schema id Id required state CheckoutState required Possible values: [ OPEN , CLOSED ] An enumeration. amount Amount frequency FrequencyString Possible values: [ ONEOFF , MONTHLY , ANNUALLY ] An enumeration. completed_date date-time campaign_id Campaign Id required supporter_id Supporter Id required donation_id Donation Id payment_id Payment Id { "id" : 0 , "state" : "OPEN" , "amount" : 0 , "frequency" : "ONEOFF" , "completed_date" : "2026-04-16T14:13:28.425Z" , "campaign_id" : 0 , "supporter_id" : 0 , "donation_id" : 0 , "payment_id" : 0 } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-checkouts-rest-api-checkout-create il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Checkouts Get Checkouts Get Checkouts Get Path Parameters checkout_id Checkout Id required Responses 200 OK application/json Schema Example (from schema) Schema id Id required create_date date-time required update_date date-time required campaign object id Id required create_date date-time required update_date date-time required title Title required code Code type Type required tags string[] required supporter object id Id required create_date date-time required image Image code Code business_name Business Name first_name First Name last_name Last Name email Email phone Phone mobile Mobile job Job sex Sex Possible values: [ MALE , FEMALE ] An enumeration. date_of_birth date place_of_birth Place Of Birth ssn Ssn vat Vat address Address address2 Address2 city City locality Locality country Country postal_code Postal Code certification_url Certification Url privacy Privacy email_marketing Email Marketing phone_marketing Phone Marketing sms_marketing Sms Marketing postal_marketing Postal Marketing profilation_marketing Profilation Marketing tags string[] required note Note donation object id Id required supporter_id Supporter Id required campaign_id Campaign Id required code Code required state DonationState required Possible values: [ draft , pending , active , past_due , done , revoked ] An enumeration. amount Amount required receipt_url Receipt Url frequency Frequency Possible values: [ 0 , 12 , 1 ] An enumeration. note Note completed_date date-time create_date date-time required update_date date-time required device Device tags string[] required payment object id Id required donation_id Donation Id required state PaymentState required Possible values: [ PENDING , PAID , REFUNDED , FAILED ] An enumeration. amount Amount required payment_date date-time payment_method object id Id required create_date date-time required update_date date-time required processor Processor required label Label required stripe_intent_id Stripe Intent Id create_date date-time required update_date date-time required state CheckoutState required Possible values: [ OPEN , CLOSED ] An enumeration. amount Amount completed_date date-time frequency Frequency Possible values: [ 0 , 12 , 1 ] An enumeration. cost_example_quantity Cost Example Quantity required payment_method_processor Payment Method Processor payment_method_label Payment Method Label payment_method_id Payment Method Id { "id" : 0 , "create_date" : "2026-04-16T14:13:28.426Z" , "update_date" : "2026-04-16T14:13:28.426Z" , "campaign" : { "id" : 0 , "create_date" : "2026-04-16T14:13:28.426Z" , "update_date" : "2026-04-16T14:13:28.426Z" , "title" : "string" , "code" : "string" , "type" : "string" , "tags" : [ "string" ] } , "supporter" : { "id" : 0 , "create_date" : "2026-04-16T14:13:28.426Z" , "image" : "string" , "code" : "string" , "business_name" : "string" , "first_name" : "string" , "last_name" : "string" , "email" : "string" , "phone" : "string" , "mobile" : "string" , "job" : "string" , "sex" : "MALE" , "date_of_birth" : "2026-04-16" , "place_of_birth" : "string" , "ssn" : "string" , "vat" : "string" , "address" : "string" , "address2" : "string" , "city" : "string" , "locality" : "string" , "country" : "string" , "postal_code" : "string" , "certification_url" : "string" , "privacy" : true , "email_marketing" : true , "phone_marketing" : true , "sms_marketing" : true , "postal_marketing" : true , "profilation_marketing" : true , "tags" : [ "string" ] , "note" : "string" } , "donation" : { "id" : 0 , "supporter_id" : 0 , "campaign_id" : 0 , "code" : "string" , "state" : "draft" , "amount" : 0 , "receipt_url" : "string" , "frequency" : 0 , "note" : "string" , "completed_date" : "2026-04-16T14:13:28.426Z" , "create_date" : "2026-04-16T14:13:28.426Z" , "update_date" : "2026-04-16T14:13:28.426Z" , "device" : "string" , "tags" : [ "string" ] } , "payment" : { "id" : 0 , "donation_id" : 0 , "state" : "PENDING" , "amount" : 0 , "payment_date" : "2026-04-16T14:13:28.426Z" , "payment_method" : { "id" : 0 , "create_date" : "2026-04-16T14:13:28.426Z" , "update_date" : "2026-04-16T14:13:28.426Z" , "processor" : "string" , "label" : "string" } , "stripe_intent_id" : "string" , "create_date" : "2026-04-16T14:13:28.426Z" , "update_date" : "2026-04-16T14:13:28.426Z" } , "state" : "OPEN" , "amount" : 0 , "completed_date" : "2026-04-16T14:13:28.426Z" , "frequency" : 0 , "cost_example_quantity" : 0 , "payment_method_processor" : "string" , "payment_method_label" : "string" , "payment_method_id" : 0 } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-checkouts-rest-api-checkouts-get il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Checkouts List Checkouts List Checkouts List Query Parameters q Q order Order state CheckoutState Possible values: [ OPEN , CLOSED ] An enumeration. create_date_from date create_date_to date update_date_from date update_date_to date limit Limit Possible values: >= 1 Default value: 100 offset Offset Responses 200 OK application/json Schema Example (from schema) Schema items object[] Array [ id Id required create_date date-time required update_date date-time required campaign object id Id required create_date date-time required update_date date-time required title Title required code Code type Type required tags string[] required supporter object id Id required create_date date-time required image Image code Code business_name Business Name first_name First Name last_name Last Name email Email phone Phone mobile Mobile job Job sex Sex Possible values: [ MALE , FEMALE ] An enumeration. date_of_birth date place_of_birth Place Of Birth ssn Ssn vat Vat address Address address2 Address2 city City locality Locality country Country postal_code Postal Code certification_url Certification Url privacy Privacy email_marketing Email Marketing phone_marketing Phone Marketing sms_marketing Sms Marketing postal_marketing Postal Marketing profilation_marketing Profilation Marketing tags string[] required note Note donation object id Id required supporter_id Supporter Id required campaign_id Campaign Id required code Code required state DonationState required Possible values: [ draft , pending , active , past_due , done , revoked ] An enumeration. amount Amount required receipt_url Receipt Url frequency Frequency Possible values: [ 0 , 12 , 1 ] An enumeration. note Note completed_date date-time create_date date-time required update_date date-time required device Device tags string[] required payment object id Id required donation_id Donation Id required state PaymentState required Possible values: [ PENDING , PAID , REFUNDED , FAILED ] An enumeration. amount Amount required payment_date date-time payment_method object id Id required create_date date-time required update_date date-time required processor Processor required label Label required stripe_intent_id Stripe Intent Id create_date date-time required update_date date-time required state CheckoutState required Possible values: [ OPEN , CLOSED ] An enumeration. amount Amount completed_date date-time frequency Frequency Possible values: [ 0 , 12 , 1 ] An enumeration. cost_example_quantity Cost Example Quantity required payment_method_processor Payment Method Processor payment_method_label Payment Method Label payment_method_id Payment Method Id ] count Count required { "items" : [ { "id" : 0 , "create_date" : "2026-04-16T14:13:28.422Z" , "update_date" : "2026-04-16T14:13:28.422Z" , "campaign" : { "id" : 0 , "create_date" : "2026-04-16T14:13:28.423Z" , "update_date" : "2026-04-16T14:13:28.423Z" , "title" : "string" , "code" : "string" , "type" : "string" , "tags" : [ "string" ] } , "supporter" : { "id" : 0 , "create_date" : "2026-04-16T14:13:28.423Z" , "image" : "string" , "code" : "string" , "business_name" : "string" , "first_name" : "string" , "last_name" : "string" , "email" : "string" , "phone" : "string" , "mobile" : "string" , "job" : "string" , "sex" : "MALE" , "date_of_birth" : "2026-04-16" , "place_of_birth" : "string" , "ssn" : "string" , "vat" : "string" , "address" : "string" , "address2" : "string" , "city" : "string" , "locality" : "string" , "country" : "string" , "postal_code" : "string" , "certification_url" : "string" , "privacy" : true , "email_marketing" : true , "phone_marketing" : true , "sms_marketing" : true , "postal_marketing" : true , "profilation_marketing" : true , "tags" : [ "string" ] , "note" : "string" } , "donation" : { "id" : 0 , "supporter_id" : 0 , "campaign_id" : 0 , "code" : "string" , "state" : "draft" , "amount" : 0 , "receipt_url" : "string" , "frequency" : 0 , "note" : "string" , "completed_date" : "2026-04-16T14:13:28.423Z" , "create_date" : "2026-04-16T14:13:28.423Z" , "update_date" : "2026-04-16T14:13:28.423Z" , "device" : "string" , "tags" : [ "string" ] } , "payment" : { "id" : 0 , "donation_id" : 0 , "state" : "PENDING" , "amount" : 0 , "payment_date" : "2026-04-16T14:13:28.423Z" , "payment_method" : { "id" : 0 , "create_date" : "2026-04-16T14:13:28.423Z" , "update_date" : "2026-04-16T14:13:28.423Z" , "processor" : "string" , "label" : "string" } , "stripe_intent_id" : "string" , "create_date" : "2026-04-16T14:13:28.423Z" , "update_date" : "2026-04-16T14:13:28.423Z" } , "state" : "OPEN" , "amount" : 0 , "completed_date" : "2026-04-16T14:13:28.423Z" , "frequency" : 0 , "cost_example_quantity" : 0 , "payment_method_processor" : "string" , "payment_method_label" : "string" , "payment_method_id" : 0 } ] , "count" : 0 } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-checkouts-rest-api-checkouts-list il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Donations Get Donations Get Donations Get Path Parameters donation_id Donation Id required Responses 200 OK application/json Schema Example (from schema) Schema id Id required supporter_id Supporter Id required campaign_id Campaign Id required code Code required state DonationState required Possible values: [ draft , pending , active , past_due , done , revoked ] An enumeration. amount Amount required receipt_url Receipt Url frequency Frequency Possible values: [ 0 , 12 , 1 ] An enumeration. note Note completed_date date-time create_date date-time required update_date date-time required device Device tags string[] required { "id" : 0 , "supporter_id" : 0 , "campaign_id" : 0 , "code" : "string" , "state" : "draft" , "amount" : 0 , "receipt_url" : "string" , "frequency" : 0 , "note" : "string" , "completed_date" : "2026-04-16T14:13:28.416Z" , "create_date" : "2026-04-16T14:13:28.416Z" , "update_date" : "2026-04-16T14:13:28.416Z" , "device" : "string" , "tags" : [ "string" ] } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-donations-rest-api-donations-get il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Donations List Donations List Donations List Query Parameters q Q archived Archived order Order create_date_from date create_date_to date update_date_from date update_date_to date limit Limit Possible values: >= 1 Default value: 100 offset Offset Responses 200 OK application/json Schema Example (from schema) Schema items object[] Array [ id Id required supporter_id Supporter Id required campaign_id Campaign Id required code Code required state DonationState required Possible values: [ draft , pending , active , past_due , done , revoked ] An enumeration. amount Amount required receipt_url Receipt Url frequency Frequency Possible values: [ 0 , 12 , 1 ] An enumeration. note Note completed_date date-time create_date date-time required update_date date-time required device Device tags string[] required ] count Count required { "items" : [ { "id" : 0 , "supporter_id" : 0 , "campaign_id" : 0 , "code" : "string" , "state" : "draft" , "amount" : 0 , "receipt_url" : "string" , "frequency" : 0 , "note" : "string" , "completed_date" : "2026-04-16T14:13:28.414Z" , "create_date" : "2026-04-16T14:13:28.414Z" , "update_date" : "2026-04-16T14:13:28.414Z" , "device" : "string" , "tags" : [ "string" ] } ] , "count" : 0 } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-donations-rest-api-donations-list il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Payments Get Payments Get Payments Get Path Parameters payment_id Payment Id required Responses 200 OK application/json Schema Example (from schema) Schema id Id required donation_id Donation Id required state PaymentState required Possible values: [ PENDING , PAID , REFUNDED , FAILED ] An enumeration. amount Amount required payment_date date-time payment_method object id Id required create_date date-time required update_date date-time required processor Processor required label Label required stripe_intent_id Stripe Intent Id create_date date-time required update_date date-time required { "id" : 0 , "donation_id" : 0 , "state" : "PENDING" , "amount" : 0 , "payment_date" : "2026-04-16T14:13:28.420Z" , "payment_method" : { "id" : 0 , "create_date" : "2026-04-16T14:13:28.420Z" , "update_date" : "2026-04-16T14:13:28.420Z" , "processor" : "string" , "label" : "string" } , "stripe_intent_id" : "string" , "create_date" : "2026-04-16T14:13:28.420Z" , "update_date" : "2026-04-16T14:13:28.420Z" } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-payments-rest-api-payments-get il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Payments List Payments List Payments List Query Parameters q Q order Order state PaymentState[] Possible values: [ PENDING , PAID , REFUNDED , FAILED ] payment_date_from date payment_date_to date create_date_from date create_date_to date update_date_from date update_date_to date limit Limit Possible values: >= 1 Default value: 100 offset Offset Responses 200 OK application/json Schema Example (from schema) Schema items object[] Array [ id Id required donation_id Donation Id required state PaymentState required Possible values: [ PENDING , PAID , REFUNDED , FAILED ] An enumeration. amount Amount required payment_date date-time payment_method object id Id required create_date date-time required update_date date-time required processor Processor required label Label required stripe_intent_id Stripe Intent Id create_date date-time required update_date date-time required ] count Count required { "items" : [ { "id" : 0 , "donation_id" : 0 , "state" : "PENDING" , "amount" : 0 , "payment_date" : "2026-04-16T14:13:28.419Z" , "payment_method" : { "id" : 0 , "create_date" : "2026-04-16T14:13:28.419Z" , "update_date" : "2026-04-16T14:13:28.419Z" , "processor" : "string" , "label" : "string" } , "stripe_intent_id" : "string" , "create_date" : "2026-04-16T14:13:28.419Z" , "update_date" : "2026-04-16T14:13:28.419Z" } ] , "count" : 0 } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-payments-rest-api-payments-list il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Supporters Create Supporters Create Supporters Create application/json Request Body required image Image business_name Business Name first_name First Name last_name Last Name supporter_type object An enumeration. email Email phone Phone mobile Mobile sex Sex Possible values: [ MALE , FEMALE ] An enumeration. date_of_birth date place_of_birth Place Of Birth job Job ssn Ssn vat Vat address Address address2 Address2 city City locality Locality country Country postal_code Postal Code email_marketing Email Marketing Default value: false phone_marketing Phone Marketing Default value: false sms_marketing Sms Marketing Default value: false postal_marketing Postal Marketing Default value: false profilation_marketing Profilation Marketing Default value: false note Note certification_url Certification Url tags string[] Default value: [] Responses 200 OK application/json Schema Example (from schema) Schema id Id required create_date date-time required image Image code Code business_name Business Name first_name First Name last_name Last Name email Email phone Phone mobile Mobile job Job sex Sex Possible values: [ MALE , FEMALE ] An enumeration. date_of_birth date place_of_birth Place Of Birth ssn Ssn vat Vat address Address address2 Address2 city City locality Locality country Country postal_code Postal Code certification_url Certification Url privacy Privacy email_marketing Email Marketing phone_marketing Phone Marketing sms_marketing Sms Marketing postal_marketing Postal Marketing profilation_marketing Profilation Marketing tags string[] required note Note { "id" : 0 , "create_date" : "2026-04-16T14:13:28.409Z" , "image" : "string" , "code" : "string" , "business_name" : "string" , "first_name" : "string" , "last_name" : "string" , "email" : "string" , "phone" : "string" , "mobile" : "string" , "job" : "string" , "sex" : "MALE" , "date_of_birth" : "2026-04-16" , "place_of_birth" : "string" , "ssn" : "string" , "vat" : "string" , "address" : "string" , "address2" : "string" , "city" : "string" , "locality" : "string" , "country" : "string" , "postal_code" : "string" , "certification_url" : "string" , "privacy" : true , "email_marketing" : true , "phone_marketing" : true , "sms_marketing" : true , "postal_marketing" : true , "profilation_marketing" : true , "tags" : [ "string" ] , "note" : "string" } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-supporters-rest-api-supporters-create il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Supporters Get Supporters Get Supporters Get Path Parameters supporter_id Supporter Id required Responses 200 OK application/json Schema Example (from schema) Schema id Id required create_date date-time required image Image code Code business_name Business Name first_name First Name last_name Last Name email Email phone Phone mobile Mobile job Job sex Sex Possible values: [ MALE , FEMALE ] An enumeration. date_of_birth date place_of_birth Place Of Birth ssn Ssn vat Vat address Address address2 Address2 city City locality Locality country Country postal_code Postal Code certification_url Certification Url privacy Privacy email_marketing Email Marketing phone_marketing Phone Marketing sms_marketing Sms Marketing postal_marketing Postal Marketing profilation_marketing Profilation Marketing tags string[] required note Note { "id" : 0 , "create_date" : "2026-04-16T14:13:28.410Z" , "image" : "string" , "code" : "string" , "business_name" : "string" , "first_name" : "string" , "last_name" : "string" , "email" : "string" , "phone" : "string" , "mobile" : "string" , "job" : "string" , "sex" : "MALE" , "date_of_birth" : "2026-04-16" , "place_of_birth" : "string" , "ssn" : "string" , "vat" : "string" , "address" : "string" , "address2" : "string" , "city" : "string" , "locality" : "string" , "country" : "string" , "postal_code" : "string" , "certification_url" : "string" , "privacy" : true , "email_marketing" : true , "phone_marketing" : true , "sms_marketing" : true , "postal_marketing" : true , "profilation_marketing" : true , "tags" : [ "string" ] , "note" : "string" } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-supporters-rest-api-supporters-get il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Supporters List Supporters List Supporters List Query Parameters q Q order Order type SupporterType Possible values: [ INDIVIDUAL , COMPANY , ORGANIZATION , FAMILY , GROUP ] An enumeration. city City country Country date_of_birth_from date date_of_birth_to date email_marketing Email Marketing phone_marketing Phone Marketing create_date_from date create_date_to date update_date_from date update_date_to date phone Phone ssn Ssn email Email limit Limit Possible values: >= 1 Default value: 100 offset Offset Responses 200 OK application/json Schema Example (from schema) Schema items object[] Array [ id Id required create_date date-time required image Image code Code business_name Business Name first_name First Name last_name Last Name email Email phone Phone mobile Mobile job Job sex Sex Possible values: [ MALE , FEMALE ] An enumeration. date_of_birth date place_of_birth Place Of Birth ssn Ssn vat Vat address Address address2 Address2 city City locality Locality country Country postal_code Postal Code certification_url Certification Url privacy Privacy email_marketing Email Marketing phone_marketing Phone Marketing sms_marketing Sms Marketing postal_marketing Postal Marketing profilation_marketing Profilation Marketing tags string[] required note Note ] count Count required { "items" : [ { "id" : 0 , "create_date" : "2026-04-16T14:13:28.407Z" , "image" : "string" , "code" : "string" , "business_name" : "string" , "first_name" : "string" , "last_name" : "string" , "email" : "string" , "phone" : "string" , "mobile" : "string" , "job" : "string" , "sex" : "MALE" , "date_of_birth" : "2026-04-16" , "place_of_birth" : "string" , "ssn" : "string" , "vat" : "string" , "address" : "string" , "address2" : "string" , "city" : "string" , "locality" : "string" , "country" : "string" , "postal_code" : "string" , "certification_url" : "string" , "privacy" : true , "email_marketing" : true , "phone_marketing" : true , "sms_marketing" : true , "postal_marketing" : true , "profilation_marketing" : true , "tags" : [ "string" ] , "note" : "string" } ] , "count" : 0 } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-supporters-rest-api-supporters-list il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Supporters Update Supporters Update Supporters Update Path Parameters supporter_id Supporter Id required application/json Request Body required image Image business_name Business Name first_name First Name last_name Last Name supporter_type object An enumeration. email Email phone Phone mobile Mobile sex Sex Possible values: [ MALE , FEMALE ] An enumeration. date_of_birth date place_of_birth Place Of Birth job Job ssn Ssn vat Vat address Address address2 Address2 city City locality Locality country Country postal_code Postal Code email_marketing Email Marketing Default value: false phone_marketing Phone Marketing Default value: false sms_marketing Sms Marketing Default value: false postal_marketing Postal Marketing Default value: false profilation_marketing Profilation Marketing Default value: false note Note certification_url Certification Url tags string[] Default value: [] Responses 200 OK application/json Schema Example (from schema) Schema id Id required create_date date-time required image Image code Code business_name Business Name first_name First Name last_name Last Name email Email phone Phone mobile Mobile job Job sex Sex Possible values: [ MALE , FEMALE ] An enumeration. date_of_birth date place_of_birth Place Of Birth ssn Ssn vat Vat address Address address2 Address2 city City locality Locality country Country postal_code Postal Code certification_url Certification Url privacy Privacy email_marketing Email Marketing phone_marketing Phone Marketing sms_marketing Sms Marketing postal_marketing Postal Marketing profilation_marketing Profilation Marketing tags string[] required note Note { "id" : 0 , "create_date" : "2026-04-16T14:13:28.412Z" , "image" : "string" , "code" : "string" , "business_name" : "string" , "first_name" : "string" , "last_name" : "string" , "email" : "string" , "phone" : "string" , "mobile" : "string" , "job" : "string" , "sex" : "MALE" , "date_of_birth" : "2026-04-16" , "place_of_birth" : "string" , "ssn" : "string" , "vat" : "string" , "address" : "string" , "address2" : "string" , "city" : "string" , "locality" : "string" , "country" : "string" , "postal_code" : "string" , "certification_url" : "string" , "privacy" : true , "email_marketing" : true , "phone_marketing" : true , "sms_marketing" : true , "postal_marketing" : true , "profilation_marketing" : true , "tags" : [ "string" ] , "note" : "string" } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-supporters-rest-api-supporters-update il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Supporters Delete Supporters Delete Supporters Delete Path Parameters supporter_id Supporter Id required Responses 200 OK application/json Schema Example (from schema) Schema id Id required create_date date-time required image Image code Code business_name Business Name first_name First Name last_name Last Name email Email phone Phone mobile Mobile job Job sex Sex Possible values: [ MALE , FEMALE ] An enumeration. date_of_birth date place_of_birth Place Of Birth ssn Ssn vat Vat address Address address2 Address2 city City locality Locality country Country postal_code Postal Code certification_url Certification Url privacy Privacy email_marketing Email Marketing phone_marketing Phone Marketing sms_marketing Sms Marketing postal_marketing Postal Marketing profilation_marketing Profilation Marketing tags string[] required note Note { "id" : 0 , "create_date" : "2026-04-16T14:13:28.413Z" , "image" : "string" , "code" : "string" , "business_name" : "string" , "first_name" : "string" , "last_name" : "string" , "email" : "string" , "phone" : "string" , "mobile" : "string" , "job" : "string" , "sex" : "MALE" , "date_of_birth" : "2026-04-16" , "place_of_birth" : "string" , "ssn" : "string" , "vat" : "string" , "address" : "string" , "address2" : "string" , "city" : "string" , "locality" : "string" , "country" : "string" , "postal_code" : "string" , "certification_url" : "string" , "privacy" : true , "email_marketing" : true , "phone_marketing" : true , "sms_marketing" : true , "postal_marketing" : true , "profilation_marketing" : true , "tags" : [ "string" ] , "note" : "string" } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-supporters-rest-api-supporters-delete il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Webhooks Create Webhooks Create Webhooks Create application/json Request Body required topics WebhookEventTopic[] required Possible values: [ supporter.created , supporter.updated , supporter.deleted , checkout.created , checkout.updated , checkout.paid , checkout.closed , donation.created , donation.deleted , donation.updated , payment.created , payment.updated , campaign.created , campaign.updated , campaign.deleted ] url Url required Responses 200 OK application/json Schema Example (from schema) Schema id Id required topics WebhookEventTopic[] required Possible values: [ supporter.created , supporter.updated , supporter.deleted , checkout.created , checkout.updated , checkout.paid , checkout.closed , donation.created , donation.deleted , donation.updated , payment.created , payment.updated , campaign.created , campaign.updated , campaign.deleted ] url Url required { "id" : 0 , "topics" : [ "supporter.created" ] , "url" : "string" } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-notifications-rest-api-webhooks-create il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Webhooks Get Webhooks Get Webhooks Get Path Parameters webhook_id Webhook Id required Responses 200 OK application/json Schema Example (from schema) Schema id Id required topics WebhookEventTopic[] required Possible values: [ supporter.created , supporter.updated , supporter.deleted , checkout.created , checkout.updated , checkout.paid , checkout.closed , donation.created , donation.deleted , donation.updated , payment.created , payment.updated , campaign.created , campaign.updated , campaign.deleted ] url Url required { "id" : 0 , "topics" : [ "supporter.created" ] , "url" : "string" } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-notifications-rest-api-webhooks-get il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Webhooks List Webhooks List Webhooks List Responses 200 OK application/json Schema Example (from schema) Schema Array [ id Id required topics WebhookEventTopic[] required Possible values: [ supporter.created , supporter.updated , supporter.deleted , checkout.created , checkout.updated , checkout.paid , checkout.closed , donation.created , donation.deleted , donation.updated , payment.created , payment.updated , campaign.created , campaign.updated , campaign.deleted ] url Url required ] [ { "id" : 0 , "topics" : [ "supporter.created" ] , "url" : "string" } ] Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-notifications-rest-api-webhooks-list il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Webhooks Update Webhooks Update Webhooks Update Path Parameters webhook_id Webhook Id required application/json Request Body required topics WebhookEventTopic[] required Possible values: [ supporter.created , supporter.updated , supporter.deleted , checkout.created , checkout.updated , checkout.paid , checkout.closed , donation.created , donation.deleted , donation.updated , payment.created , payment.updated , campaign.created , campaign.updated , campaign.deleted ] url Url required Responses 200 OK application/json Schema Example (from schema) Schema id Id required topics WebhookEventTopic[] required Possible values: [ supporter.created , supporter.updated , supporter.deleted , checkout.created , checkout.updated , checkout.paid , checkout.closed , donation.created , donation.deleted , donation.updated , payment.created , payment.updated , campaign.created , campaign.updated , campaign.deleted ] url Url required { "id" : 0 , "topics" : [ "supporter.created" ] , "url" : "string" } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-notifications-rest-api-webhooks-update il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. REST - Webhooks Delete Webhooks Delete Webhooks Delete Path Parameters webhook_id Webhook Id required Responses 200 OK application/json Schema Example (from schema) Schema id Id required topics WebhookEventTopic[] required Possible values: [ supporter.created , supporter.updated , supporter.deleted , checkout.created , checkout.updated , checkout.paid , checkout.closed , donation.created , donation.deleted , donation.updated , payment.created , payment.updated , campaign.created , campaign.updated , campaign.deleted ] url Url required { "id" : 0 , "topics" : [ "supporter.created" ] , "url" : "string" } Loading... Contenuto importato da https://dev.riseact.org/docs/rest-references/riseact-app-notifications-rest-api-webhooks-delete il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. CLI e SDK Panoramica CLI La CLI di Riseact è uno strumento che ti permette di creare, sviluppare e distribuire applicazioni che si integrano direttamente con la piattaforma Riseact. Puoi utilizzare la CLI per creare un nuovo progetto, Funzionalità creare una nuova applicazione con un template predefinito distribuire l'applicazione su Riseact Requisiti Avere Git installato Un token ngrok per creare un tunnel per il server di sviluppo Utilizzare l'ultima versione di Chrome o Firefox Come iniziare Per cominciare è necessario installare la CLI di Riseact. Per farlo, scarica la versione del tuo sistema operativo da questa pagina Una volta scaricato il file, estrai il contenuto e spostati nella cartella tramite il terminale. Per utilizzare la CLI è necessario aver configurato un account Partner, se non lo hai ancora fatto segui questa guida Una volta configurato l'account, esegui il comando $ riseact auth login e inserisci le credenziali del tuo account Partner. Assicurati di aver registrato un'applicazione su Riseact. Crea inizialmente un'applicazione privata su un organizzazione di sviluppo, in modo da poter testare l'applicazione senza pubblicarla. Una volta fatto potrai inizializzare un nuovo progetto, utilizzando il comando $ riseact app init e segui le istruzioni a schermo. Questo comando creerà una nuova cartella con il nome dell'applicazione e all'interno troverai i file necessari per iniziare a sviluppare. Per sviluppare l'applicazione, spostati all'interno della cartella e avvia il server di sviluppo con il comando $ riseact app dev Questo comando avvierà un server locale e un tunnel ngrok per permetterti di testare l'applicazione su Riseact. A questo punto accedi alla tua organizzazione di sviluppo su Riseact e vai alla lista delle applicazioni private , da li potrai attivare l'applicazione e testarla. Contenuto importato da https://dev.riseact.org/docs/cli/overview il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Struttura dell'app Il template Node delle applicazioni Riseact è progettato per essere flessibile e adattabile a diversi tipi di progetti. Fornisce una struttura di base per l'applicazione, ma è possibile personalizzarla in base alle proprie esigenze. Struttura di base La struttura di base di un'applicazione Riseact è la seguente: ├── client │ ├── index.html │ ├── LICENSE │ ├── package.json │ ├── public │ │ └── riseact.png │ ├── src │ │ ├── assets │ │ │ └── react.svg │ │ ├── components │ │ │ ├── Navbar │ │ │ │ ├── index.tsx │ │ │ │ └── NavButton.tsx │ │ │ └── Page │ │ │ └── index.tsx │ │ ├── config │ │ │ ├── network.ts │ │ │ └── routing.ts │ │ ├── hooks │ │ │ └── useOrganization.ts │ │ ├── main.tsx │ │ ├── Router.tsx │ │ ├── routes │ │ │ ├── Campaigns │ │ │ │ ├── Create.tsx │ │ │ │ ├── Detail.tsx │ │ │ │ ├── Form.tsx │ │ │ │ ├── index.tsx │ │ │ │ └── List │ │ │ │ ├── Filters.tsx │ │ │ │ ├── index.tsx │ │ │ │ └── VisibilityBadge.tsx │ │ │ └── Home │ │ │ └── index.tsx │ │ ├── utils │ │ │ └── enumTranslate.ts │ │ └── vite-env.d.ts │ ├── tsconfig.json │ └── vite.config.ts ├── common │ ├── gql-codegen.ts │ ├── package.json │ ├── src │ │ ├── gql │ │ │ ├── fragment-masking.ts │ │ │ ├── gql.ts │ │ │ ├── graphql.ts │ │ │ └── index.ts │ │ ├── queries.ts │ │ └── types.ts │ └── tsconfig.json ├── Dockerfile ├── LICENSE ├── package.json ├── package-lock.json ├── prisma │ ├── migrations │ │ ├── 20231031142218_init │ │ │ └── migration.sql │ │ └── migration_lock.toml │ └── schema.prisma ├── README.md ├── server │ ├── package.json │ ├── src │ │ ├── config │ │ │ ├── database.ts │ │ │ └── riseact.ts │ │ ├── controllers │ │ │ └── organization.ts │ │ ├── env.d.ts │ │ └── index.ts │ └── tsconfig.json ├── tsconfig.build.json └── tsconfig.json Client La cartella client contiene il codice dell'applicazione front-end. Questa cartella è strutturata in modo da separare i componenti, le pagine, i hooks e le utility in cartelle separate. index.html : file HTML principale dell'applicazione package.json : file di configurazione del progetto public : cartella contenente i file statici dell'applicazione src : cartella contenente il codice sorgente dell'applicazione assets : cartella contenente i file multimediali components : cartella contenente i componenti dell'applicazione config : cartella contenente i file di configurazione hooks : cartella contenente i custom hooks main.tsx : file principale dell'applicazione Router.tsx : file contenente la definizione delle rotte routes : cartella contenente le pagine dell'applicazione utils : cartella contenente le utility Common La cartella common contiene il codice condiviso tra il client e il server. Questa cartella è strutturata in modo da separare le query GraphQL, i tipi e i file di configurazione. gql-codegen.ts : file di configurazione per la generazione dei tipi GraphQL package.json : file di configurazione del progetto src : cartella contenente il codice sorgente condiviso gql : cartella contenente i file GraphQL queries.ts : file contenente le query GraphQL types.ts : file contenente i tipi TypeScript Server La cartella server contiene il codice dell'applicazione back-end. Questa cartella è strutturata in modo da separare i controller, i file di configurazione e i file di ambiente. package.json : file di configurazione del progetto src : cartella contenente il codice sorgente dell'applicazione config : cartella contenente i file di configurazione controllers : cartella contenente i controller dell'applicazione env.d.ts : file di definizione dei tipi per le variabili d'ambiente index.ts : file principale dell'applicazione Altri file Dockerfile : file di configurazione per la creazione dell'immagine Docker LICENSE : file di licenza del progetto package.json : file di configurazione del progetto package-lock.json : file di lock delle dipendenze prisma : cartella contenente i file di configurazione di Prisma README.md : file di descrizione del progetto tsconfig.build.json : file di configurazione per la compilazione del progetto tsconfig.json : file di configurazione TypeScript del progetto Contenuto importato da https://dev.riseact.org/docs/cli/app_structure il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Riseact Totem Introduzione a Riseact Totem Riseact Totem è un'applicazione mobile che consente alle organizzazioni di raccogliere fondi tramite un dispositivo in modalità Kiosk. L'applicazione è stata progettata per essere semplice da utilizzare e per offrire funzionalità avanzate per la gestione dei form e dei checkouts, semplificando il processo di fundraising per le organizzazioni. Locations La location è un concetto utilizzato nel servizio di Stripe Terminal (su cui Riseact si appoggia), che è un prodotto di Stripe progettato per gestire i pagamenti fisici. Stripe Terminal consente di creare applicazioni di pagamento personalizzate per punti donazione fisici, come totem o stand. Una "location" in questo contesto rappresenta un luogo fisico dove si svolge l'attività di raccolta fondi. Ad esempio, se stai raccogliendo fondi ad uno spettacolo presso un ristorante, la "location" sarebbe l'indirizzo fisico del ristorante. Ogni "location" in Stripe ha un ID unico e può avere uno o più lettori di carte associati. Questo permette a Stripe di tracciare da quale "location" proviene un determinato pagamento, il che può essere utile per la contabilità e l'analisi delle vendite. Inoltre, quando si crea una "location", si può anche specificare un insieme di impostazioni di default per quella "location", come le impostazioni fiscali. Questo può semplificare la gestione dei pagamenti se si hanno molte "locations" diverse. Terminali Un terminale POS (Point of Sale) è un dispositivo utilizzato nei punti vendita al dettaglio per eseguire transazioni di vendita. Un terminale POS può accettare vari metodi di pagamento, tra cui carte di credito, carte di debito e pagamenti mobili. I terminali sono supportati da Riseact sono i seguenti: WisePad 3 WisePos E Totems I totem sono stand fisici che consentono ai sostenitori di effettuare donazioni tramite carta di credito. I totem sono dotati di un lettore di carte di credito e di un display touch screen che consente ai sostenitori di effettuare donazioni in modo semplice e intuitivo. Per utilizzare un totem, è necessario configurare il tuo totem dalla pagina di amministrazione di Riseact e possedere un WisePOS E. Segui questa guida per sapere come fare. Riseact Kiosk Riseact Kiosk è l'applicazione per dispositivi mobili che consente alle organizzazioni di raccogliere fondi tramite un dispositivo in modalità Kiosk. L'applicazione è stata progettata per essere semplice da utilizzare e per offrire funzionalità avanzate per la gestione dei form e dei checkouts, semplificando il processo di fundraising per le organizzazioni. È possibile scaricare l'applicazione da Google Play Store. Riseact POD Riseact POD è un applicazione che ti consente di raccogliere fondi ovunque tu sia! Con riseact POD puoi raccogliere e registrare donazioni con pagamenti manuali, carte, e POS (acquistando un WisePAD 3). Puoi anche registrare e gestire i tuoi Totem e Locations, registrare nuovi sostenitori e molto altro ancora. È possibile scaricare l'applicazione da Google Play Store. Contenuto importato da https://dev.riseact.org/docs/riseact-totem/introduction il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Configurazione di Riseact Totem I totem sono dispositivi che consentono ai sostenitori di effettuare donazioni tramite carta di credito. I totem sono dotati di un lettore di carte di credito e di un display touch screen che consente ai sostenitori di effettuare donazioni in modo semplice e intuitivo. Per utilizzare un totem, è necessario configurare il tuo totem dalla pagina di amministrazione di Riseact e possedere un WisePOS E. Attenzione: il dispositivo e WisePOS devono essere connessi alla stessa rete WiFi. Prima accensione e configurazione di WisePOS E Alla prima accensione, il terminale WisePOS E va configurato e connesso a una rete wifi. Per farlo, segui le istruzioni sul display del terminale. Una volta connesso, scegli la lingua del dispositivo e il paese in cui effettuerai le transazioni. Attendi che il dispositivo si aggiorni e si riavvii. Una volta riavviato, trascina con il dito il bordo sinistro del touchscreen verso destra, apparirà un menu laterale. Clicca su "Impostazioni" e inserisci la PIN di default "07139" . Clicca poi su "Genera codice di accoppiamento". Verrà generato un codice composto da 3 parole separate da un trattino. Segui la procedura di accoppiamento descritta nella sezione successiva. Configurazione del dispositivo Android Per utilizzare il tuo dispositivo Android come totem, è necessario installare l'applicazione Riseact Kiosk. L'applicazione è disponibile su Google Play Store. Il dispositivo va connesso alla rete wifi del terminale WisePOS E. Una volta scaricata l'applicazione, segui uno dei 2 metodi di configurazione descritti di seguito. 1. Configurazione del totem tramite pannello di amministrazione Riseact Admin Per configurare il tuo totem, accedi alla pagina di amministrazione di Riseact all'indirizzo https://admin.riseact.org . Creazione di una location Se non l'hai ancora fatto, crea una location dal menù Punti di Donazione > Locations. Una Location rappresenta un luogo fisico dove si svolge l'attività di raccolta fondi. Ad esempio, se stai raccogliendo fondi ad uno spettacolo presso un ristorante, la "location" sarebbe l'indirizzo fisico del ristorante. Associazione del POS Ora accendi il tuo POS e trascina con il dito il bordo sinistro del touchscreen verso destra, apparirà un menu laterale. Clicca su "Impostazioni" e inserisci il PIN di default "07139" . Clicca poi su "Genera codice di accoppiamento". Verrà generato un codice composto da 3 parole separate da un trattino. Torna alla tua pagina su Riseact Admin e registra ora il tuo WisePOS E cliccando sul pulsante "Registra terminale" in alto a destra. Inserisci il codice che vedi sul tuo POS, un nome a tua scelta per identificarlo e clicca su "Salva". Il tuo POS è ora registrato e pronto per essere utilizzato! e andiamo a creare un totem dal menù Punti di Donazione > Totems. Associazione del totem Clicca sul pulsante "Registra Totem" in alto a destra e compila il form con un nome a tua scelta del totem. Nel campo "Codice di Registrazione" inserisci il codice alfanumerico di 16 caratteri che vedi apparire sotto il QR code dell'applicazione Riseact Kiosk. Nel campo "terminale" seleziona il terminale che hai registrato in precedenza. Clicca su "Salva", dopo qualche istante vedrai apparire sullo schermo del totem il form di donazione. Ecco fatto! Per personalizzare l'aspetto del totem, consulta la (pagina dedicata) [/docs/riseact-totem/customization] . 2. Configurazione del totem tramite Riseact POD Se non l'hai ancora fatto, scarica l'applicazione Riseact POD da un dispositivo a tua scelta che non sia il dispositivo preposto a diventare il tuo totem. L'applicazione è disponibile su Google Play Store e su App Store. Accedi con il nome utente e password del tuo account Riseact. Se non hai ancora un account, puoi crearne uno dal sito https://admin.riseact.org . Clicca sul pulsante "Altro" nella parte bassa dello schermo e poi su Totem. Clicca su "Aggiungi Totem" Creazione di una location Se non l'hai ancora fatto, crea una location cliccando sul menu "Location" e poi sul pulsante "Crea Location". Una Location rappresenta un luogo fisico dove si svolge l'attività di raccolta fondi. Ad esempio, se stai raccogliendo fondi ad uno spettacolo presso un ristorante, la "location" sarebbe l'indirizzo fisico del ristorante. Associazione del POS Attualmente l'associazione del POS è possibile solo tramite il pannello di amministrazione Riseact Admin. Per associare il tuo POS, segui le istruzioni descritte in questa sezione. Associazione del totem Clicca sul pulsante "Totem" e poi su "Aggiungi Totem". Con la fotocamera del tuo smartphone inquadra il QR Code presente sul display del tuo totem. Dopo qualche istante vedrai apparire sullo schermo del totem il form di donazione. Contenuto importato da https://dev.riseact.org/docs/riseact-totem/setup il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia. Personalizzazione Riseact Totem Il form di donazione può essere personalizzato tramite il pannello di amministrazione di Riseact Admin. Campagne Di default l'applicazione totem mostra tutte le campagne che sono pubblicate sul canale "Punto di donazione". Se vuoi mostrare solo una sola campagna (e saltare il primo step del form) puoi impostare una campagna predefinita dal pannello di amministrazione di Riseact Admin. Clicca dal menu laterale su "Punti di donazione" e poi "Totems". Clicca sul nome del totem che vuoi personalizzare. Dal campo "campagna" seleziona la campagna che vuoi mostrare di default. Se vuoi mostrare tutte le campagne, lascia il campo vuoto. Immagine campagna L'immagine della campagna verrà mostrata di default in alto sulla pagina di donazione. Se vuoi mostrare un immagine diversa, puoi impostarla dalla pagina di dettaglio della campagna Immagine a piè di pagina Se vuoi mostrare un immagine aggiuntiva oltre a quella della campagna, clicca dal menu laterale su "Punti di donazione" e poi "Totems". Clicca su aggiungi immagine sul riquadro a destra e carica l'immagine che vuoi mostrare. L'immagine verrà mostrata in basso sulla pagina di donazione. Contenuto importato da https://dev.riseact.org/docs/riseact-totem/customization il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia.