Requiere:
- Charitable Pro 1.8.16+
- Donaciones recurrentes benéficas 2.1.0+
La situación de un donante cambia. Quizás el próximo mes sea ajustado y quieran reducir su donación mensual de 50 € a 25 €, o ha llegado una subvención equivalente y les gustaría aumentar su donación anual. Antes de Charitable Recurring 2.1, la única forma de manejarlo era cancelar la suscripción y pedir al donante que iniciara una nueva, lo que pierde el historial de pagos y corre el riesgo de que la donación nunca regrese.
Ahora puedes actualizar el importe y el periodo de facturación de una donación recurrente activa directamente desde tu administrador de WordPress, y el cambio se sincroniza automáticamente con Stripe. La misma suscripción permanece activa, por lo que se conserva el historial de pagos y el donante mantiene su fecha de inicio original.
Puedes aplicar un cambio inmediatamente o enviar primero al donante un enlace de aprobación seguro. Cada cambio se registra en tu registro de auditoría, y los cambios que realices en el Panel de Stripe se sincronizan automáticamente con Charitable.

Cuándo usarlo
- Un donante solicita cambiar su importe: actualízalo en segundos en lugar de cancelar y volver a suscribirse.
- Un donante quiere cambiar de mensual a anual (o a cualquier otro periodo): cambia el periodo de facturación sin modificar la suscripción.
- Un cambio requiere la aprobación del donante: envía un correo electrónico de aprobación y deja que el donante confirme antes de que ocurra nada en Stripe.
- Alguien editó la suscripción en el Panel de Stripe: Charitable recoge automáticamente el nuevo importe y periodo.
- Necesitas un registro de quién cambió qué: cada actualización se registra en los registros de Charitable con el valor anterior, el nuevo valor y quién lo realizó.
Cómo encontrarlo
Abre la donación recurrente que deseas cambiar:
Administrador de WordPress > Donaciones > Donaciones recurrentes > (haz clic en la donación)

En el cuadro Acciones de donación de la derecha, elige Actualizar suscripción en el menú desplegable y, a continuación, haz clic en el botón Actualizar suscripción.
La donación debe usar la pasarela de Stripe y estar en estado Activa. Las suscripciones pausadas, canceladas, completadas y pendientes no se pueden editar, lo que evita que el donante se sorprenda con un cargo inesperado.
Actualizar una suscripción
La ventana Actualizar suscripción muestra la suscripción actual en la parte superior, seguida de los campos que puedes cambiar.

1. Establece el nuevo importe y/o periodo
- Nuevo importe: introduce cualquier valor desde 1,00 hasta (en teoría) 999999,99. Déjalo sin cambios para mantener el importe actual.
- Nuevo periodo de facturación: elige entre diario, semanal, mensual, trimestral, semestral o anual. Déjalo en el periodo actual para mantenerlo.
Puedes cambiar uno o ambos. El cambio entra en vigor en la próxima fecha de facturación del donante; su ciclo actual finaliza normalmente y no se aplica ningún prorrateo.
2. Elige cómo se aplica el cambio
- Aplicar inmediatamente: el cambio se envía a Stripe de inmediato.
- Solicitar aprobación del donante – se almacena un cambio pendiente y el donante recibe un correo electrónico con enlaces seguros para aprobar y denegar. Nada cambia en Stripe hasta que aprueben.

3. Decidir si notificar al donante
La casilla Notificar al donante de este cambio está activada por defecto. Cuando está marcada, el donante recibe un correo electrónico de “Suscripción Actualizada” con el importe o período antiguo y nuevo. Desmárquela para ajustes de back-office de los que el donante no necesita tener conocimiento.
Cuando haga clic en Actualizar Suscripción, verá un mensaje de éxito y el total de la donación se actualizará en la página.
El flujo de trabajo de aprobación del donante
Cuando elige Solicitar aprobación del donante, el donante recibe un correo electrónico con dos enlaces: uno para aprobar el cambio y otro para denegarlo.

