Charitable Documentation

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

How to Set Up Windcave in Charitable

Windcave is a payment gateway available in New Zealand, Australia, North America, Asia, the UK and Europe, supporting payments in more than 20 currencies.

This guide walks through installing the addon, enabling the gateway, adding your PxPay and PxPost credentials, testing, and refunding a donation.

What’s In This Guide?

Before You Start

  1. The Windcave payment integration is available on Basic plans and higher in the Charitable Pro Plugin. If you’re not yet on Pro, you can create your account now » Here’s a guide to help you install Charitable Pro »
  2. Next, you’ll need to install the Charitable Windcave addon. We’ll show you how to do that next. The Windcave addon comes with the Charitable Pro plugin. After purchasing a plan, you can install it – along with any other included addons – from the addons menu at no extra cost.
  3. You’ll need your own Windcave account before you begin. If you don’t have one yet, sign up at windcave.com.

Windcave operates in New Zealand, Australia, North America, Asia, the UK and Europe. Charitable connects to your own Windcave account, so your donor details and your transactions stay between you and Windcave.

Once your account is active, request your API credentials from your Windcave account manager. Windcave issues 3 separate sets, and which ones you need depends on what you want to do.

  • PxPay 2.0 sends donors to the Windcave hosted payment page. You need this to accept any donation at all.
  • PxPost handles server-to-server transactions. You need this to refund a donation from inside Charitable.
  • HPP/Restful API powers recurring donations. You only need this if you plan to accept recurring gifts.

Note: Ask Windcave for all 3 when you open the account. They are issued separately, and waiting on a second request later is the slowest part of this setup.

Let’s get started.

Installing the Windcave Addon

Go to Charitable » Addons and find Windcave in the list. Click “Install Addon”, then click “Activate” once the install finishes.

The Charitable Addons page with the Windcave addon card showing a Basic plan badge and an Installed status

If you’d rather install from a zip file, you can download the addon and upload it yourself.

In your Charitable account, go to the Downloads tab and scroll down to the Windcave addon. Download the addon here.

Downloads tab in account

In your WordPress dashboard, go to Plugins » Add New » Upload Plugin.

Choose the zip file, click “Install Now”, then click “Activate Plugin”.

If you’re not sure how to install the Windcave addon, we recommend first reading our guide to installing Charitable extensions.

Enabling the Gateway

Go to Charitable » Settings » Payment Gateways. You’ll see Windcave listed with the other gateways. Turn on the toggle in the “Status” column, then click “Save Changes”.

The Charitable Payment Gateways settings tab with the Status toggle for Windcave

A “Settings” button will appear next to Windcave. This will take you to the Windcave settings page where you can configure the gateway.

Adding Your PxPay Credentials

PxPay is what sends your donors to the Windcave hosted payment page, so these 2 fields are the minimum needed to accept donations.

The Windcave gateway settings page in Charitable showing the Gateway Label field and the PxPay User ID and PxPay Key fields
  • Gateway Label is the name donors read on your donation form. Leave it as Windcave, or change it to something your supporters will recognize.
  • PxPay User ID is your Windcave PxPay 2.0 User ID. Find it in Windcave Payline under User Accounts, or ask Windcave support for it.
  • PxPay Key is the PxPay 2.0 key paired with that User ID.

Click “Save Changes” when you’re done. You can start accepting donations as soon as your PxPay settings are in.

Important Note: Windcave has no separate test mode toggle in Charitable. Test and live modes are set by the credentials you enter. Windcave issues test and live credentials separately, so use your UAT credentials while you’re testing and swap in your live credentials when you’re ready to accept real donations.

Adding Your PxPost Credentials

PxPost credentials are required to refund donations from within Charitable. Without them you can still take donations, but you’ll have to process refunds in Windcave Payline instead.

The PxPost Settings section of the Charitable Windcave gateway settings, with PxPost User ID and PxPost Password fields

Enter your PxPost User ID and the PxPost Password paired with it, then click “Save Changes”. These are different from your PxPay credentials, so don’t reuse the PxPay values here.

Accepting Recurring Donations with Windcave

Windcave works alongside Charitable’s Recurring Donations feature, so a donor can set up a monthly or annual gift once and Charitable bills each renewal after that.

Recurring billing uses a third set of credentials, the REST username and Restful API key, which are separate from the PxPay and PxPost credentials above. There’s a “REST API Settings” section further down the same Windcave settings page for them.

Important Note: Recurring Donations is available on Plus plans and higher, while the Windcave gateway starts on Basic. If your plan is Basic, you can take one-off Windcave donations but not recurring ones.

The full setup is covered in its own guide. See Configuring Windcave for Recurring Donations.

Testing Before You Go Live

