Donations are possible on the website thanks to a dedicated page Part. You can find the Donation part in the Part list of a page in the Pages module.
Video Manual: How to add a Donation from a Page Part
Language: English Captions: Yes Duration: 2 mins, 29 seconds
The Donation Form
The donation form consists of a slider to set the donation amount. The minimum and maximum amounts are configured in the Page Part. The default amount is the position of the slider when the page is opened.
The form also offers fields for "Name", "e-mail address" and "remark", which are all optional. Anonymous donations are also possible by leaving these fields empty.
How to add Donation part to a Page/configuration
There are some settings to make when adding a donation part to your page:
- Set the start and end amount of the slider by filling out the Min and Max fields.
- The Default price where the slider starts. In the example people will see the amount of €5.
- Reference is a special mention that will be added to the donation. When you set up different donations you might like to know from which page the donation came from. In general (for all your donations) you can set up an extra PSP account. This is an extra function so it will be combined with the references. Below you will read more about setting up an extra PSP.
Confirmation / Thank you email
The Donation module does not send a confirmation email to the person donating. The module does not process the response from the Payment Service Provider and can not distinguish between a cancelled donation and a successful donation. Therefore it is up to you to send periodical thank you e-mails to those who donated. You will find the e-mail address in the description of the payment in Mollie or Pay in case the person donating has filled in their e-mail address.
Setting up the return page
- Create a donation page, and add some content explaining the character of the donation. Add the donation part, and configure the part settings (see above).
- Configure a return URL for the return page after the payment has been made. You can do so in Control Panel>Marketing>Ticketing>Donation return URL field. The URL should be a relative URL, like this fictive example: "/pQ6VJUL/voorbeeld-van-een-pagina" (don't forget the first slash ("/")).
The return URL can link to the donation form itself, we advise to make a second page for the return URL. On this page you can provide a thank you message.
Do not hesitate to contact an expert if you need any help.
Setting up the Payment
PSP (Mollie and Pay)
The donation part currently works with both Mollie and Pay. If you already have a payment service provider (PSP) with one of these two, the same one can be used without further configuration. Donations will be processed in the same PSP account. You need to make sure your PSP donation (live) is Enabled. Add the API key from your existing PSP by copy pasting it. Or Make a new API key within your Mollie or Pay account.
Multiple PSP Profiles
If you want to separate your Donations from your Order transactions in your PSP, create a new profile in the PSP. After you have obtained the API keys ("test" and "live"), fill them in in the System>API Connections>Donations connections. Use both the "live" and the "test" keys and enter them in the appropriate connection. The test key will by default be used on your staging website, so that you can test orders without actual payments on staging.
Please create a ticket in the CultureSuite Support Portal if you need assistance.
Template Texts for Donations
All Template Texts for the Donation form start with "FE3_Donation_Form". You can find them in the Dashboard > System > Template Texts.
Special mentions:
- FE3_Donation_Form_Min_Message: This template text is optional and will be shown if the slider reaches the minimum amount. For example:"We cannot process smaller donations at the moment".
- FE3_Donation_Form_Max_Message: This template text is optional and will be shown if the slider reaches the maximum amount. For example:"Please contact us for higher amounts".
Related articles