Algunas cosas que vale la pena saber sobre cómo funcionan los enlaces de aprobación:
- Seguros y específicos para la donación. Cada enlace lleva un token firmado vinculado a esa donación exacta. Un enlace para una donación no se puede usar en otra.
- Caducan. Los enlaces de aprobación son válidos durante 7 días. Después de eso, el enlace deja de funcionar y tendría que volver a emitir la solicitud.
- Un solo uso. Una vez que el donante aprueba o deniega, el enlace se agota. Hacer clic en él de nuevo no hace nada.
- Una nueva solicitud reemplaza a una antigua. Si emite un segundo cambio mientras uno todavía está pendiente, la solicitud más reciente reemplaza a la anterior y el enlace antiguo deja de funcionar.
Si el donante hace clic en Aprobar, el cambio se envía a Stripe y la donación se actualiza. Si hace clic en Denegar, la suscripción permanece exactamente como estaba y el cambio pendiente se elimina.
Cambios realizados en el Panel de control de Stripe
Si usted (o un compañero de equipo) edita el importe o el período de facturación de una suscripción directamente en el Panel de control de Stripe, Charitable lo notifica y actualiza la donación local para que coincida. Esto ocurre a través del webhook de Stripe que ya tiene configurado, por lo que no hay nada adicional que configurar. Significa que el registro de la donación en WordPress se mantiene preciso sin importar dónde se realizó la edición.
Leer el registro de auditoría
Cada cambio de suscripción se registra en sus registros de Charitable, ya sea que provenga de una actualización de administrador, una aprobación de donante o el Panel de control de Stripe.
Panel de administración de WordPress » Charitable » Herramientas » Registros
Cada entrada registra el valor antiguo, el valor nuevo, quién realizó el cambio y cuándo. Puede filtrar por ID de donación para ver el historial completo de una sola suscripción.
El correo electrónico de notificación al donante
Por defecto, los donantes reciben un correo electrónico de “Suscripción Actualizada” después de un cambio exitoso, detallando lo que cambió. Puede personalizarlo o deshabilitarlo desde:
Panel de administración de WordPress » Charitable » Ajustes » Correos electrónicos

