Prefilling del checkout
Puoi precompilare il checkout con parametri nella query string dell'URL della campagna: anagrafica, importo, frequenza e altro. Funziona sia aprendo l'URL direttamente sia con il Donation Button.
Parametri supportati
| Parametro | Tipo | Descrizione |
|---|---|---|
amount | decimale | Importo preselezionato (es. 25.00) |
frequency | intero | Frequenza: 0 = una tantum, 12 = mensile |
legal_person | stringa | Tipo di persona: INDIVIDUAL o COMPANY |
first_name | stringa | Nome |
last_name | stringa | Cognome |
email | stringa | Indirizzo email |
phone | stringa | Telefono |
mobile | stringa | Cellulare |
business_name | stringa | Ragione sociale (per persone giuridiche) |
ssn | stringa | Codice fiscale |
vat | stringa | Partita IVA |
address | stringa | Indirizzo |
city | stringa | Città |
locality | stringa | Provincia / località |
postal_code | stringa | CAP |
country | stringa | Paese |
supporter_id | intero | ID di un sostenitore esistente |
cost_example | UUID | ID di un esempio di costo preselezionato |
cost_example_quantity | intero | Quantità per l'esempio di costo (maggiore di 0) |
tags[] | array | Tag da associare al checkout (tags[]=a&tags[]=b) |
cf[<chiave>] | dipende dal campo | Valore di un campo personalizzato (cf[codice-evento]=ABC) |
Campi personalizzati
Per precompilare un campo personalizzato usa cf[<chiave>], dove la chiave è quella
che vedi in Impostazioni > Dati personalizzati. Vale sia per i campi della donazione
sia per quelli del sostenitore.
| Tipo di campo | Valori accettati |
|---|---|
| Testo | qualsiasi testo |
| Booleano | true, 1, yes oppure false, 0, no |
| Data | formato AAAA-MM-GG (es. 2026-10-16) |
| Selezione | una delle opzioni del campo, scritta esattamente come è definita |
Un valore non valido o una chiave che non esiste vengono ignorati: il checkout si apre comunque, senza quel campo. Il valore viene salvato anche se il campo non è mostrato nella campagna, quindi puoi usare un campo nascosto per tracciare la provenienza.
https://tua-org.riseact.site/campaigns/nome-campagna/donate?amount=25&cf[codice-evento]=ABC&cf[newsletter-cartacea]=true
Se c'è supporter_id, i campi anagrafici (legal_person, first_name, last_name,
email, phone, mobile, business_name, ssn, vat, address, address2,
city, locality, postal_code, country) e i campi personalizzati del sostenitore
vengono ignorati. I campi personalizzati della donazione restano validi.
Checkout web
https://tua-org.riseact.site/campaigns/nome-campagna/donate?email=mario.rossi@esempio.it&first_name=Mario&amount=25&frequency=0
Donation Button
<script>
(window.riseactDonateBtns = window.riseactDonateBtns || []).push({
checkoutUrl: "https://tua-org.riseact.site/campaigns/nome-campagna/donate?email=mario.rossi@esempio.it&first_name=Mario&amount=25&frequency=0"
})
</script>