Charitable Blog

Everything you need to know about Charitable and our team.

Gateway Processing Fee Tracking: See Your True Net Per Donation

Gateway Processing Fee Tracking: See Your True Net Per Donation

Last updated on

  • By

Running a nonprofit means every dollar counts, including the ones that quietly disappear to payment processing fees. When a donor gives $100 through Stripe or PayPal, the gateway takes its cut before that money ever reaches your account. You know it’s happening.

But until you log into your gateway dashboard separately, pull a transaction report, and cross-reference each entry against your Charitable donation records, you don’t know the exact number. Not even close.

Charitable now shows you gateway processing fees right inside your WordPress dashboard!

Every individual donation record displays the exact processing fee charged for that transaction – right where you’re already looking, no extra steps, no cross-referencing, no math required.

You open a donation. You see what came in. You see what the gateway took. You see what you kept.

Gateway processing fee feature

Introducing Gateway Processing Fee Tracking

Gateway Processing Fee Tracking, new in Charitable Pro, automatically records the actual processing fee charged against each donation at the moment the payment clears. This works for the following gateways:

No manual entry, no additional API calls, no logging into a separate dashboard to track down the number.

Your gross, your fees, and your net: all inside WordPress where you already manage everything else.

Here’s how it works in practice.

How It Works

Fee tracking is designed to be passive. It reads the processing fee from data the gateway already sends when confirming a payment, with no additional requests to Stripe or PayPal’s APIs and no configuration beyond enabling the feature. There’s no extra load on your site and no new webhooks to set up beyond what Charitable already requires.

🛠️ The technical details: For Stripe, the fee is read from the balance_transaction.fee field on the charge object when Charitable’s webhook processes the payment confirmation. The amount is converted from cents to a decimal figure before being stored.

For PayPal, the fee arrives in the IPN notification payload as mc_fee, already formatted as a decimal, and is stored as-is.

In both cases, the fee is written once and never overwritten. If PayPal retries an IPN notification or Stripe fires a duplicate webhook event, the original value is preserved. Your donation records stay accurate regardless of what happens on the gateway side after that first confirmation.

Here’s what that means in practice: a small education nonprofit processes around 200 donations a month, split across Stripe and PayPal.

With fee tracking enabled, the processing fee is stored on every new donation record inside WordPress and included as a dedicated column in every CSV export.

Donation page gateway tracking

Reconciliation that used to take the better part of a morning now takes about 15 minutes.

The data you need is already there, correctly formatted, and ready to go.

For organizations managing lean operations, that’s not a minor convenience. It’s real administrative time returned to the team.

What Gateway Fee Tracking Can Do

Here’s a quick look at everything this feature handles automatically:

  • Captures the exact fee per donation: The actual processing fee reported by Stripe or PayPal is stored on the donation record at the moment of payment confirmation. No rounding, no estimates, no averages based on typical rates.
  • Displays the fee on the donation admin page: Open any Stripe or PayPal donation in your WordPress dashboard under Donations and you’ll find a Gateway Processing Fee row in the donation meta section, formatted in the donation’s currency.
  • Adds a dedicated fee column to CSV exports: When tracking is enabled, every donation export includes a Gateway Processing Fee column alongside your other donation data. Pull an export and the full picture is already there for your bookkeeper, auditor, or grant officer — no extra steps.
  • Calculates net amounts per donation: A built-in helper function computes the true net received per donation, accounting for the gateway processing fee and any Stripe Connect application fee if applicable. Developers building custom reports or integrations can call charitable_gateway_fees_get_net_amount( $donation ) to retrieve it as a formatted currency string.
  • Handles Stripe Connect correctly: For Stripe Connect accounts, the platform application fee is tracked separately and factored into net calculations alongside the processing fee. Both amounts are stored independently for accurate, auditable reporting.
  • Protects against duplicate data: Once a fee is recorded on a donation, it isn’t overwritten. Idempotent storage means retried webhooks and IPN notifications can’t corrupt or replace the original value.

Getting Started with Fee Tracking

Fee tracking is off by default. Here’s all it takes to enable it:

  1. Update Charitable Pro to version 1.8.13 or higher. Go to Plugins in your WordPress dashboard, check your Charitable Pro version, and run the update if needed.
  2. Add the following line to your theme’s functions.php file or a site-specific plugin:
add_filter( 'charitable_show_gateway_processing_fee', '__return_true' );

That’s the full setup. Save the file and Charitable starts recording the processing fee on all new Stripe and PayPal donations automatically. There’s nothing else to configure in the WordPress admin.

Before enabling, confirm two prerequisites:

  • Stripe users: Fee capture requires the Stripe webhook to be active and delivering charge.succeeded or payment_intent.succeeded events with the balance transaction expanded. If you set up Stripe through Charitable’s standard flow, this is already in place.
  • PayPal users: Fee capture depends on PayPal IPN delivering notifications correctly. If you’re unsure whether IPN is active, check your PayPal account settings or review the Charitable PayPal setup documentation.

One important note: fee data is captured going forward only. Donations processed before you add the filter are not retroactively updated, so the fee field will be empty on older records.

To turn off fee tracking, remove the snippet or replace it with:

add_filter( 'charitable_show_gateway_processing_fee', '__return_false' );

Disabling tracking stops new fees from being recorded. It does not delete fee data already stored on existing donations.

Not code savvy? Worried about breaking your site? Need help with adding code to your site that doesn’t require you to manually tweak files?

I recommend checking out WPCode »

It makes it easy and safe to add custom WordPress features through code snippets. You can safely create custom code snippets by simply filling a form without having to worry about the code.

