Charitable Razorpay permet à votre organisation à but non lucratif d'accepter des dons via Razorpay, la principale passerelle de paiement indienne, avec une prise en charge intégrée de l'UPI et des codes QR de campagne. Il est spécialement conçu pour les organisations au service des donateurs indiens tout en prenant en charge les devises internationales pour les campagnes mondiales.

Disponible en tant que module complémentaire gratuit. Nécessite Charitable Pro 1.8.13.5 ou une version ultérieure. La version 1.0.0-beta-1 est actuellement en bêta exclusivement pour ceux qui possèdent le plugin Charitable Pro et le plan Pro, et vos commentaires pendant cette période aident à façonner la version générale.

Fonctionnalités clés

• Acceptez les dons Razorpay en mode réel et en mode test à partir d'un seul panneau de configuration
• Proposez l'UPI comme méthode de paiement de premier plan sur le formulaire de don pour les campagnes en INR
• Générez des codes QR par campagne que les donateurs scannent pour donner à partir de n'importe quelle application UPI
• Traitez les dons récurrents via le module complémentaire Charitable Recurring
• Gérez les remboursements directement à partir de l'enregistrement du don Charitable
• Vérifiez les paiements via les webhooks Razorpay avec vérification de la signature HMAC
• Personnalisez le popup Razorpay avec votre propre image et couleur de thème
• Prend en charge huit devises : INR, USD, EUR, GBP, SGD, AED, CAD, AUD

Pourquoi utiliser Charitable Razorpay ?

Razorpay est la passerelle dominante pour les organisations caritatives et les donateurs en Inde, et l'UPI représente désormais la majorité des dons numériques. Avec Charitable Razorpay, vous pouvez accepter les dons UPI, les dons par code QR à scanner et les paiements par carte de crédit et de débit sans avoir à ajouter un plugin tiers ou à envoyer les donateurs vers une page de paiement externe. Les mises à jour de statut pilotées par webhook signifient que votre tableau de bord reflète la vérité chez Razorpay, même lorsqu'un donateur ferme le navigateur avant la redirection.

Exigences

• Charitable Pro 1.8.13.5 ou une version ultérieure
• WordPress 6.2 ou ultérieure
• PHP 7.4 ou version ultérieure
• Un compte marchand Razorpay (mode réel et/ou mode test)
• Pour les dons récurrents : le module complémentaire Charitable Recurring

Démarrage

Activation

Téléchargez et activez le plugin Charitable Razorpay depuis Plugins » Ajouter.

Accédez à Charitable » Paramètres » Passerelles de paiement.

Cliquez sur Activer la passerelle à côté de Razorpay. Nous vous recommandons d'activer le mode test pendant que vous configurez cela. Cela garantira que les transactions réelles ne se produisent pas tant que vous n'êtes pas prêt pour elles.

Lorsque vous activez la passerelle, vous verrez un nouveau bouton Paramètres de la passerelle. Cela vous mènera à la page des paramètres où vous pourrez entrer vos identifiants API. Vous pouvez utiliser vos clés réelles ou vos clés de test.

Configuration

