Can I Pre-Populate Donation Forms?

A great benefit to using RaiseDonors is the ability to customize the donation form on the fly through URL parameters. RaiseDonors offers the ability to completely customize the following areas of the donation page. For example:

• Donation pages can now be personalized for the donor. You can pre-load the donation page with all of the donor's contact information filled in.
• Your team can customize the layout and settings of a page. You can overwrite the default values for source-codes, motivation-codes, recurring settings etc., which prevent the need to create duplicate pages for small changes.
• Your team can customize the pre-selected amount on the donation page when it loads. This is great if you know the giving capacity of the donor, you can customize the giving thresholds per donor!
• Meta information can be customized allowing for an unlimited number of attributions.

Using the parameters

To get started you need to know how to build URLs with multiple parameters. As an example, a link to customize the form's amount, billing country, and comment would look like this:

https://raisedonors.com/{your-org}/{your-page-name}/?amt = 150 & billingCountry =USA&comment=some-custom-provided-comment

It's important to note the following:

• the first parameter is prepended with "?"
• all subsequent parameters are added to the URL with "&"
• after each parameter place an "=" and then assign the value you would like pre-populated

Additionally, using "fund" OR "project" in the following parameters will produce the same results.

Standard parameters

The following list of parameters control various configurations and layout of the donation form. Nothing here is related to PII. You are able to use these parameters whenever needed without hesitation.

Pre-populating the amount field, project codes, and project comments

Pre-populating the amount field can happen in a variety of ways depending on how the donation page is configured.

So, for example, a link with billing country, comment, and donation amounts for two projects would look like this:

https://raisedonors.com/{your-org}/{your-page-name}/? billingCountry =USA&comment=some-custom-provided-comment&fund-amt-SampleCode1=50&fund-amt-SampleCode2=75

This would populate Sample project 1 with a gift of $50 and Sample project 2 with a gift of $75. 

Sensitive parameters

The following is a list of parameters that need to be given special consideration when being used. Inherent risks and vulnerabilities can be associated when using these parameters.

Address Parameters

Domestic vs international addresses

These parameters are more advanced as RaiseDonors can support international and military addresses. The system will setup the form for an international address if the country provided is not the United States. Below are valid values for the billing country to be considered "United States".

• US
• USA
• United States of America
• United States (Primary, use when possible)

If the billing country is an address in the United States, the billingState can be ISO2 or Full text to be read by RaiseDonors (ie: TX or Texas). RaiseDonors follows the USPS standard ISO2 and Full text specifications foundhere.

A full list of States and Territories found within the United States is provided by the United States Post office. View the "state" drop down list from USPS for the complete list.

Canada, CA, and CAN are all valid identifiers for the country to be considered Canada. If the address is a Canadian address, the billingState can be ISO2 or Full text to be read by RaiseDonors. The following is a list of valid Canadian Provinces/States.

If you specify billingCity, billingState, billingPostal, then billingCountry must also be specified. The billingCountry determines how the address fields will be set up (ie: international vs domestic). You may specify billingAddress by itself.

Military addresses

For military addresses, the Country must be set to "United States" and the City must be one of the following:

• APO
• FPO
• DPO

If the country is United States and there is a match on one of these cities, then the address fields will be setup for a military address.

An example link with donation amount, comment, and billing address would look like the following:

https://raisedonors.com/{your-org}/{your-page-name}/?amt  =  150   &comment=some-custom-provided-comment&billingAddress=123 Test St.&billingCity=some-city&billingState=TX&billingPostal=78737&billingCountry=USA