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!

Improvement Payments

💰 Accept Recurring Donations with Windcave and Charitable

A donor sets their gift up once on Windcave’s secure payment page, and Charitable bills every renewal after that on schedule. Why this is important:

🏦 Organizations banked in New Zealand or Australia: monthly giving on the gateway your bank already set you up with, with no second processor to onboard.
⛪ Churches taking regular tithes and offerings: congregants set their own schedule once, which is the simplest way to launch recurring church giving without a separate platform.
🌏 Groups with donors in several currencies: Windcave handles more than 20, so a supporter can give in the currency they actually hold.
📅 Operating funds rather than one-time campaigns: switch on Recurring Only mode and the one-off option disappears, so every gift to that campaign is a subscription.
🧾 Teams with no developer on staff: 3 sets of credentials pasted into a settings page, and no code anywhere.

Check out our announcement 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.
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.

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.
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!

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.
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!

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.
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.

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.