We always recommend testing a new gateway before you accept real donations. Because Windcave sets its mode from your credentials, testing means entering your UAT credentials rather than turning on a switch.

  1. Ask Windcave for your UAT PxPay User ID and key if you don’t have them already.
  2. Enter the UAT credentials in your Windcave settings and click “Save Changes”.
  3. Make a donation on your own website and choose Windcave as the payment method. You’ll be sent to the Windcave hosted payment page to enter a card.
  4. After you finish, you’ll come back to your website and the donation will appear under Charitable » Donations.
  5. When the test donation looks right, replace the UAT credentials with your live ones and click “Save Changes” again.

Important: Your test donations were made against a different Windcave account, so clear them out of Charitable » Donations before you go live if you don’t want them in your reports.

Refunding a Windcave Donation

With your PxPost credentials saved, you can refund straight from Charitable and the money is returned in Windcave at the same time.

  1. Go to Charitable » Donations and find the donation you need to refund.
  2. Click “View” to open it.
  3. In the “Donation Actions” box, select “Refunded”.
  4. Check the box to refund the donation in Windcave automatically.
  5. Click “Update Status”.

Note: If you leave that checkbox unchecked, Charitable marks the donation as refunded in your records but no money moves. Use that only when you’ve already refunded the donor in Payline.

Making Windcave the Default Gateway

If you have more than one gateway enabled, the default is the one selected for your donors when your donation form loads. Go to Charitable » Settings » Payment Gateways, choose Windcave in the “Default” column, and click “Save Changes”.

Pro tip: Keep a second gateway enabled even after you make Windcave the default. Donors who don’t want to leave your site for a hosted page still have somewhere to go.

Adding Fee Relief

Windcave charges a fee on every donation it processes. Charitable’s Fee Relief feature invites your donors to add a little extra to cover that fee, so more of the gift reaches your cause.

Fee Relief lets you configure the way the fee is calculated, and it works with Windcave the same way it works with any other gateway.

Here’s how to set up fee relief »

Windcave is available starting on the Basic plan.

FAQs on Windcave

Do I need my own Windcave account to use this addon?

Yes. The addon connects to an account you create directly with Windcave. If you don’t have one yet, sign up at windcave.com before you start.

Is Windcave the same thing as Payment Express?

Yes. Payment Express renamed itself Windcave. If your account paperwork or your bank still says Payment Express, your credentials work here.

Where do donors enter their card details?

On a payment page hosted by Windcave, which donors are sent to after they submit your donation form. Card numbers never reach your website or your database.

Why is there no Test Mode setting for Windcave?

Windcave issues separate credentials for testing and for live donations, so the credentials you save decide which mode you’re in. Enter your UAT credentials to test, and your live credentials to accept real money.

Do I have to add PxPost credentials?

No, donations work without them. You need them to refund a donation from inside Charitable, which is why we recommend adding them while you’re on the settings page anyway.

Can I accept recurring donations through Windcave?

Yes, on Plus plans and higher. Recurring billing needs a REST username and Restful API key from Windcave, which are separate from your PxPay credentials. See Configuring Windcave for Recurring Donations.

Which currencies and payment methods does Windcave support?

More than 20 currencies and over 300 payment methods, including Visa, Mastercard, American Express, Diners Club, Apple Pay, Google Pay, and EFTPOS in Australia and New Zealand. Payment methods change from time to time, so check windcave.com for the current list.

My donors reach Windcave but the donation never comes back as complete. What should I check?

Check that your PxPay User ID and PxPay Key are both from the same Windcave account and the same mode. A live User ID paired with a UAT key, or the other way round, is the most common cause.

More Documentation

Helpful Links

🤝 Get help when you need it

Connect with Customer Support →

📑 Find the guide you need

Browse the Documentation Hub →

⬇️ Download proven strategies, campaign ideas, and expert tools

Get the Fundraising Kit →

🔗 Let your AI Assistant do the fundraising work for you.

Connect Charitable to your AI assistant →

💸 Get Free Fundraising Resources
Head to the Charitable Fundraising Hub →

🤔 Got questions about Charitable?
Charitable FAQs →

Need help understanding non-profit terms and jargon?
See our Non-Profit Glossary →

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!

Donations New

👥 Introducing Donor Merging: Two Records, One Supporter!

Somewhere in your donor list is a supporter who appears twice, because they gave from a work address one year and a personal one the next. Every donation is still recorded and every receipt still went out, but a loyal supporter who has given for years can look like two people who gave half as much. From the Charitable Pro plugin 1.8.19.1 you can find those records and merge them from the Donors screen. Why this is important:

  • 🔍 A Find Duplicates link where you already work: Head to Charitable » Donors and it sits next to Filter and Export, then tells you how many groups of possible duplicates it found.
  • 🧩 Grouped by name, not by email: Charitable compares the first and last name together and ignores capital letters, spacing and punctuation, which is what catches the same person under two different addresses.
  • 📊 A preview before anything changes: Each group shows every record with its email address, its donation count and its lifetime total, and the preview shows you the combined totals and the email that will be added.
  • ↩️ Every merge can be undone: Nothing is merged until you choose to merge it, and you can reverse any merge afterwards, so a wrong guess costs you nothing.
  • 📥 Built for the week after an import: Moving donors over from another plugin is where most duplicates come from, and it is also when they are hardest to spot, because every record is new to you.

