Charitable Razorpay permite que su organización sin fines de lucro acepte donaciones a través de Razorpay, la pasarela de pago líder en la India, con soporte integrado para UPI y códigos QR de campaña. Está diseñado específicamente para organizaciones que atienden a donantes indios, al tiempo que admite divisas internacionales para campañas globales.
Disponible como un complemento gratuito. Requiere Charitable Pro 1.8.13.5 o posterior. La versión 1.0.0-beta-1 se encuentra actualmente en beta exclusivamente para aquellos que tienen Charitable Pro (plugin) y el plan Pro, y sus comentarios durante este período ayudan a dar forma a la versión general.
Características clave
- Acepte donaciones de Razorpay en modos en vivo y de prueba desde un único panel de configuración
- Ofrezca UPI como método de pago de primera clase en el formulario de donación para campañas en INR
- Genere códigos QR por campaña que los donantes escanean para donar desde cualquier aplicación UPI
- Procese donaciones recurrentes a través del complemento Charitable Recurring
- Gestione reembolsos directamente desde el registro de donaciones de Charitable
- Verifique pagos a través de webhooks de Razorpay con verificación de firma HMAC
- Personalice el popup de Razorpay con su propia imagen y color temático
- Soporte para ocho divisas: INR, USD, EUR, GBP, SGD, AED, CAD, AUD
¿Por qué usar Charitable Razorpay?
Razorpay es la pasarela dominante para organizaciones benéficas y donantes en la India, y UPI ahora impulsa la mayoría de las donaciones digitales allí. Con Charitable Razorpay, puede capturar donaciones UPI, donaciones con código QR para escanear y pagos con tarjeta de crédito y débito sin necesidad de un complemento de terceros o de enviar a los donantes a un proceso de pago externo. Las actualizaciones de estado impulsadas por webhooks significan que su panel refleja la verdad en Razorpay, incluso cuando un donante cierra el navegador antes de la redirección.
Requisitos
- Charitable Pro 1.8.13.5 o posterior
- WordPress 6.2 o posterior
- PHP 7.4 o posterior.
- Una cuenta de comerciante de Razorpay (modo en vivo y/o de prueba)
- Para donaciones recurrentes: el complemento Charitable Recurring
Empezar
Activación
Cargue y active el plugin Charitable Razorpay desde Plugins » Añadir nuevo.
Vaya a Charitable » Ajustes » Pasarelas de pago.
Haga clic en Activar Pasarela junto a Razorpay. Recomendamos activar el modo de prueba mientras configura esto. Esto asegurará que las transacciones en vivo no se realicen mientras no esté preparado para ellas.
Cuando active la pasarela, verá un nuevo botón Ajustes de Pasarela. Esto le llevará a la página de ajustes donde puede introducir sus credenciales de API. Puede usar sus claves en vivo o sus claves de prueba.
Configuración
- En su panel de Razorpay, genere claves de API para el modo en vivo (y modo de prueba si desea probar primero).
- Pegue el ID de Clave en Vivo y la Clave Secreta en Vivo en la pestaña de ajustes de Razorpay en Charitable.
- En Razorpay, cree un webhook que apunte a la URL que se muestra en el texto de ayuda Secreto del Webhook en la misma pestaña de ajustes. Copie el secreto del webhook de vuelta a Charitable.
- Guarde los ajustes. Envíe una pequeña donación de prueba en modo de prueba para confirmar que el ciclo completo es correcto.
Cómo los donantes ven Razorpay en el formulario de donación
En la página de tu campaña, cuando un donante hace clic para donar, ahora debería ver Razorpay como una opción en tu formulario de donación.
Pueden agregar su ID de UPI en este formulario, que luego se autocompletará en el formulario de pago de Razorpay.
Cuando un donante hace clic en el botón Donar, Charitable abre la ventana emergente de Razorpay con el monto de la donación, el nombre y el correo electrónico del donante autocompletados, y tu imagen de marca y color temático.
Las opciones de tarjetas, banca neta, billetera, Paga después y UPI aparecen en la ventana emergente según lo que esté habilitado en tu cuenta de comerciante de Razorpay.
Códigos QR en las páginas de campaña
Si habilitas la Generación de Códigos QR, cada campaña publicada obtiene un código QR escaneable mostrado en la página de la campaña (y una versión más pequeña en el diseño de la barra lateral de la campaña). El código QR codifica un enlace directo de UPI a tu ID de comerciante, con el monto objetivo de la campaña prellenado cuando se habilita el Autocompletado de Monto del Código QR. Los donantes pueden escanear con cualquier aplicación de UPI para enviar un regalo directamente a tu cuenta.
Puedes habilitar esto en la misma página Charitable » Configuración » Pasarelas de Pago » Configuración de Pasarela para Razorpay.
¡Eso es todo! Estás listo para aceptar donaciones con Razorpay.
Visualización de Transacciones de Razorpay en Charitable
Una vez que las donaciones lleguen a través de la pasarela de Razorpay, puedes verlas en Charitable » Donaciones. Aquí, verás una lista de donaciones junto con el monto donado, la campaña, la fecha y el estado del pago. En la columna Monto Donado, verás la pasarela de pago utilizada.
Puedes elegir ver o editar cualquier registro aquí. Dentro, también verás los detalles del registro de pago de Razorpay.
A continuación, discutiremos más opciones de configuración disponibles para ti cuando habilites Razorpay.
Opciones de Configuración Disponibles para Razorpay
La configuración de Razorpay se encuentra en Charitable » Configuración » Pasarelas de Pago » Razorpay.
Credenciales de API y Webhook
| Configuración | Tipo | Predeterminado | Descripción |
|---|---|---|---|
| ID de Clave en Vivo | texto | — | El ID de clave de comerciante en vivo de tu Razorpay. |
| Clave Secreta en Vivo | contraseña | — | La clave secreta de comerciante en vivo de tu Razorpay. |
| ID de Clave de Prueba | texto | — | El ID de clave de comerciante de prueba de tu Razorpay. |
| Clave Secreta de Prueba | contraseña | — | La clave secreta de comerciante de prueba de tu Razorpay. Se usa cuando el modo de prueba de Charitable está activado. |
| Secreto de Webhook | contraseña | — | El secreto compartido que creas en la configuración del webhook de Razorpay. Sin él, las confirmaciones de pago y las actualizaciones de suscripción se rechazan silenciosamente. |
Experiencia del Donante
| Configuración | Tipo | Predeterminado | Descripción |
|---|---|---|---|
| Imagen Emergente | imagen | — | Imagen mostrada en la parte superior de la ventana emergente de Razorpay. Se recomiendan 80x80px. |
| Color Temático Emergente | Selector de color | #2bc253 | Color de acento utilizado en la interfaz emergente de Razorpay. |
| Campo de teléfono | radio | Activado | Mostrar un campo de número de teléfono en el formulario de donación. |
| Código de país del teléfono | seleccionar | +1 | Código de país predeterminado antepuesto al campo del teléfono. Incluye +1, +91, +44, +61, +65, +971, +33, +49, +81, +86. |
| Recopilar detalles de facturación | radio | Desactivado | Recopilar información de la dirección de facturación del donante junto con el pago. |
Códigos UPI y QR
| Configuración | Tipo | Predeterminado | Descripción |
|---|---|---|---|
| Habilitar integración UPI | radio | Activado | Añade el método de pago UPI al formulario de donación para campañas en INR. |
| Habilitar generación de códigos QR | radio | Activado | Renderiza un código QR escaneable en la página pública de cada campaña. |
| Pre-relleno de importe del código QR | radio | Activado | Incluye el importe objetivo de la campaña en el código QR para que la aplicación UPI del donante se abra con ese valor. |
| ID de comerciante UPI | texto | — | Tu ID de comerciante UPI registrado (VPA). Requerido para la generación de códigos QR. |
Personalización
Anulaciones de plantillas
Las dos plantillas front-end se pueden anular copiándolas en tu tema:
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
Gestión de divisas
Razorpay admite INR, USD, EUR, GBP, SGD, AED, CAD, AUD. Si la divisa de Charitable está configurada en algo fuera de esa lista, la integración recurre a INR. Las funciones de UPI y código QR están restringidas a campañas en INR por política de Razorpay.
Guía de solución de problemas para Razorpay + Charitable
Falta la pestaña de Razorpay en Pasarelas de pago
Confirma que el complemento está activado en Plugins. Si lo está, desactívalo y reactívalo. La pestaña se registra en el arranque de Charitable, por lo que una activación reciente la fuerza a aparecer.
Las donaciones se completan en la ventana emergente pero permanecen “Pendientes” en Charitable
La webhook no llega a tu sitio o falta el secreto de la webhook. Comprueba que la URL de la webhook en tu panel de Razorpay coincide con la que se muestra en el texto de ayuda de la configuración de Razorpay, y que el campo Secreto de la webhook está rellenado. Realiza una donación de prueba de 1 INR y observa la pestaña Charitable → Herramientas → Registros para confirmar que la webhook llegó.
Los campos UPI no aparecen en el formulario de donación
UPI está restringido a campañas en INR. Comprueba que Benéfico → Ajustes → General → Moneda esté configurado en Rupia India, y que Activar Integración UPI esté activado.
Falta el código QR en la página de la campaña
Comprueba que Activar Generación de Código QR esté activado, que ID de Comerciante UPI tenga una VPA válida y que la moneda de la campaña sea INR.
Los reembolsos no se sincronizan con Razorpay
Los reembolsos iniciados dentro de Benéfico se envían a Razorpay a través de la API. Los reembolsos emitidos en el panel de control de Razorpay vuelven a través del webhook. Si un reembolso iniciado desde el panel de control no se refleja, el problema es el webhook (ver la segunda entrada de solución de problemas anterior).
Recursos para desarrolladores
Ganchos y filtros
charitable_razorpay_start(acción) — Se dispara una vez después de que el complemento Razorpay haya terminado de cargarse. Útil para integrar integraciones adicionales.charitable_razorpay_languages_directory(filtro) — Filtra el directorio utilizado para cargar archivos de traducción.charitable_payment_gateway_supports(filtro) — Filtro principal de Benéfico; el complemento se engancha a esto para declarar el soporte de donaciones recurrentes.
Endpoints AJAX
El complemento registra varias acciones AJAX internas para el flujo de donaciones. No son una API pública y se documentan aquí por transparencia:
charitable_razorpay_create_order— Crea un pedido de Razorpay antes del pago.charitable_razorpay_verify_payment— Verifica la firma devuelta por la ventana emergente.charitable_razorpay_process_upi— Procesa un envío directo de UPI desde el formulario.charitable_razorpay_generate_qr— Genera un código QR de campaña bajo demanda.charitable_razorpay_download_qr— Devuelve un PNG descargable del código QR de la campaña.
URL de Webhook
La URL del webhook que Benéfico espera que Razorpay llame se muestra en línea en el texto de ayuda de Secreto del Webhook. Utiliza el patrón de escucha estándar de Benéfico: https://your-site.com/?charitable_listener=razorpay.
Cómo Compartir Preguntas y Comentarios
Siempre estamos mejorando, y tu experiencia con nuestras últimas funciones nos ayuda a hacerlo bien. Solo lleva un minuto.
Rellena nuestro formulario de comentarios »
¡Caritable tiene más de 1.2 millones de descargas!
Confiado por millones para impulsar campañas de recaudación de fondos exitosas. Prueba Charitable sin riesgos hoy mismo.
✅ Garantía de devolución de dinero en 14 días
✅ Precios transparentes
✅ Configuración sin código
Mantente conectado para más recursos para organizaciones sin fines de lucro
Para más tutoriales y vídeos adaptados a organizaciones sin fines de lucro, suscríbete a nuestro canal de YouTube. Publicamos regularmente consejos de expertos, guías paso a paso sobre donaciones en línea, estrategias de recaudación de fondos y recursos prácticos para ayudar a tu organización a tener éxito.
🗞️ Recibe consejos semanales y guías exclusivas en tu bandeja de entrada
Únete a nuestro boletín →
🎥 Mira tutoriales paso a paso e historias de éxito
Suscríbete a nuestro canal de YouTube →
👩🏽💻 Conecta con nuestra comunidad y obtén información diaria sobre organizaciones sin fines de lucro
Síguenos en LinkedIn →
🥳 Reels divertidos e información sobre organizaciones sin fines de lucro
Síguenos en Instagram →
👀 Vídeos interesantes y divertidos para ayudarte a hacer crecer tu causa
Síguenos en TikTok→
🌎 Suscríbete y sigue para recibir consejos generales de recaudación de fondos
Obtén consejos de recaudación de fondos en TikTok →
Potentes recursos de recaudación de fondos
🤖 Usa Charitable con tu asistente de IA
⬇️ Descarga estrategias probadas, ideas de campañas y herramientas de expertos
Obtén el Kit de Recaudación de Fondos →
💸 Obtén recursos gratuitos de recaudación de fondos
Ve al Centro de Recaudación de Fondos de Charitable →
¿Tienes preguntas sobre Charitable?
Preguntas frecuentes de Charitable →
🏎️ Prueba Charitable
Crea tu demostración de Charitable →
Comprende la terminología y la jerga de las organizaciones sin fines de lucro
Glosario de organizaciones sin fines de lucro→
% ¿Buscas ofertas y descuentos para organizaciones sin fines de lucro?
Las mejores ofertas y descuentos para organizaciones sin fines de lucro →
