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!

ambassadors New

👤 Creator Profiles: Put a Face to Every Peer-to-Peer Campaign

Ambassadors 3.3.0 now provies Creator Profiles — giving your supporters a permanent, shareable public home that turns one-time fundraisers into ongoing relationships.

👤 Public Creator Pages: Give every fundraiser an instant, clean landing page at /creator/their-name/ to showcase their custom avatar, bio, and a browsable grid of their campaigns.

📊 Proof of Impact: Boost donor trust by displaying site-wide milestones on the profile—like total funds raised and total donor counts.

💳 Interactive Hover Cards: When donors hover over a creator’s name on a campaign page, a compact card expands with their bio and social handles right at the moment of decision.

📍 Responsible Location Sharing: Allow creators to safely show local supporters where they are based using only city, state, and country details.

🛠️ Self-Serve Customization: Fundraisers can update their own profiles and link up to six social networks directly from the My Campaigns hub, saving you admin time.

Ready to empower your advocates? Update to Ambassadors 3.3.0 and turn on “Enable Public Creator Page” today!

Improvement Payments

📱 Turn Mobile Scrollers Into Donors: Meet Charitable’s Mollie Upgrade

Losing mobile supporters because they hate typing out long card numbers on their phones? Charitable’s updated Mollie integration features:

⚡ One-Tap Wallet Checkout: Enable donors to complete their gifts instantly using Apple Pay or Google Pay with a simple face scan, fingerprint, or tap.

💰 No Extra PCI Burden: Skip complex domain verification and security compliance since all wallet transactions run safely through Mollie’s hosted checkout.

🛠️ Custom Cancel Routing: Keep the experience predictable by automatically sending donors who back out to your cancellation page, or use developer filters to route them to a custom page.

Visit this page to learn more.

ambassadors improved New

Moderation and Directory Screens In Ambassadors 3.0

Ambassadors 3.0 has new features: moderation and directory screens… now easily see those who are earning donations on your peer to peer network – including campaign creators that might need to be verified – all in one place. Generate reports, email ambassadors and campaign creators directly and more.

🚀 See when campaign creators and ambassadors have updated their campaigns, what donors/donation they have brought in and more.

🎉 Manually add ambassadors and campaign creators, and approve them in one-click!

Visit this page to learn more.

New Payments

⚡ Unlock India-Based Donations: Meet Charitable’s Native Razorpay Integration

Trying to collect donations in India? Charitable’s native Razorpay integration features:

⚡ Instant UPI Integration: Accept fast, local donations directly inside your form via apps like PhonePe, Google Pay, Paytm, and BHIM without sending donors away from your site.

📲 Auto-Generated Campaign QRs: Instantly render scannable QR codes encoding a UPI deep link directly on your public campaign pages and sidebars for an effortless “scan-to-give” experience.

💰 Dual Local & Global Reach: Headline your campaigns in INR while seamlessly accepting major international currencies like USD, EUR, GBP, and CAD to maximize global support.

🔁 Seamless Recurring Giving: Fully integrates with the Charitable Recurring addon to manage automatic monthly subscriptions directly through Razorpay without extra code.

↩️ Automatic Two-Way Sync: Keep your books perfectly clean with two-way refund syncing—issue a refund inside WordPress or your Razorpay dashboard and both sides update automatically.

🔒 Webhook-Verified Security: Automatically protect your donation records using HMAC-signed webhook verification to ensure every status update represents real money cleared on the rails.

Visit this page to learn more.

Integration New

🎉 New Built-in PushEngage Integration

Struggling with falling email open rates and rising ad costs just to keep your supporters engaged? Charitable’s built-in PushEngage integration features:

🔔 Zero-Fee Direct Messaging: Deliver crisp, instant pop-up notifications straight to your donors’ desktops and mobile devices.

⏱️ Four Smart Automated Triggers: Automatically send updates for immediate donation thank yous, full-list campaign launches, urgent “ending soon” alerts, and goal milestone celebrations.

📈 Group Momentum Broadcasts: Turn private milestones into public wins by automatically broadcasting alerts to your entire subscriber list the moment a campaign hits 50%, 75%, or 100% of its goal.

📊 Automatic Analytics Tracking: Monitor exactly where your incoming notification traffic is coming from with built-in attribution that requires zero complex configuration.

Visit this page to learn more.