Checkout
Concetti di base e sistemi a disposizione
Il checkout Riseact è il form di donazione che guida il donatore attraverso i passi necessari per completare una donazione: anagrafica, importo, metodo di pagamento.
Puoi utilizzare quello fornito da noi o crearne uno personalizzato, utilizzando le nostre APIs.
Modalità di utilizzo
La scelta dipende da dove vive il sito web dell'organizzazione.
1. Checkout URL — pensato per chi utilizza il sito web di Riseact
Per le organizzazioni che usano il sito web creato con Riseact come sito web principale, il checkout è già integrato. Basta condividere l'URL della campagna da email, social, QR code o da qualsiasi pagina del sito.
https://tua-org.riseact.site/campaigns/nome-campagna/donate
Al completamento, il donatore viene reindirizzato alla pagina di ringraziamento: https://tua-org.riseact.site/thankyou/{token}.
2. Donation Button — per siti web esterni
Per le organizzazioni che hanno un sito web proprio e vogliono mantenere l'utente sulla pagina durante la donazione. Uno script incorporato apre il checkout in una modale sovrapposta, senza redirect.
Al completamento, la modale si chiude. Se configurato, la pagina viene reindirizzata a un URL custom (redirectUrl) — tipicamente una pagina di ringraziamento sul sito dell'organizzazione. In alternativa, l'evento checkoutCompleted può essere intercettato via postMessage per gestire il completamento con codice custom.
Vedi Donation Button per la documentazione completa.
3. Checkout personalizzato — per integrazioni avanzate
Per chi vuole costruire un form di donazione completamente custom, integrato nel proprio sito o applicazione. Il backend chiama le API autenticate di Riseact per creare la donazione direttamente; il frontend non interagisce mai con il checkout Riseact.
Al completamento, il flusso e la pagina di ringraziamento sono gestiti interamente dall'organizzazione.
→ Vedi Crea il tuo checkout personalizzato.
Come funziona il checkout form di Riseact
Quando un utente accede all'URL del checkout, ad esempio /campaigns/nome-campagna/donate, il backend crea un checkout con un token univoco e reindirizza alla URL del form con il parametro ?co=<token>. Il frontend poi carica la configurazione della campagna dal server (ad esempio campi richiesti/richiesti, metodi di pagamento abilitati ecc), valorizza i campi in caso di prefilling o dati precedentemente inseriti (il token in url permette infatti la permanenza dello stato del checkout in caso di refresh o condivisione del link).
- Utente accede a
/campaigns/nome-campagna/donate - Backend crea un token → redirect 302 a
/campaigns/nome-campagna/donate?co=<token> - Il form si carica in quattro passi: importo → anagrafica → pagamento → completato
Il token permette il salvataggio dello stato a ogni passo: i dati sopravvivono a un refresh o alla condivisione del link.
Al completamento, il donatore viene reindirizzato alla pagina di ringraziamento: https://tua-org.riseact.site/thankyou/{token}.
Configurazione della campagna
Il checkout si adatta alla configurazione della campagna: campi mostrati, campi obbligatori, importi proposti, metodi di pagamento abilitati. Queste impostazioni si gestiscono dal pannello Riseact o tramite le API autenticate.