Check out our announcement here.

ambassadors New

🔑 Introducing Passwordless Fundraisers: Sign Up With Just an Email!

Supporters arrive wanting to help, and then the form asks them to invent a password for a website they may only visit twice. A lot of them stop right there. Passwordless Fundraiser Accounts, new in Charitable Ambassadors 3.5.0, let a supporter start a peer to peer fundraiser with nothing but an email address. Why this is important:

  • 🔑 No password step to lose them at: Switch it on in Charitable » Ambassadors » Templates » Submit Form and the create-fundraiser form asks only for a name, an email address and a page title.
  • 👤 Still a real WordPress account: One click in one email confirms the address, signs them in and creates the account, so they can come back later to edit their story, change their photo and see who has donated.
  • 🎚️ Your call on every campaign: Each peer to peer campaign can follow the site default or override it, which matters when a campaign pays fundraisers through Stripe Connect and those people do need a password.
  • 📋 See who has not clicked yet: The Charitable » Ambassadors » Directory » Awaiting Sign-In tab lists everyone still waiting, with the campaign they joined and a Resend button, so a typo or a spam folder is something you can spot and fix.
  • 🛡️ Links a scanner cannot use up: Opening the link only shows a page, and your fundraiser is signed in when they press the button on it, so corporate email scanners never burn the link. Each one works once, expires on its own and is stored only as a hash.

Check out our announcement here.

ambassadors New

🏃 Introducing Activity: Show Progress on More Than Money!

Most peer-to-peer fundraisers are about more than the money. A read-a-thon is about minutes read, a walkathon is about miles walked, and a food drive is about meals packed. Activity for Charitable Ambassadors lets your fundraisers show that effort right beside the dollars they raise. Why this is important:

  • 🎯 Progress on what you actually count: A progress bar shows each thing you count against its own target, sitting right beside the money raised.
  • 🏅 Milestones for the yes or no things: A milestone badge marks the efforts that are simply done or not done, with no number to chase.
  • ✍️ Fundraisers log their own numbers: Your supporters enter their totals from their own pages, so the effort stops living in a spreadsheet, a comment, or nowhere at all.
  • 🤖 Some numbers count themselves: An AUTOMATIC tag appears wherever the site worked the figure out from completed donations, so you can see at a glance what nobody typed in.
  • 🧩 Set it up once, use it anywhere: You decide what gets counted one time, then choose which campaigns count it. Available now in Charitable Ambassadors 3.4.7, with no new plugin and no developer.

Check out our announcement here.

ambassadors New

🖨️ Introducing Fliers and Posters: Raise Money Away From the Screen!

A lot of peer-to-peer fundraising happens away from a screen: at the finish line of a 5K, on a school noticeboard, in an office kitchen. Charitable Ambassadors 3.4.7 adds 2 printables, a fundraiser flier carrying each fundraiser’s own story and QR code, and a recruitment poster that signs new fundraisers up. Both open as a normal web page and print straight from the browser. Why this is important:

  • 🏁 A flier for every fundraiser: Each one carries that fundraiser’s own photo, story and goal, with a QR code that opens their page rather than your main campaign.
  • 📌 A poster that recruits: It shows “Now Recruiting” above your campaign name with a large QR code that opens your sign-up form, so someone can start fundraising without waiting on a link from you.
  • 🪄 No design tool needed: Both printables render as a normal web page and print from the browser, with no PDF plugin and no designer.
  • 📄 2 flier layouts: Hand out carries the full story for giving to friends and family, and Post up carries a short hook with 5 tear-off tabs for a noticeboard.
  • 🛡️ Off until you switch it on: Fliers stay off after the update until you enable them under Charitable » Ambassadors » Other » Fliers, and only the owner or an administrator can open one.

Check out our announcement here.

Improvement Payments

💸 Introducing Tiered Rates for Fee Relief: Match the Ask to the Gift!

Fee Relief asks your donors one short question at checkout: would you like to cover the processing fee on this gift? Until now that question used a single rate for every donation on a gateway, so a $10 gift and a $500 gift were asked for the same percentage. Fee Relief 1.3.0 lets you set as many donation bands as you like, each carrying its own rate. Why this is important:

  • 🪙 Gentler on small gifts: A fixed transaction cost is a far bigger share of a $10 donation than a $500 one, so bands let you ask for less at the bottom.
  • 🎚️ As many bands as you need: Each band carries its own percentage and its own fixed amount, and the top band runs on with no upper limit.
  • 🛑 An optional ceiling: A Maximum fee field stops any donor being asked for more than a number you choose, however large the gift.
  • 🔌 Set per payment gateway: Stripe can run on four bands while Windcave and Payfast stay on a single rate, because bands belong to a gateway and not to your whole site.
  • 🛡️ Nothing changes until you say so: Your current rates stay exactly as they are until you switch Use Tiered Rates on under Charitable » Settings » Advanced » Fee Relief.

Check out our announcement here.