Documentación de Charitable

Aprende a sacar el máximo partido a Charitable con instrucciones claras y paso a paso.

Charitable ha notado que algunos intentos recientes de donación a través del formulario de donación han fallado debido a comprobaciones de seguridad no válidas

Si ve un aviso en el panel de control que dice "Charitable ha notado que algunos intentos recientes de donación a través del formulario de donación han fallado debido a comprobaciones de seguridad no válidas", esta guía explica qué significa y cómo resolverlo.

Lo importante que debe saber primero es que este único aviso puede apuntar a dos situaciones muy diferentes. Una de ellas puede bloquear a donantes reales y necesita su atención. La otra es que Charitable está bloqueando correctamente el spam automatizado y generalmente es inofensivo. Antes de cambiar cualquier configuración, identifique con cuál está tratando.

Qué significa este aviso

Cada vez que se carga su formulario de donación, Charitable agrega comprobaciones de seguridad ocultas para asegurarse de que el envío sea genuino. Dos de esas comprobaciones son:

  • Un token de seguridad (nonce): un código único y limitado en el tiempo que demuestra que el formulario se cargó normalmente y se envió desde su sitio.
  • Una honeypot: un campo oculto que los visitantes reales nunca ven ni completan. Los bots automatizados completan rutinariamente todos los campos que encuentran, por lo que una honeypot completada es una señal confiable de spam.

Cuando alguna de las comprobaciones falla, Charitable bloquea ese envío y lo registra. Si ocurren suficientes envíos bloqueados en una ventana corta, aparece el aviso del panel de control. Debido a que el aviso utiliza la misma redacción para ambas comprobaciones, la única forma de saber qué está sucediendo realmente es observar qué comprobación falló.

Primero, identifique la causa

Charitable registra cada envío bloqueado para que pueda ver el motivo exacto. Para ver el registro:

  1. En su administrador de WordPress, vaya a Charitable > Herramientas > Información del sistema.
  2. Busque la sección Errores del formulario, que muestra el número de errores de hoy y de esta semana. También puede exportar el registro completo a un archivo CSV.
  3. Observe el código de error en cada entrada.

El código de error le indica qué camino seguir:

  • nonce_failed: el token de seguridad no coincidió. Esto es casi siempre un problema de caché y puede disuadir a donantes reales. Siga la Causa 1.
  • honeypot_failed: se completó el campo oculto anti-spam. Esto significa que se bloqueó un bot automatizado, no un donante real. Siga la Causa 2.

Dos pistas contextuales en cada entrada del registro ayudan a confirmar el caso de la honeypot: el envío suele provenir de un visitante desconectado, y el agente de usuario suele ser un navegador obsoleto o automatizado en lugar de uno normal y actual.

Causa 1: Caché y tokens de seguridad (nonce_failed)

Si tu registro muestra entradas de nonce_failed, la causa es casi siempre la caché. Cuando una página que contiene un formulario de donación se almacena en caché, a los visitantes se les puede servir una copia antigua de la página con un token de seguridad caducado. El formulario falla entonces la verificación y el donante ve: “Desafortunadamente, no pudimos verificar el envío de tu formulario. Por favor, recarga la página e inténtalo de nuevo.”

Otras causas menos comunes son un plugin o tema en conflicto, o una caché de navegador agresiva.

Sigue estos pasos:

  1. Comprueba los plugins de caché. Revisa si la caché está activa, ya sea a través de un plugin o de tu proveedor de hosting o CDN (como Cloudflare).
  2. Excluye tus páginas de donación de la caché. En tu plugin de caché o en la configuración de tu hosting, añade las URLs de cualquier página que contenga un formulario de donación (como tus páginas de campaña y donación) a la lista de exclusión o omisión de caché. Excluye también la caché a nivel de servidor y CDN, no solo la del plugin.
  3. Prueba conflictos de plugins. Si se ha descartado la caché, desactiva temporalmente otros plugins (después de hacer una copia de seguridad) para comprobar si otro script está interfiriendo con el formulario.
  4. Limpia la caché de tu navegador. Esto es independiente de la caché del lado del servidor y vale la pena descartarlo.

