# 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](https://dev.riseact.org/docs/partner-apps/getting-started) 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](https://dev.riseact.org/docs/private-apps/getting-started) per integrarti con Riseact tramite applicazione privata. --- *Contenuto importato da [https://dev.riseact.org/docs/getting-started](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](https://dev.riseact.org/docs/guides/campaigns-and-forms). - **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](https://dev.riseact.org/docs/guides/campaigns-and-forms). - **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](https://dev.riseact.org/docs/guides/forms-and-checkouts). - **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](https://dev.riseact.org/docs/guides/forms-and-checkouts). - **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](https://dev.riseact.org/docs/guides/channels). - **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](https://dev.riseact.org/docs/guides/donations-and-payments). - **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](/guide/docs/donations-and-guides). --- *Contenuto importato da [https://dev.riseact.org/docs/guides/entities](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](https://dev.riseact.org/docs/guides/forms-and-checkouts). ## 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](https://dev.riseact.org/docs/guides/forms-and-checkouts). --- *Contenuto importato da [https://dev.riseact.org/docs/guides/campaings-and-forms](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](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: 1. **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. 2. **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](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: 1. **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. 2. **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. 3. **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](https://dev.riseact.org/docs/guides/channels) il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia.*