The free GiveWP plugin supports collecting credit card donations, SEPA direct debit donations, and BECS direct debit donations via the Stripe payment gateway. This article explains how to configure your GiveWP installation to work with Stripe.

Activating the Stripe Gateway

Navigate to “Donations > Settings > Payment Gateways > Stripe.”

From there click on the “Connect” button to connect to your Stripe account.

From there, you can follow the prompts to either connect your existing Stripe account, or sign-up for a new account.

The Stripe Free settings screen showing multiple Stripe accounts connected and read to use in your forms.

The "Manage Accounts" tab allows for connecting to multiple Stripe accounts from a single GiveWP-powered website. Once you've added all the accounts you need, you can configure individual forms to use specific Stripe accounts using the "Stripe Accounts" tab of the form edit screen.

Connecting Stripe (free) and Your Webhook (required)

In order for donations to be marked as complete on your GiveWP site, you must configure the webhook at Stripe. On the settings page at “Donations > Settings > Payment Gateways > Stripe.” the webhook URL is pre-populated on the page. Copy that to your clipboard for later use.

Click the link in the paragraph just above the webhook URL or navigate to
https://dashboard.stripe.com/account/webhooks

On that page, click the “Add endpoint” button and paste in your webhook URL.

Add a Webhook Endpoint in your Stripe Dashboard.

In the box, select “receive all events.”

The “Add Webhooks” modal, showing where you can click “All events”

 

Note: It is recommended to send all events over the webhook so that if Give is updated in the future to use any events that it currently does not, those will send as well. Unless your site is processing thousands of donations per day or more, you should have no issue with sending all events, and you can ignore the warnings from Stripe. Here are the events currently processed by GiveWP for both one-time and recurring:

  • checkout.session.completed
  • payment_intent.succeeded
  • payment_intent.payment_failed
  • charge.refunded
  • customer.subscription.deleted
  • invoice.payment_failed
  • invoice.payment_succeeded

In order to process test mode donations, you’ll need to repeat the same steps with Stripe’s dashboard toggled into test mode.

The free Stripe payment gateway includes an additional 2% fee for processing one-time donations. This fee is removed by using the premium Stripe add-on and never applies to subscription donations made through the Recurring Donations add-on.

Stripe Settings Explained – General Settings Tab:

Stripe Webhooks

Settings Type: Text Input
Options: Your Site URL followed by /?give-listener=stripe

The webhook should be copied and pasted to your Stripe account dashboard. Learn how to set it up in the above section.

Statement Descriptor

Settings Type: Text input
Options:
 any 22 alphanumeric characters.
Default: Site Title

This is the text that appears on your donor’s bank statements. Statement descriptors are limited to 22 characters, cannot use the special characters <>', or ", and must not consist solely of numbers. This is typically the name of your website or organization.

The GiveWP “Statement Descriptor” setting affects how your donors see their donations to you in their bank statements.

This allows you to customize the info that displays on bank statements.

Note: There must be a value in this field for Stripe to function properly. A default value of your site name is typically set, but in rare circumstances, this field appears blank by default. In that case, save a value here to restore functionality.

Collect Billing Details

Settings Type: checkbox
Options: checked | unchecked
Default: unchecked

This setting allows you to collect Address data along with donations, so that donation records include addresses at Give. The address is not necessary to process the donation at Stripe, but you may have a need to collect it. Note that address data, if collected, is store both on the individual donation, and on the donor record.

Stripe Receipt Emails

Settings Type: checkbox
Options: checked | unchecked
Default: unchecked

In addition or instead of sending GiveWP’s generated receipt emails each time someone donates through your website, you have the option to send emails to your donors directly from Stripe instead.

You can enable this and disable GiveWP generated receipt emails in the Emails > Donor Emails tab. This setting does not change whether GiveWP emails are sent, only the one from Stripe. To avoid duplicates, configure GiveWP email settings separately.

