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.
Exigences
- 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
Démarrage
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
- In your Razorpay dashboard, generate API keys for live mode (and test mode if you want to test first).
- Paste the Live Key ID and Live Secret Key into the Razorpay settings tab in Charitable.
- 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.
- 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
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| Live Key ID | texte | — | Your Razorpay live merchant key ID. |
| Live Secret Key | mot de passe | — | Your Razorpay live merchant secret key. |
| Test Key ID | texte | — | Your Razorpay test merchant key ID. |
| Test Secret Key | mot de passe | — | Your Razorpay test merchant secret key. Used when Charitable test mode is on. |
| Webhook Secret | mot de passe | — | The shared secret you create in the Razorpay webhook configuration. Without it, payment confirmations and subscription updates are silently rejected. |
Donor Experience
| Paramètre | Type | Défaut | 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 | sélectionner | +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
| Paramètre | Type | Défaut | 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 | texte | — | Your registered UPI merchant ID (VPA). Required for QR code generation. |
Personnalisation
Remplacement de modèles
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.phptemplates/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 et filtres
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.
Charitable a plus d'un million de téléchargements !
Faites confiance à des millions de personnes pour mener à bien vos campagnes de collecte de fonds. Essayez Charitable sans risque dès aujourd'hui.
✅ Garantie de remboursement de 14 jours
✅ Tarification transparente
✅ Configuration sans code
Restez connecté pour plus de ressources pour les organisations à but non lucratif
Pour plus de tutoriels et de vidéos adaptés aux organisations à but non lucratif, abonnez-vous à notre chaîne YouTube. Nous publions régulièrement des conseils d'experts, des guides étape par étape sur les dons en ligne, des stratégies de collecte de fonds et des ressources pratiques pour aider votre organisation à réussir.
🗞️ Recevez des conseils hebdomadaires et des guides exclusifs dans votre boîte de réception
Rejoignez notre newsletter →
🎥 Regardez des tutoriels étape par étape et des histoires de réussite
Abonnez-vous à notre chaîne YouTube →
👩🏽💻 Connectez-vous avec notre communauté et obtenez des informations quotidiennes sur les organisations à but non lucratif
Suivez-nous sur LinkedIn →
🥳 Reels amusants et informations sur les organisations à but non lucratif
Suivez-nous sur Instagram →
👀 Vidéos perspicaces et amusantes pour vous aider à développer votre cause
Suivez-nous sur TikTok→
🌎 Abonnez-vous et suivez pour des conseils généraux sur la collecte de fonds
Obtenez des conseils sur la collecte de fonds sur TikTok →
Ressources puissantes pour la collecte de fonds
⬇️ Téléchargez des stratégies éprouvées, des idées de campagnes et des outils d'experts
Obtenez le kit de collecte de fonds →
💸 Obtenez des ressources gratuites pour la collecte de fonds
Rendez-vous sur le Hub de collecte de fonds Charitable →
🤔 Des questions sur Charitable ?
FAQ Charitable →
🏎️ Essayez Charitable
Créez votre démo Charitable →
Comprendre les termes et le jargon des organisations à but non lucratif
Glossaire des organisations à but non lucratif→
% Vous recherchez des offres et des réductions pour les organisations à but non lucratif ?
Meilleures offres et réductions pour les organisations à but non lucratif →
