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.

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:

  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 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 il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia.