Charitable Documentation

Learn how to make the most of Charitable with clear, step-by-step instructions.

Getting Started: How to Use PayPal Commerce in Charitable

Are you ready to offer your donors the trusted convenience of PayPal for their donations? Enabling PayPal in Charitable allows you to easily accept contributions using one of the most recognized and reliable payment methods in the world.

With just a few clicks, you can enhance your fundraising efforts and provide a seamless donation experience.

In this guide, we’ll walk you through setting up PayPal as a payment gateway in Charitable, customizing its settings, and ensuring everything is running smoothly, so you can start accepting donations with confidence.

Enable PayPal Payment Gateway

First, to enable PayPal, head to your WordPress admin. Go to Charitable » Settings » Payment Gateways tab. Here, you’ll see the PayPal option along with a button to “Enable Gateway”.

Paypal gateway settings page

When you enable the gateway, a new green “Gateway Settings” button will appear.

At this point, we recommend first turning on Test Mode. This will allow you to set up the gateway safely without any transactions accidentally coming through when you’re not ready. When test mode is active, you should see an alert at the top.

Charitable test mode active alert

Connect to Your PayPal Account

Now click on the Gateway Settings to go to the PayPal settings page.

PayPal gateway settings button

On this page, you can now connect to PayPal with a few clicks. There’s absolutely no coding needed.

Start by hitting the green “Connect with PayPal” button.

Connect with PayPal button

This will open up a new page to log in to your PayPal account. Enter your email and follow the onscreen instructions from PayPal.

PayPal login screen

Once you’ve logged in, you’ll see a success message like this. This lets you know that you’re ready to get paid with PayPal on your eCommerce store.

Ready to get paid with paypal

Back in your WordPress site, you’ll see that PayPal Commerce is successfully connected. Charitable also gives you a list of capabilities available to you. These include:

  • Payments Receivable
  • Email Confirmed
  • Advanced Card Processing
  • Apple Pay
  • Google Pay
  • Payment Method Vaulting
  • Fastlane
PayPal connected successfully

Below this, you’ll see more settings and configurations to fine-tune your PayPal Commerce Gateway. We’ll go through the options available here.

Customizing PayPal Commerce Settings

Webhooks

These are the webhooks available for developers to use:

  • CHECKOUT.ORDER.APPROVED
  • PAYMENT.CAPTURE.COMPLETED
  • PAYMENT.CAPTURE.DENIED
  • PAYMENT.CAPTURE.PENDING
  • PAYMENT.CAPTURE.REFUNDED
  • MERCHANT.ONBOARDING.COMPLETED
  • MERCHANT.PARTNER-CONSENT.REVOKED
Webhooks in Charitable

Button Customization

You can change the button color and shape here to match your donation form better. Use the drop down menus to see the options available here.

PayPal payment options button

Enable More Payment Methods

Below the button customization options, you’ll see options to enable Venmo and Pay Later.

  • Venmo is a highly popular mobile payment service owned by PayPal, primarily available only in the United States. It is designed to make it easy to send and receive money directly from your smartphone.
  • “Pay Later” (often referred to broadly as Buy Now, Pay Later, or BNPL) is a type of short-term financing that allows consumers to make purchases and pay for them at a future date, often interest-free.

You can enable these options using the toggle button here.

Enable Venmo and Pay Later in paypal

Next, there are more advanced payment methods. These include:

  • Card Fields (ACDC) – This shows credit and debit card fields directly on your site. It requires Advanced Card Processing approval
  • Apple Pay – This requires Apple Pay approval from PayPal. It will appear to users on the Safari browser on Apple devices.
  • Google Pay – Appears to donors using Chrome or Edge browsers with Google Pay enabled. This requires Google Pay approval from PayPal.
  • Fastlane – Gives you an accelerated checkout for guest users.
Advanced payment methods in paypal settings

All of these options can be enabled/disabled using the toggle button.

Payment Method Vaulting

Payment Method Vaulting (often referred to simply as the PayPal Vault) is a feature used by merchants and businesses to securely save a customer’s payment information for future use.

Instead of a business storing your sensitive credit card or bank account details on their own servers – which is a massive security risk – they use PayPal’s Vault to handle it.

You can enable it using the toggle next to “Enable Payment Method Vaulting”.