1. Dans votre tableau de bord Razorpay, générez des clés API pour le mode réel (et le mode test si vous souhaitez tester d'abord).
2. Collez l'**ID de clé réelle** et la **Clé secrète réelle** dans l'onglet des paramètres Razorpay dans Charitable.
3. Dans Razorpay, créez un webhook pointant vers l'URL indiquée dans le texte d'aide **Secret du webhook** du même onglet de paramètres. Copiez le secret du webhook dans Charitable.
4. Enregistrez les paramètres. Soumettez un petit don de test en mode test pour confirmer que l'aller-retour est sain.

Comment les donateurs voient Razorpay sur le formulaire de don

Sur votre page de campagne, lorsqu'un donateur clique pour faire un don, il devrait maintenant voir Razorpay comme option dans votre formulaire de don.

Il peut soit ajouter son identifiant UPI dans ce formulaire, qui sera ensuite pré-rempli dans le formulaire de paiement Razorpay.

Lorsqu'un donateur clique sur le bouton Donner, Charitable ouvre la fenêtre contextuelle Razorpay avec le montant du don, le nom et l'e-mail du donateur pré-remplis, ainsi que votre image de marque et la couleur de votre thème.

Les options Cartes, Netbanking, Portefeuille, Payer plus tard et UPI apparaissent dans la fenêtre contextuelle en fonction de ce qui est activé dans votre compte marchand Razorpay.

Codes QR sur les pages de campagne

Si vous activez la Génération de code QR, chaque campagne publiée obtient un code QR scannable rendu sur la page de campagne (et une version plus petite dans la mise en page de la barre latérale de la campagne). Le QR code encode un lien profond UPI vers votre identifiant marchand, avec le montant de l'objectif de la campagne pré-rempli lorsque le Montant du code QR pré-rempli est activé. Les donateurs peuvent scanner avec n'importe quelle application UPI pour envoyer un cadeau directement sur votre compte.

Vous pouvez activer cela dans la même page Charitable » Paramètres » Passerelles de paiement » Paramètres de la passerelle pour Razorpay.

C'est tout ! Vous êtes prêt à accepter des dons avec Razorpay.

Visualisation des transactions Razorpay dans Charitable

Une fois que les dons arrivent via la passerelle Razorpay, vous pouvez les consulter sous Charitable » Dons. Ici, vous verrez une liste des dons avec le montant donné, la campagne, la date et le statut du paiement. Dans la colonne Montant donné, vous verrez la passerelle de paiement utilisée.

Vous pouvez choisir de visualiser ou de modifier n'importe quel enregistrement ici. À l'intérieur, vous verrez également les détails de l'enregistrement du paiement Razorpay

Ci-dessous, nous discuterons d'autres options de configuration disponibles pour vous lorsque vous activez Razorpay.

Options de configuration disponibles pour Razorpay

Les paramètres Razorpay se trouvent dans Charitable » Paramètres » Passerelles de paiement » Razorpay.

Identifiants API et Webhook

Paramètre	Type	Défaut	Description
ID de clé en direct	texte	—	Votre ID de clé marchand en direct Razorpay.
Clé secrète en direct	mot de passe	—	Votre clé secrète marchand en direct Razorpay.
ID de clé de test	texte	—	Votre ID de clé marchand de test Razorpay.
Clé secrète de test	mot de passe	—	Votre clé secrète marchand de test Razorpay. Utilisée lorsque le mode test de Charitable est activé.
Secret du webhook	mot de passe	—	Le secret partagé que vous créez dans la configuration du webhook Razorpay. Sans lui, les confirmations de paiement et les mises à jour d'abonnement sont silencieusement rejetées.

Expérience du donateur

Paramètre	Type	Défaut	Description
Image de la fenêtre contextuelle	image	—	Image affichée en haut de la fenêtre contextuelle Razorpay. 80x80px recommandé.
Couleur du thème de la fenêtre contextuelle	Sélecteur de couleur	#2bc253	Couleur d'accentuation utilisée dans l'interface contextuelle de Razorpay.
Champ Téléphone	radio	Activé	Afficher un champ de numéro de téléphone sur le formulaire de don.
Code Pays Téléphone	sélectionner	+1	Code pays par défaut ajouté au champ téléphone. Inclut +1, +91, +44, +61, +65, +971, +33, +49, +81, +86.
Collecter les informations de facturation	radio	Désactivé	Collecter les informations d'adresse de facturation du donateur en plus du paiement.

Codes UPI & QR

Paramètre	Type	Défaut	Description
Activer l'intégration UPI	radio	Activé	Ajoute le mode de paiement UPI au formulaire de don pour les campagnes en INR.
Activer la génération de code QR	radio	Activé	Affiche un code QR scannable sur la page publique de chaque campagne.
Pré-remplissage du montant du code QR	radio	Activé	Inclut le montant objectif de la campagne dans le code QR afin que l'application UPI du donateur s'ouvre avec cette valeur.
Identifiant Marchand UPI	texte	—	Votre identifiant marchand UPI enregistré (VPA). Requis pour la génération de code QR.

Personnalisation

Remplacement de modèles

Les deux modèles front-end peuvent être remplacés en les copiant dans votre thème :

• 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

Gestion des devises

Razorpay prend en charge INR, USD, EUR, GBP, SGD, AED, CAD, AUD. Si la devise de Charitable est définie sur autre chose que cette liste, l'intégration se rabat sur l'INR. Les fonctionnalités UPI et code QR sont restreintes aux campagnes INR par la politique de Razorpay.

Guide de dépannage pour Razorpay + Charitable

L'onglet Razorpay est manquant dans les passerelles de paiement

Confirmez que le module complémentaire est activé sous Plugins. Si c'est le cas, désactivez-le et réactivez-le. L'onglet est enregistré au démarrage de Charitable, donc une nouvelle activation le force à apparaître.

Les dons se terminent dans la fenêtre contextuelle mais restent « En attente » dans Charitable

Le webhook n'atteint pas votre site, ou le secret du webhook est manquant. Vérifiez que l'URL du webhook dans votre tableau de bord Razorpay correspond à celle affichée dans le texte d'aide des paramètres Razorpay, et que le champ Secret du webhook est rempli. Effectuez un don de test de 1 INR et regardez l'onglet Charitable → Outils → Journaux pour confirmer l'arrivée du webhook.

Les champs UPI n'apparaissent pas sur le formulaire de don

L'UPI est limité aux campagnes en INR. Vérifiez que Charitable → Paramètres → Général → Devise est défini sur la Roupie Indienne, et que Activer l'intégration UPI est activé.

Le code QR est manquant sur la page de la campagne

Vérifiez que Activer la génération de code QR est activé, que ID marchand UPI contient un VPA valide, et que la devise de la campagne est l'INR.

Les remboursements ne se synchronisent pas avec Razorpay

Les remboursements initiés dans Charitable sont envoyés à Razorpay via l'API. Les remboursements effectués dans le tableau de bord Razorpay reviennent via le webhook. Si un remboursement initié depuis le tableau de bord n'est pas reflété, le webhook est le problème (voir la deuxième entrée de dépannage ci-dessus).

Ressources pour les développeurs

Hooks et filtres

• charitable_razorpay_start (action) — S'exécute une fois après le chargement complet du module Razorpay. Utile pour intégrer des intégrations supplémentaires.
• charitable_razorpay_languages_directory (filtre) — Filtre le répertoire utilisé pour charger les fichiers de traduction.
• charitable_payment_gateway_supports (filtre) — Filtre principal de Charitable ; le module s'y accroche pour déclarer le support des dons récurrents.

Points de terminaison AJAX

Le module enregistre plusieurs actions AJAX internes pour le flux de dons. Ce ne sont pas des API publiques et elles sont documentées ici par souci de transparence :

• charitable_razorpay_create_order — Crée une commande Razorpay avant le paiement.
• charitable_razorpay_verify_payment — Vérifie la signature renvoyée par la fenêtre contextuelle.
• charitable_razorpay_process_upi — Traite une soumission UPI directe depuis le formulaire.
• charitable_razorpay_generate_qr — Génère un code QR de campagne à la demande.
• charitable_razorpay_download_qr — Renvoie un PNG téléchargeable du code QR de la campagne.

URL du webhook

L'URL du webhook que Charitable attend que Razorpay appelle est affichée en ligne dans le texte d'aide du Secret du webhook. Elle utilise le modèle d'écouteur standard de Charitable : https://votre-site.com/?charitable_listener=razorpay.

Comment partager des questions et des commentaires

Nous nous améliorons constamment, et votre expérience avec nos dernières fonctionnalités nous aide à bien faire les choses. Cela ne prend qu'une minute.

Remplissez notre formulaire de commentaires »

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 →