Dos correos electrónicos se relacionan con esta función:
- Suscripción Actualizada – enviado al donante después de que se aplica un cambio. Activado por defecto.
- Solicitud de Cambio de Suscripción – el correo electrónico de solicitud de aprobación, enviado cuando elige “Solicitar aprobación del donante”.
Haga clic en cualquiera de los correos electrónicos para editar su asunto, encabezado y cuerpo, o para desactivarlo.
Consejos
- Usa Solicitar aprobación del donante para cualquier cambio que un donante no haya solicitado explícitamente, para que siempre tengan la última palabra.
- Se requiere el estado Activo de la donación. Si la opción Actualizar suscripción falta o está desactivada, primero comprueba el estado de la suscripción.
- Los cambios entran en vigor en el próximo ciclo de facturación, no de inmediato, por lo que el donante nunca se factura dos veces en el período actual.
Referencia del desarrollador
La ruta completa de actualización se basa en hooks, por lo que puedes interceptar, extender o reaccionar a los cambios de suscripción.
Filtros
| Filtro | Predeterminado | Propósito |
|---|---|---|
charitable_process_subscription_update_stripe | array( 'success' => false, 'message' => ... ) | Implementado por Charitable Pro 1.8.16+. Recibe la donación recurrente y los cambios propuestos, los envía a Stripe y devuelve un array de resultados. Tanto el endpoint de actualización de administrador como el manejador de aprobación del donante lo llaman. |
charitable_recurring_confirmation_page_colors | colores de marca | Colores para la página de confirmación de aprobación/denegación que ve el donante. |
charitable_recurring_confirmation_page_heading | encabezado por acción | El encabezado que se muestra en la página de confirmación. |
charitable_recurring_confirmation_page_message | mensaje por acción | El mensaje del cuerpo en la página de confirmación. |
charitable_recurring_confirmation_page_button | botón volver-a-inicio | El botón que se muestra en la página de confirmación. |
charitable_recurring_confirmation_page_html | vacío | Devuelve HTML personalizado para reemplazar toda la página de confirmación. |
Acciones
| Acción | Argumentos | Cuando se activa |
|---|---|---|
charitable_recurring_subscription_updated | $donation, $changes, $old_values | Después de una actualización exitosa. Activa el correo electrónico "Suscripción actualizada" para el donante cuando ese correo esté habilitado. |
charitable_recurring_subscription_change_requested | $donation, $pending_data, $raw_token | Cuando un administrador solicita la aprobación del donante. Activa el correo electrónico de solicitud de aprobación. |
charitable_stripe_subscription_details_changed | $subscription, $stripe_object | Disparado por el procesador de webhooks de Pro en un evento customer.subscription.updated de Stripe. El listener de sincronización inversa lee la nueva cantidad y el período del objeto Stripe. |
Funciones y clases auxiliares
charitable_recurring_update_local_subscription( $donation, $changes )– actualiza solo los metadatos locales. Maneja la distribución proporcional de una nueva cantidad para campañas únicas y múltiples.Charitable_Recurring_Subscription_Change_Handler::process_approval()– maneja el clic de aprobación del donante (?donation_id=X&token=Y&action=approve).Charitable_Recurring_Subscription_Change_Handler::process_denial()– maneja la ruta de denegación.Charitable_Recurring_Subscription_Change_Handler::cleanup_expired_pending_changes()– elimina los registros de cambios pendientes caducados (se ejecuta en un evento programado).Charitable_Gateway_Stripe_AM::$period_map– array estático que mapea cada período de Charitable a unintervalyinterval_countde Stripe.Charitable_Gateway_Stripe_AM::update_subscription( $result, $donation, $changes )– el método detrás del filtro; crea un Plan de Stripe para los nuevos argumentos y lo intercambia con la suscripción sin prorrateo.
Mapeo de períodos
La cantidad y el período que establezcas se mapean al modelo de facturación de Stripe de la siguiente manera:
| Período de Charitable | Intervalo de Stripe | interval_count |
|---|---|---|
| día | día | 1 |
| semana | semana | 1 |
| mes | mes | 1 |
| trimestre | mes | 3 |
| semestre | mes | 6 |
| año | año | 1 |
Token de aprobación
El enlace de aprobación utiliza un token HMAC-SHA256 vinculado al ID de la donación, la hora en que se propuso el cambio y un secreto de 32 caracteres de un solo uso. Los tokens caducan después de 7 días. Un contador de intentos repetidos se almacena en el transitorio charitable_sub_token_attempts_{donation_id}, y el registro de cambios pendientes se elimina al aprobar o denegar para que un enlace no se pueda reproducir.
Ejemplos de personalización
Añade una línea de registro personalizada cada vez que se actualiza una suscripción:
add_action( 'charitable_recurring_subscription_updated', function ( $donation, $changes, $old_values ) {
error_log( sprintf(
'Subscription #%d updated: %s',
$donation->ID,
wp_json_encode( $changes )
) );
}, 10, 3 );
Notifica a tu equipo en Slack cuando se solicite la aprobación de un donante:
add_action( 'charitable_recurring_subscription_change_requested', function ( $donation, $pending_data, $raw_token ) {
my_slack_notify( sprintf(
'Approval requested for recurring donation #%d',
$donation->ID
) );
}, 10, 3 );
Personaliza la página de confirmación del donante:
add_filter( 'charitable_recurring_confirmation_page_colors', function ( $colors ) {
$colors['primary'] = '#16a34a';
return $colors;
} );
Relacionado
- Donaciones recurrentes – la descripción general de las donaciones recurrentes en Charitable.
- Pasarela de Stripe – conexión y configuración de Stripe.





