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.
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".
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.
Enable all API permissions
This step assumes you’ve already implemented Paypal as a payment option
Log in to your PayPal Business Account and find API access settings
Enable ALL permissions for nathaniel_api1.spreedly.com (Yes, every single box needs to be checked)
Next, you’ll contact Paypal support
Click on 'Help' in the top navigation bar
Scroll down towards the bottom of the page and select 'Contact Us'
Choose topic: Business solutions
Choose sub-topic: PayPal payment solutions
Choose sub-topic: PayPal Express Checkout
Scroll down and select 'Chat With Us'
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.
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.
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.
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.
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.
Find the desired page, click the actions menu (3 dots), and select: View Page Profile
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.