Como último recurso, si tu hosting no puede omitir la caché en páginas específicas, un fragmento de WPCode puede relajar la verificación de seguridad del formulario. Esto no se recomienda y solo debe usarse si los pasos anteriores no son posibles: https://library.wpcode.com/snippet/7oq3yl5w/

Causa 2: Bots de spam capturados por la honeypot (honeypot_failed)

Si tu registro muestra entradas de honeypot_failed, la noticia es buena. Estos son bots de spam automatizados que sondearon tu formulario de donación y fueron atrapados por el campo oculto honeypot. Charitable los bloqueó antes de que llegaran a tu pasarela de pago. Tus donaciones reales no se ven afectadas y ningún donante real está siendo rechazado.

Un pequeño y constante goteo de bots bloqueados es normal para cualquier formulario de donación público, y es suficiente para activar el aviso del panel de control. En este caso, el aviso simplemente te informa que la protección está funcionando.

No tienes que hacer nada. Si deseas reducir los intentos de bots y la frecuencia con la que aparece el aviso, añade otra capa de protección delante del formulario:

  1. Habilita un CAPTCHA. Ve a Charitable > Ajustes > Seguridad y activa una de las opciones de CAPTCHA, como Google reCAPTCHA o Cloudflare Turnstile. Un CAPTCHA detiene a la mayoría de los bots antes de que puedan enviar, lo que reduce estos intentos bloqueados.
  2. Activa protección adicional contra bots. En la misma configuración de Seguridad, puedes habilitar medidas adicionales como el honeypot y la protección contra bots con límite de tiempo, limitación de velocidad y validación de correo electrónico para una cobertura más sólida.

Descartar el aviso

El aviso puede permanecer durante varios días incluso después de que se haya abordado la causa subyacente. Se borra por sí solo una vez que no hay nuevos fallos, y puedes descartarlo manualmente en cualquier momento desde el panel de control.

¿Todavía necesita ayuda?

Si has identificado el código de error y has seguido los pasos correspondientes anteriores y las donaciones siguen fallando, ponte en contacto con el soporte de Charitable. Nos ayuda si incluyes el código de error de tu registro de errores del formulario (nonce_failed o honeypot_failed), ya que eso nos indica inmediatamente con qué causa estamos tratando.

¿Todavía tienes preguntas? ¡Estamos aquí para ayudarte!

Última modificación:

Novedades en Benéfico

Ver las últimas actualizaciones
🔔 Suscríbete para recibir nuestras últimas actualizaciones
📧 Suscribirse a correos electrónicos

Suscripción por correo electrónico

Únete a nuestro boletín

No te enviaremos spam. Solo enviamos un correo electrónico cuando creemos que realmente te ayudará. ¡Date de baja en cualquier momento!

Donaciones Nuevo

👥 Presentamos la fusión de donantes: ¡Dos registros, un colaborador!

En algún lugar de su lista de donantes hay un colaborador que aparece dos veces, porque un año donó desde una dirección de trabajo y al siguiente desde una personal. Cada donación se registra y cada recibo se envía, pero un colaborador leal que ha donado durante años puede parecer dos personas que donaron la mitad. A partir del plugin Charitable Pro 1.8.19.1, puede encontrar esos registros y fusionarlos desde la pantalla de Donantes. Por qué esto es importante:

  • 🔍 Un enlace para encontrar duplicados donde ya trabaja: Vaya a Charitable » Donantes y se encontrará junto a Filtrar y Exportar, luego le dirá cuántos grupos de posibles duplicados ha encontrado.
  • 🧩 Agrupados por nombre, no por correo electrónico: Charitable compara el nombre y el apellido juntos e ignora las mayúsculas, los espacios y la puntuación, que es lo que detecta a la misma persona bajo dos direcciones diferentes.
  • 📊 Una vista previa antes de que algo cambie: Cada grupo muestra cada registro con su dirección de correo electrónico, el número de donaciones y el total acumulado, y la vista previa le muestra los totales combinados y el correo electrónico que se agregará.
  • ↩️ Cada fusión se puede deshacer: Nada se fusiona hasta que usted decida fusionarlo, y puede revertir cualquier fusión después, por lo que una suposición incorrecta no le cuesta nada.
  • 📥 Creado para la semana posterior a una importación: La migración de donantes desde otro plugin es de donde provienen la mayoría de los duplicados, y también es cuando son más difíciles de detectar, porque cada registro es nuevo para usted.