When enabled, you can customize the settings thatt include:

  • Vaulting Option Display: This decides how the option to save payment methods appears to users during checkout
  • Auto-vault for Recurring Donations: When enabled, this automatically saves payment methods for recurring donations.
  • Recurring Processing Mode: You can choose Vault+Cron (merchant-managed) or PayPal Subscriptions API (PayPal-managed)
  • Vaulted Method Expiry (in Days): Number of days before stored methods go unused before they expire. You can leave it empty if you don’t want this data to expire.
PayPal payment method vaulting

Once you’re done making changes, make sure you save changes before exiting this page.

Testing Your Donation Form with PayPal Commerce

We recommend running test transactions to ensure your transactions go through. Open any Charitable campaign, select an amount you want to donate. Scroll to the payment section and you should see PayPal appear like so:

Choose your preferred payment method and complete your donation.

PayPal Commerce donation form

Once your donation is successful, your receipt will appear.

Here’s a sample:

Charitable PayPal receipt

Check Donation Records

Head over to Charitable » Donations. You can view the donation record list here. Choose the one you just made.

On the next page, you’ll see the Donation Details. This will show you the Payment method and the log which bears all the details of the Prder ID, PayPal capture ID, and gateway transaction ID.

Donation record with PayPal details

On the right panel of this screen, you’ll see Donation Actions.

Using the drop-down menu, you can choose to refund the donation

Check the box that reads “Refund in PayPal Commerce automatically.”

Then “Update Status” here.

This will ensure that the donation is refunded directly through PayPal.

Refund in paypal

When you’re done testing PayPal with Charitable, make sure you turn off Test Mode. Now live donations can come through to your non-profit.

Disconnecting PayPal Commerce

To disconnect PayPal, return to Charitable » Payment Gateways, click on the “Gateway Settings” next to PayPal.

On this page, find the “Disconnect Account” button under Connection Status.

Disconnect PayPal

Disabling the PayPal Gateway

To disable the PayPal gateway, go to Charitable » Payment Gateways. Next to PayPal, you can click on the “Disable Gateway” button.

Disable PayPal gateway

That’s it. You’ve learned how to set up and manage PayPal as a payment gateway in Charitable. Next, you may also want to learn about payment gateways:

You may also want to read our guide on Understanding Nonprofit Platform and Processing Fees (And How to Minimize Them) »

Need support? Have a question? If you are a lite/free user of Charitable, you can reach out to our team on the WordPress.org support forums. If you have an active license, feel to reach out us directly for priority support.

Stay Connected for More Nonprofit Resources

For more tutorials and videos tailored to nonprofits, subscribe to our YouTube channel. We regularly publish expert tips, step-by-step guides on online donations, fundraising strategies, and practical resources to help your organization succeed.

🗞️ Get weekly tips and exclusive guides in your inbox
Join our newsletter →  

🎥 Watch step-by-step tutorials and success stories
Subscribe to our YouTube channel →  

👩🏽‍💻 Connect with our community and get daily nonprofit insights
Follow us on LinkedIn →

🥳 Fun reels and non-profit insights
Follow us on Instagram → 

👀 Insightful & fun videos to help you grow your cause
Follow us on TikTok→  

🌎 Subscribe and follow for general fundraiser tips
Get Fundraiser Tips on TikTok → 

Powerful Fundraising Resources

⬇️ Download proven strategies, campaign ideas, and expert tools
Get the Fundraising Kit →  

💸 Get Free Fundraising Resources
Head to the Charitable Fundraising Hub

🤔 Got questions about Charitable?
Charitable FAQs

🏎️ Take Charitable for a spin
Create your Charitable Demo

Understand non-profit terms and jargon
Non-Profit Glossary

% Looking for non-profit deals and discounts?
Best Non-Profit Deals and Discounts →

Still have questions? We’re here to help!

Last Modified:

What's New In Charitable

View The Latest Updates
🔔 Subscribe to get our latest updates
📧 Subscribe to Emails

Email Subscription

Join our Newsletter

We won’t spam you. We only send an email when we think it will genuinely help you. Unsubscribe at any time!

automation update

⚡ Visual Automation Builder: Drag and Drop With No Code!

Charitable Automation Connect 2.3.0 introduces the Visual Automation Builder, a full-screen canvas that lays each automation out as a flow of connected cards: a trigger, optional conditions, and a list of actions that run in order.

🧩 Many actions, one trigger: Tag a donor, send an email, add a note, and fire a webhook from a single event, dragged into any order.

✉️ Act inside Charitable: New Send Email, Tag Donor, and Add Donor Note actions run with no external service required.