Stripe Settings Explained – Credit Card on Site Tab:

Credit Card Fields Format

Settings Type: radio buttons
Options: Single Field | Multi Field
Default: Multi Field

This setting allows you to choose how the credit card fields are displayed on the form. The default is Multi Field which displays separate inputs for Card Number, CVC, Cardholder Name, and Expiration date.

The other option is Single Field which houses all of those various pieces of data in a much smaller single input.

Your Stripe donation page can be formatted with multiple fields to input credit card information or you can use a single input field to create a shorter form.

Stripe Settings Explained – Stripe Checkout Tab:

Checkout Type

Settings Type: Radio buttons Options: Modal (Legacy Checkout) | Redirect (Checkout 2.0)
Default: Modal (Legacy Checkout)

Note: Stripe has deprecated this form of checkout and may no longer support it. As well, 3D secure card payments, Google and Apple Pay, are not available when using the Stripe Modal version of Checkout. If accepting 3D secure card payments is necessary, using the Checkout 2.0 or Stripe credit card fields is required.

If you want to use the Stripe Modal Checkout, essentially a Stripe-styled modal popup that offers a different interface to pay than the default Give credit card fields, check the Enable Stripe Checkout option. This Modal option is not SCA compatible.

As an alternative, the “Redirect” option allows your donor to use the checkout interface and pay with either a credit card, Apple Pay, or Google Pay. This method is SCA compatible and fully supported by Stripe and GiveWP.

When Redirect (Checkout 2.0) is selected, the only other option on this page is to edit the Processing Text. When Modal (Legacy Checkout) is selected, all the following options will appear.

Checkout Heading

Settings Type: Text Field
Default: Your Site Title from the General Settings page

This is the main heading within the modal checkout.

Stripe Checkout Image

Settings Type: File Upload

This image appears in when the Stripe checkout modal window. The recommended size is a 128px x 128px square GIF, JPEG or PNG.

Once you have configured and saved the above settings, you would now see a Stripe Modal checkout like below while donation using Stripe.

Processing Text

Settings Type: Text Field Default: Donation Processing…This text appears briefly after the donor has made a successful donation while Give is confirming the payment with the Stripe API

Verify Zip Code

Settings Type: Checkbox Options: Checked | Unchecked Default: Checked

If enabled, Checkout will validate the billing ZIP code of the donor for added fraud protection.

Remember Me

Settings Type: Checkbox Options: Checked | Unchecked Default: Checked
If enabled, Checkout would remember the card details for future donations.

The Stripe Modal versus the Stripe Checkout 2.0.

Frequently Asked Questions

The free version of Stripe is different from the Premium add-on version in important ways. These FAQs help clarify those differences.

FAQ's

The premium Stripe add-on includes the following additional features:

  • No additional transactional fees are added (the free Stripe gateway adds 2% fee to all one-time donations)
  • GPay as a single gateway
  • Apple Pay as a single gateway
  • Plaid as a single gateway (ACH payments)
  • iDeal as a single gateway

If the webhook is not correctly configured according to the instructions above, your site will keep all donations marked as Pending. Follow the instructions above to configure the webhook.

Note also that development sites on localhost or behind firewalls will prevent the webhook from reaching the site, and always leave all Stripe donations marked as pending.

No. The 2% fee is applied only to one-time donations.

Any of the following actions will remove the 2% fee from your Stripe donations:

  1. Purchase and activate the Premium Stripe gateway.
  2. Purchase and activate the Recurring Donations gateway — the recurring donations will never have fees added to them.

Our aim is to empower more small causes to accept more donations on their website. We can do this more effectively by funding the support and development necessary to support Stripe in the free plugin.

If you have any questions or concerns about this, please contact us via our contact page and ask to speak with the Customer Success Team.

No, not at all. The 2% fee only applies to one-time donations processed via the Stripe gateway when using the free Stripe gateway.