Website Integration

With Payrexx, donation campaigns can be easily integrated into websites or newsletters without requiring visitors to leave your channels to make a donation.

There are various ways to embed donation campaigns into your channels, and no programming skills are needed. This article explains how it works.

Embedding as a Donation Button

The first way to integrate donation campaigns into your website is by setting up a donation button that you can display wherever you want.

When visitors click on the donation button, the donation page opens in an overlay window. This has the great advantage that donors do not have to leave your website.

To set up a donation button, please follow these steps:

  • Log in to your Payrexx account.

  • Click on Donation in the main menu.

  • Click on "Create campaign" or open an existing donation campaign in edit mode.

  • Click on the "Embed in website" button (1) and select the "As donation button" option (2):

  • A new window will open where various settings can be configured. In the upper part of the window (Options for the campaign), you can specify the following:

  1. Show description: Specify whether the description of the donation campaign should be displayed on the website or not.

  2. Preselect donation amount: Determine whether a specific amount should be pre-selected in the donation form or not.

  3. Default donation interval: Choose which payment interval should be pre-selected. (The available intervals are those activated in the donation campaign under Payment Information > Donation Interval.)

  4. Language: Select the language in which the donation campaign should be displayed on the website.

In the lower part of the window, you can configure display settings:

  1. Color: Specify the color of the button.

  2. Size: Set whether the button should be displayed as small, medium, or large.

  3. Text color: Specify the text color of the button.

  4. Text: Configure the text that should be displayed on the button.

The preview on the right side of the window shows in real-time how the donation button will appear on the website.

To embed the button on the website, simply copy the HTML code in the lower left corner of the window and paste it into the desired location on your website.

Embedding as an iFrame

Another way to display a donation campaign on your website is by embedding it using an iFrame. This method displays the entire donation form directly on the website, not just a button.

  1. Log in to your Payrexx account.

  2. Click on Donation in the main menu.

  3. Click on "Create campaign" or open an existing donation campaign in edit mode.

  4. Click on the "Embed in website" button (1) and select the "As donation form (iFrame)" option (2):

  • A new window will open where various settings can be configured:

  1. Show description: Specify whether the description of the donation campaign should be displayed on the website or not.

  2. Preselect donation amount: Determine whether a specific amount should be pre-selected in the donation form or not.

  3. Default donation interval: Choose which payment interval should be pre-selected. (The available intervals are those activated in the donation campaign under Payment Information > Donation Interval.)

  4. Language: Select the language in which the donation campaign should be displayed on the website.

  5. Code snippet: To embed the form using an iFrame, simply copy the HTML code in the lower left corner of the window and paste it into the desired location on your website.

For additional technical support on embedding via iFrame, refer to our developer documentation.

Advanced Embedding Options

In addition to embedding a button or an iFrame, there are further options for integrating a donation campaign:

Defining custom URL parameters and embedding the donation campaign using self-created widgets on the website that are linked to the campaign. The URL parameters are available for all views (direct call, embedding as iFrame, modal window).

The following article provides an overview of the available URL parameters.

Parameter

Last updated