Passa al contenuto principale

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​

ParametroTipoDescrizione
amountdecimaleImporto preselezionato (es. 25.00)
frequencyinteroFrequenza: 0 = una tantum, 12 = mensile
legal_personstringaTipo di persona: INDIVIDUAL o COMPANY
first_namestringaNome
last_namestringaCognome
emailstringaIndirizzo email
phonestringaTelefono
mobilestringaCellulare
business_namestringaRagione sociale (per persone giuridiche)
ssnstringaCodice fiscale
vatstringaPartita IVA
addressstringaIndirizzo
citystringaCittà
localitystringaProvincia / località
postal_codestringaCAP
countrystringaPaese
supporter_idinteroID di un sostenitore esistente
cost_exampleUUIDID di un esempio di costo preselezionato
cost_example_quantityinteroQuantità per l'esempio di costo (maggiore di 0)
tags[]arrayTag da associare al checkout (tags[]=a&tags[]=b)
cf[<chiave>]dipende dal campoValore 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 campoValori accettati
Testoqualsiasi testo
Booleanotrue, 1, yes oppure false, 0, no
Dataformato AAAA-MM-GG (es. 2026-10-16)
Selezioneuna 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
note

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>