Consulta nuestro anuncio aquí.

embajadores Nuevo

🔑 Presentamos Recaudadores sin Contraseña: ¡Regístrate solo con tu correo electrónico!

Los seguidores llegan queriendo ayudar, y luego el formulario les pide que inventen una contraseña para un sitio web que quizás solo visiten dos veces. Muchos de ellos se detienen ahí mismo. Las cuentas de recaudación de fondos sin contraseña, nuevas en Charitable Ambassadors 3.5.0, permiten a un seguidor iniciar una recaudación de fondos de persona a persona con solo una dirección de correo electrónico. Por qué esto es importante:

  • 🔑 Sin paso de contraseña para perderlos: Actívalo en Charitable » Ambassadors » Templates » Submit Form y el formulario de creación de recaudación de fondos solo pide un nombre, una dirección de correo electrónico y un título de página.
  • 👤 Sigue siendo una cuenta real de WordPress: Un clic en un correo electrónico confirma la dirección, los inicia y crea la cuenta, para que puedan volver más tarde a editar su historia, cambiar su foto y ver quién ha donado.
  • 🎚️ Tu decisión en cada campaña: Cada campaña de persona a persona puede seguir la configuración predeterminada del sitio o anularla, lo que importa cuando una campaña paga a los recaudadores de fondos a través de Stripe Connect y esas personas necesitan una contraseña.
  • 📋 Ver quién no ha hecho clic todavía: La pestaña Charitable » Ambassadors » Directory » Awaiting Sign-In enumera a todos los que aún esperan, con la campaña a la que se unieron y un botón de Reenviar, para que un error tipográfico o una carpeta de spam sea algo que puedas detectar y corregir.
  • 🛡️ Enlaces que un escáner no puede agotar: Abrir el enlace solo muestra una página, y tu recaudador de fondos inicia sesión cuando presiona el botón en él, por lo que los escáneres de correo electrónico corporativos nunca queman el enlace. Cada uno funciona una vez, expira por sí solo y se almacena solo como un hash.

Consulta nuestro anuncio aquí.

embajadores Nuevo

🏃 ¡Presentamos Actividad: Muestra el progreso en más que solo dinero!

La mayoría de las recaudaciones de fondos entre pares se centran en más que el dinero. Una maratón de lectura se basa en los minutos leídos, una caminata en las millas recorridas y una colecta de alimentos en las comidas preparadas. La Actividad para Embajadores Benéficos permite que tus recaudadores de fondos muestren ese esfuerzo junto a los dólares que recaudan. Por qué esto es importante:

  • 🎯 Progreso en lo que realmente cuentas: Una barra de progreso muestra cada cosa que cuentas contra su propio objetivo, justo al lado del dinero recaudado.
  • 🏅 Hitos para las cosas de sí o no: Una insignia de hito marca los esfuerzos que simplemente están hechos o no hechos, sin un número que perseguir.
  • ✍️ Los recaudadores registran sus propios números: Tus donantes introducen sus totales desde sus propias páginas, para que el esfuerzo deje de vivir en una hoja de cálculo, un comentario o en ningún sitio.
  • 🤖 Algunos números se cuentan solos: Una etiqueta AUTOMÁTICA aparece donde el sitio ha calculado la cifra a partir de donaciones completadas, para que puedas ver de un vistazo lo que nadie ha escrito.
  • 🧩 Configúralo una vez, úsalo en cualquier lugar: Tú decides qué se cuenta una vez, luego eliges qué campañas lo cuentan. Disponible ahora en Embajadores Benéficos 3.4.7, sin complementos nuevos y sin desarrollador.

