Charitable Razorpay lets your nonprofit accept donations through Razorpay, the leading Indian payment gateway, with built-in support for UPI and campaign QR codes. It is purpose-built for organizations serving Indian donors while still supporting international currencies for global campaigns.

Available as a free addon. Requires Charitable Pro 1.8.13.5 or later. The 1.0.0-beta-1 release is currently in beta exclusively to those who have the Charitable Pro (plugin) and the Pro plan, and your feedback during this period helps shape the general release.

Key Features

• Accept Razorpay donations in live and test modes from a single settings panel
• Offer UPI as a first-class payment method on the donation form for INR campaigns
• Generate per-campaign QR codes that donors scan to give from any UPI app
• Process recurring donations through the Charitable Recurring addon
• Handle refunds directly from the Charitable donation record
• Verify payments through Razorpay webhooks with HMAC signature checking
• Brand the Razorpay popup with your own image and theme color
• Support eight currencies: INR, USD, EUR, GBP, SGD, AED, CAD, AUD

Why Use Charitable Razorpay?

Razorpay is the dominant gateway for charities and donors in India, and UPI now drives the majority of digital donations there. With Charitable Razorpay, you can capture UPI gifts, scan-to-give QR donations, and credit and debit card payments without bolting on a third-party plugin or sending donors to an external checkout. Webhook-driven status updates mean your dashboard reflects the truth at Razorpay, even when a donor closes the browser before the redirect.

Requirements

• Charitable Pro 1.8.13.5 or later
• WordPress 6.2 or later
• PHP 7.4 or later
• A Razorpay merchant account (live and/or test mode)
• For recurring donations: the Charitable Recurring addon

Getting Started

Activation

Upload and activate the Charitable Razorpay plugin from Plugins » Add New.

Go to Charitable » Settings » Payment Gateways.

Click Enable Gateway next to Razorpay. We recommend turning on test mode while you set this up. This will ensure that live transactions don’t go through while you aren’t ready for them.

When you activate the gateway, you’ll see a new Gateway Settings button. This takes you to the settings page where you can enter your API credentials. You can either use your live keys or test keys.

Configuration

1. In your Razorpay dashboard, generate API keys for live mode (and test mode if you want to test first).
2. Paste the Live Key ID and Live Secret Key into the Razorpay settings tab in Charitable.
3. In Razorpay, create a webhook pointing to the URL shown in the Webhook Secret help text on the same settings tab. Copy the webhook secret back into Charitable.
4. Save settings. Submit a small test donation in test mode to confirm the round trip is healthy.

How donors see Razorpay on the donation form

On your campaign page, when a donor clicks to donate, they should now see Razorpay as an option in your donation form.

They can either add in their UPI ID on this form whcih will then be prefilled in the Razorpay payment form.

When a donor clicks the Donate button, Charitable opens the Razorpay popup with the donation amount, donor name and email pre-filled, and your branded image and theme color.

Cards, netbanking, wallet, Pay Later, and UPI options appear in the popup based on what is enabled in your Razorpay merchant account.

QR codes on campaign pages

If you enable QR Code Generation, every published campaign gets a scannable QR code rendered on the campaign page (and a smaller version in the campaign sidebar layout). The QR encodes a UPI deep link to your merchant ID, with the campaign goal amount pre-filled when QR Code Amount Pre-fill is enabled. Donors can scan with any UPI app to send a gift directly to your account.

You can enable this in the same Charitable » Settings » Payment Gateways » Gateway Settings page for Razorpay.

That’s it! You’re all set to accept donations with Razorpay.

Viewing Razorpay Transactions in Charitable

Once donations come in through the Razorpay gateway, you can view them under Charitable » Donations. Here, you’ll see a list of donations along with the amount donated, campaign, date, and payment status. In the Amount Donated column, you’ll see the payment gateway used.

You can choose to view or edit any record here. Inside, you’ll also see details of the Razorpay payment record

Below, we’ll discuss more configuraiton options available to you when you enable Razorpay.

Configuration Options Available for Razorpay

The Razorpay settings live at Charitable » Settings » Payment Gateways » Razorpay.

API & Webhook Credentials

