Skip to main content

Checkout prefilling

You can prefill the checkout with parameters in the query string of the campaign URL: personal details, amount, frequency and more. It works both when opening the URL directly and with the Donation Button.

Supported parameters​

ParameterTypeDescription
amountdecimalPreselected amount (e.g. 25.00)
frequencyintegerFrequency: 0 = one-time, 12 = monthly
legal_personstringType of person: INDIVIDUAL or COMPANY
first_namestringFirst name
last_namestringLast name
emailstringEmail address
phonestringPhone
mobilestringMobile
business_namestringCompany name (for legal entities)
ssnstringTax code
vatstringVAT number
addressstringAddress
citystringCity
localitystringProvince / locality
postal_codestringPostal code
countrystringCountry
supporter_idintegerID of an existing supporter
cost_exampleUUIDID of a preselected cost example
cost_example_quantityintegerQuantity for the cost example (greater than 0)
tags[]arrayTags to associate with the checkout (tags[]=a&tags[]=b)
cf[<key>]depends on the fieldValue of a custom field (cf[codice-evento]=ABC)

Custom fields​

To prefill a custom field use cf[<key>], where the key is the one shown in Settings > Custom fields. It works for both donation and supporter fields.

Field typeAccepted values
Textany text
Booleantrue, 1, yes or false, 0, no
DateYYYY-MM-DD format (e.g. 2026-10-16)
Selectone of the field options, written exactly as defined

An invalid value or an unknown key is ignored: the checkout still opens, without that field. The value is stored even when the field is not shown in the campaign, so you can use a hidden field to track the source.

https://tua-org.riseact.site/campaigns/nome-campagna/donate?amount=25&cf[codice-evento]=ABC&cf[newsletter-cartacea]=true
note

If supporter_id is set, the personal fields (legal_person, first_name, last_name, email, phone, mobile, business_name, ssn, vat, address, address2, city, locality, postal_code, country) and the supporter custom fields are ignored. Donation custom fields still apply.

Web checkout​

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>