Giving Form V2

🤔Should i use form v1 or form v2?
In 95% of situations, we suggest using Form V2. Form V1 embeds directly into your website code and therefore allows for more custom configurations—although development knowledge is required to implement these configurations. Form V2 is delivered through an iFrame, provides a better user experience, and allows for more native Funraise features, like Apple Pay or Tickets.
✏️Good to know
The Form Ids and script links here are for demo purposes only. Be sure to copy the form code directly from your platform and then configure it using the tips below.

Embed a Form on your website

Single form
If you're only embedding a single form on a single page, you can copy and paste the entire embed code into an HTML block in the body of your webpage.

Multiple forms
If you're embedding multiple forms on a single page or across your website, you'll need to separate parts of the embed script and place them in the appropriate places.

Launch the form with custom buttons

By default, the Form V2 is launched with a custom HTML button; edit the styles of the default button inline or with your own classes. Place as many buttons as desired in your page body. You can also target a form with your own custom button element by adding your form ID to your button with data-formId="XXX".

Prefill an amount with your custom button

Launch the Form with a custom amount by adding data-amount="" to your button element.

Add multiple currencies

By default, your Form uses your platform currency. You can override your default or add multiple currencies, then configure the ask buttons for each currency.

Paypal Recurring

As you’ve probably figured out, Paypal is special. To transact recurring donations with paypal through the Funraise Giving Form, you’ll need to update configurations to the form code and within your Paypal account.
in Paypal
Enable all API permissions
  1. This step assumes you’ve already implemented Paypal as a payment option
  2. Log in to your PayPal Business Account and find API access settings
  3. Enable ALL permissions for nathaniel_api1.spreedly.com (Yes, every single box needs to be checked)
Next, you’ll contact Paypal support
  1. Click on 'Help' in the top navigation bar
  2. Scroll down towards the bottom of the page and select 'Contact Us'
  3. Choose topic: Business solutions
  4. Choose sub-topic: PayPal payment solutions
  5. Choose sub-topic: PayPal Express Checkout
  6. Scroll down and select 'Chat With Us'
  7. When you’re in contact with a Paypal representative: Ask them to enable reference transactions for the account. At this point, Paypal will begin asking a lot of questions. Be sure a team member who has access to answer very detailed questions is available 👍
Funraise Form configuration
After your Paypal account has been configured, you can activate recurring for Paypal with a single configuration line in the form code.

Transaction Tags

Add Transaction Tags to a donation. Transaction Tags defined in the form script are added to any tags set from within platform.

Event Handlers

Use Event Handlers, onSetup, onInfo, onSuccess , and onFailure to run custom functions or pass data to other systems. Depending on the stage of the donation process, you can pass donor and donation properties into your custom functions as arguments.

Events
onSetup
  • Called when the donation form is loaded on a page
onInfo
  • Called when the donor submits the contact information screen of the form
  • Donor properties passed in as arguments
onSuccess
  • Called when a donation succeeds
  • Donor and Donation properties passed in as arguments
onFailure
  • Called when a donation fails
  • Donor and Donation properties passed in as arguments
Properties
These properties can be passed through event handlers.
donation.amount
donation.anonymous
donation.baseAmount
donation.comment
donation.company
donation.companyId
donation.companyMatch
donation.currency.name
donation.currency.symbol
donation.dedicationEmail
donation.dedicationMessage
donation.dedicationName
donation.dedicationType
donation.formAllocationId
donation.formId
donation.formName
donation.frequency
donation.id
donation.organizationId
donation.pageId
donation.paymentType
donation.recurring
donation.referrer
donation.sourceUrl
donation.tipAmount
donor.address
donor.city
donor.country
donor.email
donor.firstName
donor.lastName
donor.phone
donor.postalCode
donor.state
donor.ua

Redirect donors

With Event Handlers, you can redirect the donor to a new page after a successful donation. This can be used for a special "Thank You" page or for analytics tracking. Please keep in mind, as with all custom implementations, this is only an example and not all browsers will treat this the same way. Be sure to fully test your unique solution.
PayPal is unique and has its own redirection link configurable from the Giving Form Editor.

Analytics Tracking

Google Analytics, Facebook pixel, etc.
Use Funraise Giving Form Event Handlers to pass data to your marketing platforms to complete the conversion analytics loop. For example, pass donation data back to Facebook or Google Analytics to track ROI and conversion metrics.

reCAPTCHA

reCAPTCHA is a tool from Google that helps reduce bots and fraud attempts on your Donation Forms. Setup is easy on Form V2. Get instructions at the link below.

Page Goal

By default the native Giving Form on a Campaign Site automatically adds Transactions to the appropriate goal progress bars on your site. If your strategy requires multiple Giving Forms to impact your site’s progress bars, you can configure any Giving Form to add Transactions to any site progress bar.

To find your Page Id
  1. In Funraise, click Sites in the side menu
  2. Click Pages
  3. Find the desired page, click the actions menu (3 dots), and select: View Page Profile
  4. With the page profile open, copy the final Id string in the URL. This is the Page Id.

Limit Ticket Quantity per Transaction

You can limit the quantity of a particular Ticket that can be purchased with a single Transaction. For example, you might have 10 sponsorship tickets, but you only want to allow one sponsorship ticket to be purchased at a time.
In your configuration you will need to define the Ticket Id and the Quantity for that ticket. You can find the Ticket Id listed on the Ticket profile in platform.
Please note: The purpose of this developer configuration is to limit quantity PER transaction. The overall number of Tickets available is set from within platform in the Quantity field on the Ticket profile.

Stay in the nonprofit loop.

Get weekly updates on tips, trends, and best practices to help power your nonprofit. #nonprofitz4lyfe

Oops! Something went wrong while submitting the form.