Setting	Type	Default	Description
Live Key ID	text	—	Your Razorpay live merchant key ID.
Live Secret Key	password	—	Your Razorpay live merchant secret key.
Test Key ID	text	—	Your Razorpay test merchant key ID.
Test Secret Key	password	—	Your Razorpay test merchant secret key. Used when Charitable test mode is on.
Webhook Secret	password	—	The shared secret you create in the Razorpay webhook configuration. Without it, payment confirmations and subscription updates are silently rejected.

Donor Experience

Setting	Type	Default	Description
Popup Image	image	—	Image displayed at the top of the Razorpay popup. 80x80px recommended.
Popup Theme Color	color picker	#2bc253	Accent color used inside the Razorpay popup interface.
Phone Field	radio	Enabled	Show a phone number field on the donation form.
Phone Country Code	select	+1	Default country code prepended to the phone field. Includes +1, +91, +44, +61, +65, +971, +33, +49, +81, +86.
Collect Billing Details	radio	Disabled	Collect donor billing address information alongside payment.

UPI & QR Codes

Setting	Type	Default	Description
Enable UPI Integration	radio	Enabled	Adds the UPI payment method to the donation form for INR campaigns.
Enable QR Code Generation	radio	Enabled	Renders a scannable QR code on each campaign’s public page.
QR Code Amount Pre-fill	radio	Enabled	Includes the campaign’s goal amount in the QR code so the donor’s UPI app opens with that value.
UPI Merchant ID	text	—	Your registered UPI merchant ID (VPA). Required for QR code generation.

Customization

Template Overrides

The two front-end templates can be overridden by copying them into your theme:

• templates/donation-form/upi-fields.php → your-theme/charitable/donation-form/upi-fields.php
• templates/qr-code/qr-code-display.php → your-theme/charitable/qr-code/qr-code-display.php

Currency Handling

Razorpay supports INR, USD, EUR, GBP, SGD, AED, CAD, AUD. If your Charitable currency is set to anything outside that list, the integration falls back to INR. UPI and QR-code features are restricted to INR campaigns by Razorpay policy.

Troubleshooting Guide for Razorpay + Charitable

The Razorpay tab is missing from Payment Gateways

Confirm the addon is activated under Plugins. If it is, deactivate and reactivate it. The tab is registered on the Charitable bootstrap, so a fresh activation forces it to appear.

Donations complete in the popup but stay “Pending” in Charitable

The webhook is not reaching your site, or the webhook secret is missing. Check that the webhook URL in your Razorpay dashboard matches the one shown in the Razorpay settings help text, and that the Webhook Secret field is filled in. Make a 1 INR test donation and watch the Charitable → Tools → Logs tab to confirm the webhook arrived.

UPI fields don’t appear on the donation form

UPI is restricted to INR campaigns. Check that Charitable → Settings → General → Currency is set to Indian Rupee, and that Enable UPI Integration is on.

QR code is missing from the campaign page

Check that Enable QR Code Generation is on, that UPI Merchant ID has a valid VPA, and that the campaign currency is INR.

Refunds don’t sync back to Razorpay

Refunds initiated inside Charitable are sent to Razorpay through the API. Refunds issued in the Razorpay dashboard come back through the webhook. If a dashboard-initiated refund is not reflected, the webhook is the issue (see the second troubleshooting entry above).

Developer Resources

Hooks & Filters

• charitable_razorpay_start (action) — Fires once after the Razorpay addon has finished loading. Useful for hooking in additional integrations.
• charitable_razorpay_languages_directory (filter) — Filters the directory used to load translation files.
• charitable_payment_gateway_supports (filter) — Charitable core filter; the addon hooks into this to declare recurring-donation support.

AJAX Endpoints

The addon registers several internal AJAX actions for the donation flow. They are not public API and are documented here for transparency:

• charitable_razorpay_create_order — Creates a Razorpay order before payment.
• charitable_razorpay_verify_payment — Verifies the signature returned by the popup.
• charitable_razorpay_process_upi — Processes a direct UPI submission from the form.
• charitable_razorpay_generate_qr — Generates a campaign QR code on demand.
• charitable_razorpay_download_qr — Returns a downloadable PNG of the campaign QR code.

Webhook URL

The webhook URL Charitable expects Razorpay to call is shown inline in the Webhook Secret help text. It uses Charitable’s standard listener pattern: https://your-site.com/?charitable_listener=razorpay.

How To Share Questions and Feedback

We’re always improving, and your experience with our latest features helps us get it right. It only takes a minute.

Fill out our feedback form »