¿Quieres que tus donantes de Windcave puedan donar cada mes en lugar de una sola vez?
La función de Donaciones Recurrentes de Charitable funciona con la pasarela Windcave, por lo que un donante configura su donación una vez y cada renovación se factura automáticamente.
Esta guía cubre las credenciales que Windcave emite para la facturación recurrente, dónde introducirlas, cómo activar las donaciones recurrentes para una campaña y cómo probarlas antes de procesar pagos reales.
Donaciones Recurrentes está disponible en los planes Plus y superiores.
¿Qué hay en esta guía?
- Antes de empezar
- Cómo funcionan las donaciones recurrentes de Windcave
- Solicitar tus credenciales REST a Windcave
- Añadir tus credenciales REST en Charitable
- Activar las donaciones recurrentes para una campaña
- Pruebas en el entorno UAT
- Gestión de donaciones recurrentes
- Cuando una Renovación Falla
- Permitir que los donantes cancelen su propia donación
- ¿Aún no tienes un plan de pago?
- Preguntas frecuentes sobre donaciones recurrentes de Windcave
- Más documentación
Antes de empezar
Configura primero la pasarela Windcave. Si aún no lo has hecho, sigue la guía Windcave de Charitable y luego vuelve aquí.
Necesitarás todo lo siguiente.
- Un plan de Charitable Plus o superior, ya que es donde comienzan las Donaciones Recurrentes. La pasarela Windcave por sí sola comienza en Básico, por lo que un plan Básico solo permite donaciones únicas de Windcave.
- El complemento Donaciones Recurrentes, versión 2.2.0 o posterior, instalado y activado desde Charitable » Complementos.
- El complemento Windcave, con tus credenciales PxPay ya guardadas y una donación de prueba funcionando.
- Tu nombre de usuario REST de Windcave y clave API Restful, que Windcave emite por separado de tus credenciales PxPay y PxPost.
Cómo funcionan las donaciones recurrentes de Windcave
La primera donación y cada renovación posterior siguen rutas diferentes a través de Windcave. Saber cuál es cuál hace que las credenciales a continuación tengan sentido.
Cuando un donante elige un importe recurrente y envía tu formulario, Charitable lo redirige a la página de pago alojada de Windcave utilizando tus credenciales PxPay. Allí introducen su tarjeta, en la página de Windcave.
Windcave almacena esa tarjeta y devuelve un token a Charitable. Los números de tarjeta nunca llegan a tu sitio web ni a tu base de datos.
A partir de entonces, Charitable factura cada renovación a través de la API Restful de Windcave utilizando ese token. Tu donante no es redirigido a ningún sitio y no necesita hacer nada. Esta es la parte que necesita las credenciales REST.
Nota: La integración está certificada contra la API Ecom de Windcave, incluyendo 3D Secure y la facturación recurrente con tokens.
Solicitar tus credenciales REST a Windcave
Solicita acceso a la API HPP/Restful a tu gestor de cuentas de Windcave. Te enviarán un nombre de usuario REST y una clave API Restful.
Windcave tiene 2 entornos, y cada uno tiene su propio nombre de usuario y clave.
- En producción se ejecuta contra sec.windcave.com y procesa transacciones reales.
- Pruebas se ejecuta contra uat.windcave.com, para realizar pruebas.
Nota importante: Tu nombre de usuario REST no es lo mismo que tu ID de usuario PxPay, aunque ambos provienen de la misma cuenta de Windcave. Solicita ambos entornos a la vez para no tener que esperar una segunda solicitud cuando salgas en vivo.
Añadir tus credenciales REST en Charitable
Ve a Charitable » Configuración » Pasarelas de Pago, haz clic en “Configuración” junto a Windcave y desplázate hacia abajo hasta la sección “Configuración de la API REST”.
- Entorno REST elige a qué entorno de Windcave se conectan tus donaciones recurrentes. Selecciona “En vivo (Producción)” para procesar transacciones reales, o “Prueba” mientras estás probando.
- Nombre de usuario REST es el nombre de usuario HPP/Restful que Windcave emitió para tu cuenta.
- Clave API Restful es la clave emparejada con ese nombre de usuario. Charitable la utiliza para autenticar cada solicitud de donación recurrente.
Haz clic en “Guardar Cambios” cuando hayas terminado.
Nota: Deja toda esta sección en blanco si no estás aceptando donaciones recurrentes. Tus donaciones únicas de Windcave funcionan sin ella.
Activar las donaciones recurrentes para una campaña
La donación recurrente se configura por campaña, por lo que tú decides qué apelaciones la ofrecen. Abre una campaña en el Constructor de Campañas, ve a Configuración » Donaciones Recurrentes y elige un modo.
- Desactivado no muestra ninguna opción recurrente.
- Simple añade una casilla de verificación para que un donante pueda hacer su donación recurrente.
- Avanzado permite al donante elegir entre una donación única y una recurrente, con un selector de período.
- Solo Recurrente oculta completamente las donaciones únicas. Cada donación a la campaña es una suscripción, lo que es ideal para clubes de donaciones mensuales y fondos operativos.
Luego establece los períodos y montos que deseas ofrecer. El período de donación cubre diario, semanal, mensual, trimestral, dos veces al año y anual. La duración de la donación es el número de pagos a cobrar, donde 0 significa que la donación continúa hasta que el donante la cancele.
Guarda o publica la campaña y tu próximo donante de Windcave podrá iniciar una donación recurrente.
Pruebas en el entorno UAT
Prueba una donación recurrente de principio a fin antes de aceptar dinero real. Dado que Windcave no tiene un interruptor de modo de prueba separado, la prueba es un intercambio de credenciales.
- Introduce tus credenciales UAT PxPay en la configuración de Windcave, para que el primer pago se ejecute también contra el entorno de prueba.
- Establece “Entorno REST” en “Prueba”, introduce tu nombre de usuario REST de prueba y tu clave API Restful, y haz clic en “Guardar Cambios”.
- Ve a una campaña con donaciones recurrentes activadas y haz una donación en tu propio sitio web, eligiendo un monto recurrente y Windcave como método de pago.
- Introduce una tarjeta de prueba en la página de pago alojada por Windcave. Windcave publica números de tarjeta de prueba para UAT, y tu gestor de cuentas puede enviártelos.
- Comprueba que la suscripción aparece en Charitable » Donaciones Recurrentes con el estado Activo y Windcave como método de pago.
- Cuando todo parezca correcto, cambia a tus credenciales PxPay en vivo, establece “Entorno REST” en “En vivo (Producción)”, introduce tu nombre de usuario y clave REST en vivo, y haz clic en “Guardar Cambios”.
Importante: Cancele sus suscripciones de prueba antes de publicar. Una suscripción de prueba que quede activa está apuntando a credenciales que ha reemplazado y ensucia sus informes.
Gestión de donaciones recurrentes
Sus suscripciones de Windcave conviven con las de cualquier otra pasarela bajo Caritativas » Donaciones recurrentes. El método de pago aparece bajo cada importe, para que pueda distinguir una suscripción de Windcave de una de Stripe de un vistazo.
Los enlaces en la parte superior filtran la lista por estado, para que pueda mostrar solo las suscripciones activas o solo las fallidas. "Otras donaciones" cuenta las renovaciones recaudadas hasta el momento y "Exportar" envía la lista a CSV.
Haga clic en una suscripción para abrir la pantalla de Detalles de donación recurrente, que muestra el donante, la campaña, el importe y Windcave como método de pago.
Utilice el cuadro "Acciones de donación" a la derecha para actuar sobre la suscripción, incluido cancelarla en nombre del donante.
Cuando una Renovación Falla
Las tarjetas caducan y Windcave rechaza una renovación cuando esto sucede. Caritativas envía automáticamente al donante el correo electrónico "Pago fallido" y mueve la suscripción al filtro "Fallidas", para que pueda verla sin tener que buscar.
Para editar el texto de ese correo electrónico, vaya a Caritativas » Ajustes » Correos electrónicos » Pago fallido.
Consejo profesional: Asegúrese de que su sitio puede enviar correos electrónicos antes de depender de esto. Un aviso de renovación fallida que aterriza en spam le cuesta el donante con la misma seguridad que ningún aviso.
Permitir que los donantes cancelen su propia donación
Los donantes pueden ver y cancelar su propia suscripción de Windcave desde el Panel del donante, o desde una página que utilice el shortcode [my_recurring_donations].
Aparece un enlace "Cancelar" para cualquier suscripción que se pueda cancelar, es decir, las activas, pendientes o en espera. El donante confirma, el estado se actualiza a "Cancelada" y se le devuelve al panel. Las suscripciones que ya están completadas, caducadas o canceladas muestran un guion en su lugar.
¿Aún no eres usuario de Charitable Pro? Regístrate hoy y obtén hasta un 50% de descuento en tu plan. Estamos seguros de que te encantará recaudar fondos con Charitable. Si, por cualquier motivo, Charitable no es adecuado para ti, te reembolsaremos tu compra con nuestra garantía de devolución de 14 días. Consigue Charitable Pro ahora »
Preguntas frecuentes sobre donaciones recurrentes de Windcave
¿Qué plan necesito?
Plus o superior. La pasarela Windcave está incluida desde Basic, pero la facturación recurrente necesita la función de Donaciones recurrentes, que comienza en Plus.
¿Mis credenciales PxPay existentes cubren las donaciones recurrentes?
No. PxPay gestiona el primer pago en la página alojada. Las renovaciones pasan por la API Restful de Windcave, que necesita un nombre de usuario REST y una clave de API Restful que Windcave emite por separado.
¿Necesito credenciales PxPost para donaciones recurrentes?
No. PxPost es para reembolsar una donación desde dentro de Caritativas. La facturación recurrente no depende de él, aunque la mayoría de los sitios lo añaden de todos modos para que los reembolsos sean posibles.
¿Es mi nombre de usuario REST el mismo que mi ID de usuario PxPay?
No, son valores diferentes de la misma cuenta de Windcave. Introducir su ID de usuario PxPay como nombre de usuario REST es la razón más común por la que las donaciones recurrentes no se autentican.
¿Los datos de la tarjeta tocan mi sitio web?
No. El donante introduce su tarjeta en la página de pago alojada de Windcave, Windcave la almacena y Caritativas solo guarda un token.
¿Qué plazos pueden elegir los donantes?
Los que ofrezca en la campaña, desde diarios, semanales, mensuales, trimestrales, semestrales y anuales. Puede fijar el plazo usted mismo o dejar que el donante elija.
¿Puedo cambiar una campaña puntual existente a recurrente?
Sí. Cambia el modo en el Creador de campañas y guarda. Las donaciones ya recaudadas se quedan como están, y solo los nuevos donativos obtienen la opción recurrente.
¿Los donantes reciben un recibo por cada renovación?
Sí. Cada renovación se registra como su propia donación dentro de la suscripción, por lo que tu recibo de donación habitual se envía para ella.
Más documentación
- Caridad Windcave
- Donaciones Recurrentes Charitable
- Cómo usar Donaciones recurrentes 2.0
- Integración Windcave para Charitable
¡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
Enlaces Útiles
🤝 Obtenga ayuda cuando la necesite
Conecta con Atención al Cliente →
📑 Encuentre la guía que necesita
Explore el Centro de documentación →
⬇️ Descarga estrategias probadas, ideas de campañas y herramientas expertas
Obtén el Kit de Recaudación de Fondos →
🔗 Deja que tu Asistente de IA haga el trabajo de recaudación de fondos por ti.
Conecta Charitable a tu asistente de IA →
💸 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 →
¿Necesita ayuda para entender la terminología y la jerga de las organizaciones sin ánimo de lucro?
Consulte nuestro Glosario de organizaciones sin ánimo de lucro→