Consulta nuestro anuncio aquí.

embajadores Nuevo

🖨️ Presentamos Folletos y Carteles: ¡Recauda fondos fuera de la pantalla!

Gran parte de la recaudación de fondos entre particulares ocurre fuera de la pantalla: en la meta de una carrera de 5 km, en un tablón de anuncios escolar, en la cocina de una oficina. Charitable Ambassadors 3.4.7 añade 2 imprimibles: un folleto de recaudación de fondos que lleva la propia historia y código QR de cada recaudador, y un cartel de reclutamiento que inscribe a nuevos recaudadores. Ambos se abren como una página web normal y se imprimen directamente desde el navegador. Por qué esto es importante:

  • 🏁 Un folleto para cada recaudador: Cada uno lleva la foto, la historia y el objetivo del recaudador, con un código QR que abre su página en lugar de la de tu campaña principal.
  • 📌 Un cartel que recluta: Muestra "Reclutando ahora" encima del nombre de tu campaña con un gran código QR que abre tu formulario de inscripción, para que alguien pueda empezar a recaudar fondos sin esperar un enlace tuyo.
  • 🪄 No se necesita herramienta de diseño: Ambos imprimibles se muestran como una página web normal y se imprimen desde el navegador, sin necesidad de plugin PDF ni diseñador.
  • 📄 2 diseños de folleto: "Repartir" lleva la historia completa para dar a amigos y familiares, y "Colgar" lleva un breve gancho con 5 pestañas para arrancar para un tablón de anuncios.
  • 🛡️ Desactivado hasta que lo actives: Los folletos permanecen desactivados después de la actualización hasta que los habilites en Charitable » Ambassadors » Other » Fliers, y solo el propietario o un administrador puede abrir uno.

Consulta nuestro anuncio aquí.

Mejora Pagos

💸 Presentamos las tarifas escalonadas para el alivio de comisiones: ¡Ajusta la petición a la donación!

El alivio de comisiones hace una pregunta corta a tus donantes al finalizar la compra: ¿te gustaría cubrir la comisión de procesamiento de esta donación? Hasta ahora, esa pregunta utilizaba una única tarifa para cada donación en una pasarela, por lo que una donación de 10 $ y una de 500 $ recibían la misma pregunta de porcentaje. El alivio de comisiones 1.3.0 te permite establecer tantas bandas de donación como desees, cada una con su propia tarifa. Por qué esto es importante:

  • 🪙 Más suave con las donaciones pequeñas: Una comisión de transacción fija supone una parte mucho mayor de una donación de 10 $ que de una de 500 $, por lo que las bandas te permiten pedir menos en la parte inferior.
  • 🎚️ Tantas bandas como necesites: Cada banda tiene su propio porcentaje y su propio importe fijo, y la banda superior continúa sin límite superior.
  • 🛑 Un techo opcional: Un campo de comisión máxima evita que se pida a ningún donante más de una cantidad que tú elijas, por muy grande que sea la donación.
  • 🔌 Configurar por pasarela de pago: Stripe puede funcionar con cuatro bandas, mientras que Windcave y Payfast se mantienen con una tarifa única, ya que las bandas pertenecen a una pasarela y no a todo tu sitio.
  • 🛡️ Nada cambia hasta que tú lo digas: Tus tarifas actuales se mantienen exactamente como están hasta que actives Usar tarifas escalonadas en Charitable » Settings » Advanced » Fee Relief.

Consulta nuestro anuncio aquí.