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!

GiveWP Migrations New

White Glove Migration Service for GiveWP

Thinking about switching your fundraising platform from GiveWP to Charitable, but don’t want to risk losing your data or handle a complex technical setup yourself? Charitable’s White Glove Migration Service features:

👥 Flawless Donor Mapping: Safely transfer your entire supporter database with zero data loss.

📊 Complete Financial History: Meticulously preserve every historical transaction for continuous, accurate reporting.

🔄 Seamless Recurring Giving: Safely transfer active sustaining subscriptions without disrupting your incoming revenue or requiring your donors to update their information.

💳 Zero Gateway Disruptions: Keep using Stripe, PayPal, or any other GiveWP-compatible processor you already love.

🚀 Expert Technical Setup: Relax while our team handles the heavy lifting to install and configure your forms—plus, qualifying users get a full year of Charitable Pro completely free.

Visit this page to learn more.

automation Improvement

📢 New Feature Alert: Automation Connect 2.0 Is Here! 🚀

Thinking about connecting your fundraising data to tools like Mailchimp, Slack, or Google Sheets, but don’t want to hire a developer or write custom code? Charitalbe’s new automation addon has:

⚡ 17 Event Triggers: Instantly fire webhooks for a donor’s first gift, renewal payments, or reached campaign milestones.

🎯 Smart Conditional Logic: Use powerful AND/OR logic across 11 fields to only send data when it meets your exact criteria, like newsletter opt-ins.

📊 Custom Payload Control: Select from 80+ clean data fields across donor, donation, and campaign metadata so your apps get exactly what they need.

🚀 Pre-Built Platform Templates: Skip the setup from scratch with ready-to-go templates for Zapier, Make.com, n8n, HubSpot, and Slack.

🛡️ Reliable Developer Tools: Power your workflows with signed HMAC-SHA256 payloads, complete WordPress filters, and automatic retry logs.

automation Improvement

🔌 Charitable Meets Zapier: Connect to 7,000+ Apps and Automate Your Fundraising

Tired of manually copying donation data into accounting sheets or tracking down new donor signups? Put your administrative tasks on autopilot. Charitable is now officially on Zapier, giving you a powerful, no-code way to plug your fundraising directly into the rest of your favorite tools.

Every donation, donor signup, and campaign milestone can now trigger an automated workflow seamlessly.

What’s New:

♾️ Connect to 7,000+ Apps: Bridge your Charitable campaigns with everyday software like Google Sheets, QuickBooks, Slack, Mailchimp, HubSpot, Notion, Airtable, and thousands more.

⚡ 12 Powerful Triggers: Build deep workflows using smart automation triggers covering the entire donation lifecycle—including New Donation, New Donor, Subscription Cancelled, and Campaign Goal Reached.

📋 Pre-Built Action Templates: Get started in three minutes or less with our pre-made template combinations, like automatically logging new donations straight into a Google Sheet or firing custom donor welcome emails through Gmail.

🚫 Zero Code Needed: No complex webhooks or custom PHP scripts required. Just pick your trigger, choose your app, map your fields, and let Zapier handle the heavy lifting.

Ready to save hours of admin time? Grab Charitable Pro with the Automation Connect addon today and launch your first Zap!

Improvement Payments

🚀 Introducing PayPal Commerce: One Connection, Six Ways to Donate

Donors expect modern, flexible payment options when they support a cause. If they don’t see their preferred method on your donation form, they often disappear without a word. With PayPal Commerce, we are bringing a completely modernized checkout experience right to your campaigns.

Enjoy a single integration that upgrades your forms, makes giving seamless, and helps you capture every single donation.

What’s New:

🔌 One-Click Connection: Skip messy API keys and developer docs. Simply click “Connect with PayPal,” sign in to your business account, and your modern form is live in under five minutes.

💳 Six Ways to Give: Give your supporters instant access to PayPal balance, Venmo (US), Pay Later financing, major credit/debit cards, Apple Pay (Safari), and Google Pay (Chrome) all from the exact same form.

🔄 Flexible Recurring Giving: Fully supports monthly giving. Choose between the PayPal Subscriptions API (handled automatically on PayPal’s end) or Vault + Cron (handled securely right on your site).

💬 Friendly Error Recovery: No more confusing browser alerts. If a payment is declined, donors see plain-language, inline messages that guide them on how to fix the issue and complete their gift.

Ready for PayPal, modernized? Update to Charitable Pro 1.8.15+ (or Charitable Lite 1.8.11+) and connect your account today!

Campaigns New

⏳ Campaign Countdown: Drive Urgency and Lift Donations

Urgency is one of the most powerful tools in fundraising! Meet Campaign Countdown—a live, real-time timer built to turn procrastination into immediate generosity.

campaign_countdown_animation

What’s New:

⏱️ Live, Real-Time Urgency: Beautifully track days, hours, minutes, and seconds down to your campaign’s deadline w/ live-updating visual countdowns.

🎨 Tailored to Your Look: Choose between Boxed bordered tiles or a clean, single-line Inline display. Match your theme instantly with font and deep color controls.

🛠️ Place it Anywhere: Drop the countdown anywhere you like using the Campaign Builder field, a dedicated Gutenberg block, or a simple shortcode.

🚨 Smart Expiry Actions: Total control over the end state—choose to automatically replace the timer with a custom message, freeze it at zero, and more.