Si recibe un correo electrónico con el asunto “[Su sitio] Donaciones de PayPal atascadas en Pendiente”, Charitable Pro le está alertando de que una o más donaciones de PayPal han estado esperando la confirmación del pago durante más tiempo del esperado. Este artículo explica qué significa el correo electrónico, qué comprobar y cómo resolverlo.
Disponible en Charitable Pro 1.8.13+.
Qué significa el correo electrónico
El correo electrónico se ve así:
Subject: [Your Site Name] PayPal Donation(s) Stuck in Pending
The following PayPal donation(s) have been Pending for more than 24 hours
with no payment confirmation received:
#123456
Please check your PayPal account and update the donation status manually
if payment was received.
View donations: https://yoursite.com/wp-admin/edit.php?post_type=donation&post_status=charitable-pendingCharitable Pro supervisa sus donaciones de PayPal a diario. Cuando una donación ha estado en estado Pendiente durante más de 24 horas sin recibir una confirmación de pago de PayPal (llamada IPN, o Notificación Instantánea de Pago), marca esa donación y envía esta alerta a la dirección de correo electrónico del administrador de su sitio.
Esto no significa que la donación haya fallado. Significa que Charitable Pro aún no ha recibido la confirmación de PayPal de que el pago se ha completado. Es posible que el donante haya pagado o no; deberá comprobar su cuenta de PayPal para averiguarlo.
Cada donación solo se marca una vez, por lo que no recibirá correos electrónicos repetidos sobre la misma donación.
Por qué sucede esto
Cuando un donante completa un pago de PayPal, PayPal envía una notificación a su sitio en segundo plano. Charitable Pro recibe esta notificación y la utiliza para actualizar automáticamente el estado de la donación de Pendiente a Pagado.
Si esa notificación nunca llega, la donación permanece en Pendiente indefinidamente. Las razones más comunes por las que esto sucede:
La IPN de PayPal no está configurada correctamente. La IPN (Notificación Instantánea de Pago) debe estar habilitada en su cuenta de PayPal y apuntar a su sitio. Si está deshabilitada o mal configurada, Charitable Pro nunca recibirá confirmación para ninguna donación de PayPal.
Un plugin de seguridad o un cortafuegos está bloqueando la solicitud IPN. Algunas herramientas de seguridad a nivel de servidor bloquean las solicitudes POST entrantes de servicios externos, incluidas las devoluciones de llamada IPN de PayPal.
El donante no completó su pago. Los donantes que inician un pago de PayPal y lo abandonan antes de pagar crearán una donación Pendiente sin IPN que seguir.
El pago está realmente pendiente en PayPal. Ciertos tipos de pago, como los eChecks o los pagos marcados para revisión manual por PayPal, permanecen en estado pendiente en PayPal durante varios días antes de liquidarse.
Paso 1: Compruebe PayPal primero
Antes de realizar cualquier acción en WordPress, inicie sesión en su cuenta de PayPal y busque la donación.
- Vaya a su cuenta de PayPal y busque transacciones alrededor de la fecha y el importe de la donación marcada.
- Compruebe si el pago se recibió, está pendiente en PayPal o no existe.
Si el pago se recibió en PayPal: La notificación IPN se perdió en tránsito. Consulte el Paso 3: Actualizar la donación manualmente a continuación, y luego aborde la configuración de su IPN para que las donaciones futuras se confirmen automáticamente.
Si el pago está pendiente en PayPal (eCheck, revisión, etc.): Todavía no se necesita ninguna acción. El estado de la donación se actualizará automáticamente una vez que PayPal libere el pago y envíe la IPN. Es posible que reciba otra alerta si permanece pendiente durante otro ciclo de 24 horas, pero tenga en cuenta que cada donación única solo se envía por correo electrónico una vez, por lo que es más probable que se trate de una donación nueva.
Si no existe ningún pago en PayPal: Es probable que el donante haya abandonado el proceso de pago. Puede marcar la donación como Cancelada o dejarla como Pendiente. No se ha cobrado ningún pago.
Paso 2: Compruebe la configuración de su IPN
Si descubrió que el pago se recibió en PayPal pero no se reflejó en Charitable Pro, la configuración de su IPN necesita atención. Esto también vale la pena comprobarlo de forma proactiva si recibe esta alerta con regularidad.
Para ver los pasos completos de configuración y verificación de IPN, consulte nuestra guía de solución de problemas de PayPal IPN.
Las cosas clave a verificar:
- La IPN está habilitada en la configuración de su cuenta de PayPal
- La URL de notificación de IPN está configurada como:
https://yoursite.com/?charitable-listener=paypal - Ningún plugin de seguridad (Wordfence, Sucuri, etc.) está bloqueando las solicitudes POST de los rangos de IP de PayPal
- Su sitio es accesible públicamente (no está detrás de un modo de mantenimiento o protección con contraseña)
Paso 3: Actualice la donación manualmente
Si confirmó que el pago se recibió en PayPal, actualice el estado de la donación en WordPress manualmente.
- Haga clic en el enlace Ver donaciones en el correo electrónico, o vaya a Donaciones en su administrador de WordPress y filtre por estado Pendiente.
- Encuentre la donación listada en el correo electrónico (identificada por el número
#). - Abra la donación.
- Cambie el estado a Pagado (o el estado apropiado) y guarde.
Esto no activará otro pago; simplemente actualizará el registro para reflejar el pago que ya confirmó en PayPal.
Si sigue recibiendo estos correos electrónicos
Recibir esta alerta ocasionalmente para una sola donación no es inusual. Pero si la recibe regularmente para varias donaciones, es una señal de que las IPN de PayPal no están llegando a su sitio de manera consistente.
Causas y soluciones comunes:
La IPN está deshabilitada en PayPal. Inicie sesión en PayPal, vaya a Configuración de la cuenta, busque Notificaciones de pago instantáneo y habilítela. Establezca la URL de notificación en https://yoursite.com/?charitable-listener=paypal.
Un plugin de seguridad está bloqueando las solicitudes de PayPal. Compruebe los registros de su firewall o plugin de seguridad en busca de solicitudes bloqueadas de las direcciones IP de PayPal. Ponga en lista blanca los servidores de entrega de IPN de PayPal si es necesario.
Su URL de IPN ha cambiado. Si migró su sitio recientemente, cambió su dominio o pasó de HTTP a HTTPS, es posible que la URL de IPN en PayPal apunte a la dirección antigua.
Para un recorrido completo de diagnóstico y solución de problemas de entrega de IPN, consulte la guía de solución de problemas de PayPal IPN.
Ajuste del umbral de notificación
Por defecto, Charitable Pro marca las donaciones que han estado Pendientes durante más de 24 horas. Puedes cambiar este umbral usando el filtro charitable_stale_pending_hours.
Añade esto al archivo functions.php de tu tema o a un plugin específico del sitio:
// Flag donations pending for more than 48 hours instead of 24.
add_filter( 'charitable_stale_pending_hours', function( $hours ) {
return 48;
} );Puedes establecer esto a cualquier número de horas. Establecerlo a un valor más alto le da a PayPal más tiempo para entregar la IPN antes de que se te notifique, lo que puede ser útil si aceptas eChecks o ves retrasos ocasionales en la IPN.
Preguntas frecuentes
¿Recibiré un segundo correo electrónico sobre la misma donación?
No. Cada donación se marca solo una vez. Una vez que Charitable Pro envía la alerta para una donación específica, no enviará otra alerta para esa misma donación, incluso si permanece en estado Pendiente.
¿Quién recibe el correo electrónico?
El correo electrónico se envía a la dirección de correo electrónico del administrador configurada en WordPress en Ajustes > Generales > Dirección de correo electrónico de administración.
¿Puedo deshabilitar estos correos electrónicos?
No hay un interruptor de encendido/apagado en la interfaz de usuario de configuración. Para deshabilitar los correos electrónicos, puedes eliminar el gancho que los envía:
add_action( 'init', function() {
$cron = Charitable_Cron::get_instance();
remove_action( 'charitable_daily_scheduled_events', array( $cron, 'check_stale_pending_donations' ) );
} );Recomendamos resolver el problema subyacente de la IPN en lugar de deshabilitar las alertas, ya que las alertas existen para evitar que las donaciones perdidas pasen desapercibidas.
El ID de la donación en el correo electrónico no coincide con lo que veo en PayPal. ¿Cómo encuentro la transacción correcta?
El número en el correo electrónico (por ejemplo, #123456) es el ID de la donación de WordPress, no un ID de transacción de PayPal. Para encontrar la transacción de PayPal correspondiente, abre la donación en tu administrador de WordPress y busca la referencia de transacción o factura de PayPal almacenada en los detalles de la donación. Luego puedes buscar esa referencia en la actividad de tu cuenta de PayPal.
Contactar con Soporte
Si has seguido todas las instrucciones anteriores y sigues teniendo problemas, contacta con soporte.