🔤 Merge tags: Personalize emails and notes with live fields like {first_name}, {total}, and {campaign_name}.

🔁 Apply to existing donors: Run Tag Donor and Add Donor Note against the donors you already have.

🖥️ Canvas or Simple: Switch views anytime, and automations built before 2.3.0 keep working unchanged.

Read more here.

Integration updated

📬 Introducing Brevo for Charitable: Turn Donors into Subscribers Automatically

The moment a supporter makes a gift is when they are most engaged. With the new Brevo integration for Charitable, you can automatically turn those one-time donors into long-term subscribers without touching a single spreadsheet.

Simply collect donor consent right on your donation form and start your welcome series immediately.

What’s New:

🔄 Automated Subscriber Sync: New donors who opt in are added straight to your Brevo contact list as soon as their payment clears—no manual exports or CSV imports required.

🎯 Granular Consent & Opt-In Control: Customize your checkbox label, choose whether it defaults to checked or unchecked, or turn on Brevo double opt-in to keep your list clean and compliant.

📋 Per-Campaign List Mapping: Route supporters to your global email list or map specific campaigns to targeted Brevo lists to tailor your follow-up messaging.

⚡ 5-Minute Setup: Connect instantly by pasting your Brevo API key into the Newsletter settings, map your contact fields, and start building your email list on autopilot.

Ready to grow your mailing list? Brevo is available now starting on the Charitable Plus plan—connect your account today!

recurring donations updated

💳 Introducing Card Updates: Fix Expired Cards Without Losing Subscriptions!

newExpired or updated credit cards are one of the biggest silent leaks in recurring fundraising. With Card Updates in the Recurring Donations extension, donors can now refresh their payment details directly—keeping their subscription, schedule, and giving history completely intact.

No canceled plans, no lost history, and zero administrative headache for your team.

What’s New:

⚡ 30-Second Self-Service: Donors get a dedicated “Update Card” button in their dashboard that opens Stripe’s secure, PCI-compliant Customer Portal to update card details instantly.

🔒 Scoped & Safe Access: Scoped exclusively to card updates by default, donors can’t accidentally cancel or alter their plans from inside the portal, keeping your webhooks and data in sync.

🤝 Admin-Assisted Support: Helping a donor on the phone? Open their secure Stripe portal in one click from your admin screen or generate a single-use update link to email them.

📋 Automatic Audit Trail: Every payment method update is recorded automatically with a timestamp in both system-wide logs and the individual donor’s profile.

Ready to protect your recurring revenue? Get the Plus or Pro plan and update Recurring Donations to 2.3.0+ and enable “Update Payment Method” under your Settings today!

Integration page builder

Divi Fans Rejoice! Native Divi 5 Campaign Progress Bar Module!

With our new native Divi 5 module, you can anchor your microsites with real-time fundraising stats directly on the visual canvas. Here’s how it works, and why it’s worth turning on today.

Create campaign updates that are VISUAL AND LIVE. You can also:

📊 Campaign Progress Bar: Drop a live progress bar into any Divi 5 layout and show goal progress in real time.

🎨 Deep styling controls: Easily customize the bar and track color, height, and radius to match your brand perfectly.

👁️ Visual Builder ready: Configure and preview everything directly on the Divi canvas as a first-class module.

🔁 Identical rendering: The same exact engine powers this module, meaning consistent design without legacy shims.

✅ Faster launches: Never leave the Divi 5 interface to configure shortcodes or guess how your goal labels will look.

Learn more here.

Integration page builder

👉🏻 New in Charitable: Native Elementor Widgets for Seamless Campaign Building

With native Elementor widgets, you design donation campaigns right alongside the rest of your page without touching code. Here’s how it works, and why it’s worth turning on today.

Create fundraising pages that are VISUAL, NATIVE, AND SHORTCODE-FREE. You can also:

⚡ Mini Donation: Add a compact, high-converting donation widget with preset amounts and full color control.

⏳ Campaign Countdown: Build urgency for a deadline-driven appeal, complete with optional confetti when the goal is hit.

📣 Donation Feed: Prove momentum by showing visitors the social proof of real people giving right now.

🏆 Donor Leaderboard: Celebrate top supporters with gold, silver, and bronze styling to spark friendly giving.

🖼️ Campaign Showcase: Feature multiple campaigns in a landing page grid or carousel, with search, filters, and badges.

Learn more here.