Skip to content

Charitable Stripe

Installing Charitable Stripe is the same as installing any other Charitable extension. If you’re not sure how to do that, we recommend first reading our guide to installing Charitable extensions.

Getting Started

After the extension is installed, you will need to add your Stripe API keys. We assume that you already have a Stripe.com account activated.

The Stripe gateway settings page in Charitable.
The Stripe gateway settings page in Charitable.
  1. Go to Charitable > Settings.
  2. Click on the Payment Gateways tab.
  3. You will see Stripe listed as one of the gateway options. Click Enable Gateway to activate it.
  4. After the page reloads, you will see a new button called Gateway Settings. Click this.
  5. On the following page, you can add your license keys, as well as setting the gateway label (this is what donors will see when choosing their payment method).
  6. When you have finished adding your settings, click Save Changes.

Finding Your Stripe Keys

You can access your Stripe keys via your Stripe dashboard.

  1. Log into your Stripe account.
  2. In the top menu, click on Developers.
  3. In the left hand menu, click on API keys.
  4. You will see your Publishable key listed inside the Standard keys section. To see your Secret key, you have to click the button to reveal it. You may be prompted to re-authenticate with your password.

Note: You will have different keys for live mode and test mode. In the Stripe dashboard, if you are viewing test data (you will see a toggle in the sidebar), the keys listed are your test keys; otherwise they are your live keys.

Webhooks

Webhooks are messages that are sent by Stripe to a specific URL on your website that contain information about events that have just taken place. Charitable uses webhooks from Stripe to process refunds as well as recurring donations.

As of Charitable Stripe 1.3+, the plugin will attempt to automatically create a webhook endpoint for you. The URL for the webhook endpoint will take either of the following two forms:

  • https://yoursite.com/charitable-listener/stripe
  • https://yoursite.com/?charitable-listener=stripe

If Charitable is unable to create a webhook endpoint for you, or if you are on an older version of the plugin, you will need to manually create your own webhook. Find out how to set up a Stripe webhook for Charitable.


Additional Information