How to prepopulate form values with GET parameter?

All fields of the payment form can be prepopulated. The following parameters can be appended to the corresponding url. These variables can be appended to the javascript embed code or directly to the url address.

👍
This API is available in all FundraisingBox plans.

Fieldnames and values

Name	Values	Description
salutation	Mr. \| Mrs.
title	Varchar(50)
first_name	Varchar(100)
last_name	Varchar(100)
company_name	Varchar(100)
address	Varchar(300)
post_code	Varchar(10)
city	Varchar(100)
country	2-letter ISO 3166 country code in uppercase	Set default country in dropdown, e.g. "DE" for "Germany"
email	Varchar(100)
phone	Varchar(100)
amount	Float	Without currency symbols, e.g. 5.50
interval	0 \| 1 \| 3 \| 6 \| 12	once, monthly, quarterly, half-yearly, yearly
wants_receipt	no_receipt \| receipt_now \| receipt_end_of_year	Default value: "no_receipt" A pre-populated address will be only saved with the donation if the address is selected as a form field in the form configuration or if the donor requests a donation receipt.
message	Varchar(500)
public_name	Varchar(100)
public_message	Varchar(1000)
wants_newsletter	0 \| 1
is_terms_accepted	0 \| 1
is_privacy_accepted	0 \| 1
birthday	Dateformat YYYY-MM-DD
fb_item_id	Integer	Item ids can be found at “Forms” > ”Edit” > ”Transaction settings” > ”Items” > "Info-Icon at the item", Item selection is shown and item is preselected, Item has to be visible in the form.
fb_item_id_fix	Integer	Item selection is hidden and item name is shown Special case: Item has NOT to be visible in the form.
fb_project_id	Integer	If a project is allocated to an item, this item can be preselected with the corresponding project id as well. Project ids can be found at "Configuration" > "Projects". Requirement: there is only one item with this project. Item selection is shown and item is preselected, Item has to be visible in the form.
fb_project_id_fix	Integer	Item selection is hidden and item name is shown Special case: Item has NOT to be visible in the form.
person_custom_field_ID	Mixed (depends on the custom field type)	Custom field ids can be found in “settings”>”Custom fields”. Custom field has to be added to the form. Example: to prepopulate the custom field with ID “123“ with the text “example“ use: “person_custom_field_123=example“
donation_custom_field_ID	Mixed (depends on the custom field type)	Custom field ids can be found in “settings”>”Custom fields”. Custom field has to be added to the form. Example: to prepopulate the custom field with ID “123“ with the text “example“ use: “donation_custom_field_123=example“
payment_method	directdebit \| sepa_direct_debit \| wikando_direct_debit \| micropayment_direct_debit \| bfs_direct_debit \| paypal \| sofortueberweisung \| micropayment_credit_card \| eps \| stripe_credit_card \| amazon_pay \|_stripe_apple_pay \| stripe_google_pay	Recommendation: do NOT prepopulate Apple Pay and Google Pay, because you do not know if these payment methods are available on the device of the visitor.
is_gift_donation	0 \| 1	Specifies whether it is a gift donation.
gift_donation_from_name	Varchar(30)	The name of the gift donation sender.
gift_donation_to_name	Varchar(30)	The name of the gift donation receiver.

It is recommended to url-encode values before appending them to the url, to ensure the values are propoulated correctly. If this is not done, some values might not be set as expected (e.g. +49 123456 will be preopoulated as 49123456, my-email+donation@test.de will be prepopulated as my-email donation@test.de).

Non editable prepopulation

If you do not want that the prepopulated field is editable add a "_fix" to the parameter.
For example: "first_name_fix", "amount_fix", "donation_custom_field_123_fix".

Attention: fixing values will prevent the donor to change or correct values. Use it with care.

📘
Session-API
You can use also the Session API for form value prepopulation. This offers you various advantages.