It also comes with safe error handling. This helps you prevent common code errors when adding custom snippets to ensure you never break your site.

Why You’ll Love Gateway Fee Tracking

The setup is a single line of code. The payoff is every month, forever.

  • 📊 No more cross-referencing your gateway dashboard; the exact processing fee is stored on every donation record inside WordPress, right where you do everything else.
  • 💸 True net per donation, calculated for you; the net amount helper accounts for the gateway fee and any Stripe Connect application fee, so you always know what you actually received.
  • 📁 Export-ready for accounting and grant reporting; the fee column is included automatically in every CSV export, formatted and ready for your bookkeeper or auditor without any extra steps.
  • 🔒 Duplicate-safe by design; idempotent storage ensures that retried webhooks or IPN notifications cannot overwrite fee data once it has been recorded.
  • ⚙️ Works with your existing Stripe and PayPal setup; no new webhooks, no changes to your gateway configuration, and no performance overhead on your site.

Get Gateway Fee Tracking with Charitable Pro

Gateway Processing Fee Tracking is available on all Charitable Pro plans: Basic, Plus, Pro, and Elite. Plans start at $69/year, and every plan includes a 14-day, 100% money-back guarantee. No risk, no questions asked.

Not yet on Charitable Pro? Compare all plans and pricing to find the right fit for your organization.

Ready to Enable It?

Knowing your exact net per donation is one of those small operational wins that quietly improves everything: budget planning, grant reporting, and the end-of-month reconciliation your team has been doing by hand. Already on Charitable Pro 1.8.13 or higher?

Head to the Gateway Processing Fee Tracking documentation to get the setup snippet and full developer reference.

Questions? Our support team is here to help.

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 →

author avatar
David Bisset Project Manager
David is the project manager of Charitable since 2022. David works with several non-profits (one operated by his wife) along with managing and developing features, support, and marketing for Charitable. Has been with WordPress since 2006 and has been lead organizer of multiple conferences, events, and meetups.

Disclosure: Our content is reader-supported. This means if you click on some of our links, then we may earn a commission. We only recommend products that we believe will add value to our readers.

Leave a Reply

Your email address will not be published. Required fields are marked *

Get free tips and resources right in your inbox, along with 60,000+ others

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!

Featured Video:

Watch more videos on our YouTube channel.

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!

New templates

🤩 New Beacon Campaign Templates w/ “Hero” Block!

With the new Beacon Campaign Templates for Charitable Pro, you can launch a stunning, full-width fundraising page that instantly captures visitor attention above the fold.

Fundraising page header for Save Maple Grove Park with a donation widget and a small square photo of a sunlit tree thumbnail on the left.

🔦 Above-the-Fold Impact: Lead with a full-width hero image, your logo, and your goal with a donation widget locked right on top of the banner so your ask and momentum register instantly without scrolling.

📐 Two Flexible Layouts: Choose between a structured two-column layout for side-by-side storytelling and supporting details, or a clean one-column view designed for uninterrupted long-form narratives.

⚡ All-in-One Hero Field: Powered by the new Campaign Hero field, bringing background media, live progress bars, custom donation amounts, and recurring giving tabs together into a single cohesive block that can be dropped into any layout.

🎨 Automatic Theme Matching: The hero banner and donation widget automatically inherit your campaign theme’s button and accent colors, ensuring your entire presentation stays beautifully on-brand without touching a line of CSS.

Learn more here.

author avatar
David Bisset Project Manager
David is the project manager of Charitable since 2022. David works with several non-profits (one operated by his wife) along with managing and developing features, support, and marketing for Charitable. Has been with WordPress since 2006 and has been lead organizer of multiple conferences, events, and meetups.
donation form Feature New

📝 Donation Form Block: Embed a Working Donation Form Anywhere

With the new Donation Form Block for Charitable Pro, you can drop a fully working donation form directly onto any page or post in the WordPress block editor. No redirects, no page reloads, and zero friction between reading your story and making a contribution.

📝 Drop Forms Anywhere: Place a working form directly onto your homepage, inside a story-driven blog post, on a dedicated landing page, or within a campaign announcement.

🎯 Dynamic Campaign Binding: Easily choose a specific campaign from the block sidebar or set it to automatically bind to whichever campaign is currently being viewed.

📐 Full vs. Minimal Form Views: Switch between a full layout or a compact minimal view to perfectly fit sidebars, narrow columns, or wide landing pages.

🎨 Scoped No-Code Styling: Customize typography, container spacing, border radius, amount buttons, and accent colors independently for every form instance without touching a line of CSS.

Learn more here.

author avatar
David Bisset Project Manager
David is the project manager of Charitable since 2022. David works with several non-profits (one operated by his wife) along with managing and developing features, support, and marketing for Charitable. Has been with WordPress since 2006 and has been lead organizer of multiple conferences, events, and meetups.
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!

author avatar
David Bisset Project Manager
David is the project manager of Charitable since 2022. David works with several non-profits (one operated by his wife) along with managing and developing features, support, and marketing for Charitable. Has been with WordPress since 2006 and has been lead organizer of multiple conferences, events, and meetups.
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.

author avatar
David Bisset Project Manager
David is the project manager of Charitable since 2022. David works with several non-profits (one operated by his wife) along with managing and developing features, support, and marketing for Charitable. Has been with WordPress since 2006 and has been lead organizer of multiple conferences, events, and meetups.
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.

author avatar
David Bisset Project Manager
David is the project manager of Charitable since 2022. David works with several non-profits (one operated by his wife) along with managing and developing features, support, and marketing for Charitable. Has been with WordPress since 2006 and has been lead organizer of multiple conferences, events, and meetups.