Documentación de Charitable

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

Recursos populares

Empieza aquí

Gestión de donantes

Donaciones recurrentes

Recaudación de fondos entre pares

Integraciones

Extensiones

PayPal Commerce

PayPal Commerce es una integración de PayPal única y moderna que permite a sus donantes pagar con PayPal, Venmo, Pay Later, tarjetas de crédito y débito, Apple Pay y Google Pay a través de una sola conexión. El botón "Conectar con PayPal" de un solo clic se encarga de la configuración, y las donaciones y los reembolsos fluyen a través de la administración de donaciones de Charitable estándar sin necesidad de iniciar sesión en PayPal.

Disponible en Charitable Pro 1.8.15+ y Charitable 1.8.11 (que actualmente no admite donaciones recurrentes / almacenamiento de datos).  Ha sido probado de extremo a extremo en entornos sandbox y en vivo, y continuaremos refinando la experiencia basándonos en los comentarios de los clientes.

Características clave

  • Acepte donaciones a través de PayPal, Venmo, Pay Later, tarjetas de crédito y débito, Apple Pay y Google Pay a través de una única integración.
  • Conecte su cuenta comercial de PayPal con un solo clic. No se necesita desarrollador.
  • Ofrezca donaciones únicas y donaciones recurrentes desde el mismo formulario.
  • Elija entre dos modos recurrentes: suscripciones gestionadas por PayPal o renovaciones gestionadas por Charitable utilizando métodos de pago guardados.
  • Permita que los donantes recurrentes guarden su cuenta o tarjeta de PayPal y la reutilicen en donaciones futuras.
  • Reembolse y cancele donaciones directamente desde el administrador de WordPress.
  • Vea el estado de la capacidad de PayPal en tiempo real (Pagos Recibibles, Correo Electrónico Confirmado, Procesamiento de Tarjetas, Apple Pay, Google Pay, Almacenamiento de Métodos de Pago, Fastlane) en el panel de conexión.
  • Los donantes que encuentran un error del lado de PayPal ven mensajes claros y amigables con una pista de recuperación en lugar de una alerta genérica del navegador.

¿Por qué usar PayPal Commerce?

PayPal Commerce brinda a sus donantes la máxima cantidad de formas de pago sin que su equipo tenga que administrar múltiples pasarelas. Una sola conexión desbloquea PayPal, Venmo, financiación Pay Later, procesamiento completo de tarjetas de crédito y débito a través de los campos de tarjeta compatibles con PCI de PayPal, y las billeteras modernas (Apple Pay, Google Pay) que todos los donantes esperan en un formulario de donación de la era 2026. En comparación con la integración anterior de Legacy PayPal, obtiene opciones de pago más ricas, un proceso de pago más rápido y herramientas administrativas para reembolsos y gestión recurrente sin salir nunca de WordPress.

Verlo en acción

Requisitos

  • Charitable Lite 1.8.11 o Charitable Pro 1.8.15 o posterior
  • Una cuenta comercial de PayPal (puede crear una durante el flujo de conexión)
  • WordPress 6.0+ y PHP 7.4+
  • La extensión PHP gd o imagick si planea usar la generación de PDF de recibos (ya requerida por el núcleo de Charitable)

Empezar

Activación

  1. En tu panel de administración de WordPress, ve a Charitable → Settings → Payment Gateways.
  2. Busca PayPal Commerce en la lista de pasarelas y haz clic en Enable.
  3. Haga clic en Configuración junto a PayPal Commerce, luego haga clic en el botón Conectar con PayPal.
  4. PayPal se abrirá en una nueva ventana. Inicia sesión en tu cuenta de empresa de PayPal (o crea una) y aprueba la conexión.
  5. PayPal lo redirige de regreso a WordPress. El panel de conexión mostrará su ID de comerciante y una lista de verificación de las capacidades otorgadas.

Eso es todo. Puede comenzar a aceptar donaciones a través de PayPal Commerce de inmediato.

Modo de prueba vs Modo en vivo

PayPal Commerce respeta el interruptor del Modo de prueba estándar de Charitable. Con el Modo de prueba activado, las donaciones se enrutan a través del entorno de pruebas de PayPal para que puedas validar el flujo completo del donante sin mover dinero real. Desactiva el Modo de prueba cuando estés listo para aceptar donaciones en vivo.

Los métodos de pago guardados están limitados por comerciante: una tarjeta que guardaste en el entorno de pruebas no aparecerá en el modo en vivo, y viceversa.

Opciones de configuración

Después de conectar, la página de Configuración de PayPal Commerce expone estas opciones. La mayoría de los valores predeterminados son sensatos para una instalación nueva, por lo que normalmente puedes dejarlos como están.

Métodos de pago

ConfiguraciónTipoPredeterminadoDescripción
Habilitar VenmoActivar/desactivarDesactivadoMostrar el botón Donar con Venmo junto a PayPal. Venmo solo está disponible en EE. UU. y requiere la capacidad de Pago posterior en tu cuenta de PayPal.
Habilitar Pago posteriorActivar/desactivarDesactivadoMostrar el botón de Pago posterior de PayPal (Paga en 4, PayPal Credit). PayPal determina la elegibilidad en el momento del pago según la región del donante y el importe de la donación.
Habilitar Campos de Tarjeta (ACDC)Activar/desactivarActivadoRenderizar los campos de tarjeta de crédito y débito de PayPal, que cumplen con PCI, directamente en tu formulario de donación. Si PayPal aún no ha habilitado Campos de Tarjeta en tu cuenta, se recurrirá a un botón independiente de "Tarjeta de débito o crédito".
Habilitar Apple PayActivar/desactivarActivadoMostrar el botón de Apple Pay en Safari. Requiere la capacidad de Apple Pay en tu cuenta de PayPal.
Habilitar Google PayActivar/desactivarActivadoMostrar el botón de Google Pay en Chrome. Requiere la capacidad de Google Pay en tu cuenta de PayPal.
Habilitar FastlaneActivar/desactivarActivadoPermitir que los donantes recurrentes completen la compra con Fastlane (la opción de pago guardado de PayPal para invitados).
Comportamiento de FastlaneSeleccionarSolo invitadosElige cuándo se ofrece Fastlane: solo para invitados, para todos los donantes o nunca.

Métodos de pago guardados (Almacenamiento)

ConfiguraciónTipoPredeterminadoDescripción
Habilitar almacenamiento de métodos de pagoActivar/desactivarActivadoPermitir que los donantes guarden cuentas de PayPal y tarjetas en el formulario de donación para usarlas en futuras donaciones.
Visualización de la opción de almacenamientoSeleccionarOptar por participarElige cómo aparece la opción "Guardar mi método de pago" en el momento del pago: optar por participar (sin marcar por defecto), optar por no participar (marcado por defecto) o guardar siempre.
Expiración del método guardado (Días)Número(vacío)Número de días antes de que los métodos guardados no utilizados expiren automáticamente. Deja vacío para que no expiren.

Donaciones recurrentes

ConfiguraciónTipoPredeterminadoDescripción
Almacenamiento automático para donaciones recurrentesActivar/desactivarActivadoGuarda automáticamente el método de pago del donante cuando elige una donación recurrente. Requerido para que el cron de renovación cobre en ciclos posteriores.
Modo de procesamiento recurrenteRadioAPI de suscripciones de PayPalElige cómo se procesan las donaciones recurrentes. Vault + Cron: tu sitio almacena el token de pago y activa cada renovación. API de suscripciones de PayPal: PayPal gestiona el ciclo de renovación automáticamente (requiere licencia Pro; los sitios Lite vuelven automáticamente a Vault + Cron con una pequeña tarifa de plataforma en cada renovación).

Profundización en el modo recurrente

PayPal Commerce admite dos formas distintas de gestionar las donaciones recurrentes. Ambas funcionan con la misma experiencia para el donante, pero el flujo interno difiere.

Vault + Cron (gestionado por el comerciante)

Cuando un donante elige una donación recurrente, tu sitio guarda su cuenta de PayPal o tarjeta como un token almacenado. En cada ciclo, el cron de Charitable activa un nuevo cargo contra ese token a través de la API de Órdenes de PayPal. Conservas el control total sobre el comportamiento de reintentos, la gestión de impagos y las cancelaciones a través de la administración de donaciones recurrentes de Charitable.

Funciona en Lite y Pro. Los sitios Lite pagan una pequeña tarifa de plataforma (3%) en cada captura de renovación; los sitios Pro no pagan tarifa de plataforma.

API de suscripciones de PayPal (gestionado por PayPal)

Cuando un donante elige una donación recurrente, tu sitio crea un plan de facturación y una suscripción de PayPal. PayPal gestiona el ciclo de renovación automáticamente y notifica a tu sitio cuando se factura cada ciclo. Los donantes también pueden ver y gestionar la suscripción en su propia cuenta de PayPal.

Disponible solo en Pro. Los sitios Lite que seleccionan este modo vuelven automáticamente a Vault + Cron, por lo que los donantes nunca ven un error.

Activación de Pro en donaciones recurrentes existentes

Si activas Pro en un sitio que ya tiene donaciones recurrentes Lite en curso, la tarifa de plataforma se elimina automáticamente en la próxima renovación. No necesitas migrar la suscripción, pedir al donante que vuelva a aprobar, ni realizar ninguna otra acción. El umbral de tarifa se comprueba en cada renovación según el estado de tu licencia actual.

Reembolsos y cancelaciones

Los reembolsos y las cancelaciones se emiten desde la administración estándar de donaciones de Charitable. No necesitas iniciar sesión en PayPal.

Reembolsar una donación

  1. Abre la donación en Charitable → Donaciones.
  2. En Acciones de donación, elige Reembolsado y marca “Reembolsar automáticamente en PayPal Commerce.”.
  3. Haz clic en Actualizar estado.

Si el reembolso tiene éxito, el estado de la donación pasa a Reembolsado y el ID del reembolso se registra en el registro de donaciones. Si el reembolso falla (por ejemplo, PayPal devuelve "saldo insuficiente"), el estado de la donación se revierte a Pagado para que tus registros y PayPal se mantengan sincronizados.

Cancelar una donación recurrente

  1. Abre la donación recurrente en Charitable → Donaciones recurrentes.
  2. En Acciones de donación, elige Cancelar en la pasarela.
  3. Haz clic en Cancelar donación recurrente.

La cancelación se envía a PayPal para que el donante no reciba más facturas, y la publicación de la donación recurrente se establece como Cancelada en WordPress.

Errores de cara al donante

Cuando PayPal no puede procesar una donación (la cuenta de comerciante está restringida, la tarjeta es rechazada, el país no es compatible, etc.), los donantes ven un aviso en línea en lenguaje claro en el formulario de donación con una pista de recuperación. Nunca ven un cuadro de diálogo de alerta genérico del navegador.

Ejemplos:

  • “Las donaciones en línea a través de PayPal no están disponibles temporalmente. Por favor, intente con un método de pago diferente, o contáctenos para completar su donación.”
  • “Su método de pago fue rechazado. Por favor, intente con una tarjeta diferente o use su saldo de PayPal.”
  • “Las donaciones a través de PayPal no son compatibles desde su país. Por favor, intente con un método de pago diferente.”

Si el visitante actual ha iniciado sesión como administrador (capacidad manage_charitable_settings o manage_options), el aviso en línea muestra adicionalmente el texto de error subyacente de PayPal y el ID de depuración de PayPal para que pueda clasificarlo sin revisar los registros.

Registros

Cada error de la API de PayPal se registra en Charitable → Herramientas → Registros bajo la fuente paypal_commerce. Cada entrada incluye:

  • El mensaje amigable que se mostró al donante
  • El texto de error sin procesar de PayPal
  • El código de problema de error de PayPal (por ejemplo, PAYEE_ACCOUNT_RESTRICTED)
  • ID de depuración de PayPal (para tickets de soporte con PayPal)
  • Contexto de la donación: importe, campaña, método de pago

Esta es la forma más rápida de diagnosticar el informe de un cliente de “PayPal no funciona”.

Solución de problemas

Los donantes ven “Las donaciones en línea a través de PayPal no están disponibles temporalmente”.

Este mensaje indica que PayPal ha restringido su cuenta de comerciante. Inicie sesión en paypal.com con su cuenta comercial, aborde cualquier elemento de verificación o cumplimiento pendiente y luego regrese a Charitable → Configuración → Pasarelas de pago → PayPal Commerce y haga clic en Actualizar estado para confirmar que la restricción se ha eliminado.

La pestaña “Pagar con tarjeta” no se renderiza; solo se muestra un botón “Tarjeta de débito o crédito”.

PayPal aún no ha habilitado la capacidad de Procesamiento Avanzado de Tarjetas (ACDC) en su cuenta. El botón de Tarjeta independiente todavía acepta donaciones a través de una ventana emergente de PayPal alojada. Para habilitar los campos de tarjeta en línea, inicie sesión en su cuenta comercial de PayPal, complete los pasos de verificación pendientes y regrese al panel de conexión y haga clic en Actualizar estado.

Después de desconectar y reconectar, la conexión todavía muestra el comerciante antiguo.

Borre la caché de objetos de WordPress (o reinicie su servicio PHP-FPM si hay una caché a nivel de host involucrada). El botón Actualizar estado fuerza una verificación de capacidad nueva desde PayPal.

Las donaciones recurrentes nunca se renuevan.

Comprueba que Auto-vault para Donaciones Recurrentes esté activado y que el cron de WordPress se esté ejecutando en tu servidor. Para el modo Vault + Cron, el cron de renovación se ejecuta diariamente y cobra cada donación recurrente debida. Busca en Charitable → Herramientas → Registros entradas de paypal_commerce para ver si se han intentado o fallado renovaciones.

El botón de reembolso muestra “No se encontró ID de captura” en una donación de suscripción.

Esto puede suceder si intentas un reembolso a los pocos segundos de que el donante apruebe la suscripción, antes de que PayPal haya registrado la primera transacción. Espera unos minutos e inténtalo de nuevo. El plugin recuperará el ID de captura del historial de transacciones de PayPal en el momento del reembolso.

Recursos para desarrolladores

Ganchos y filtros

  • charitable_paypal_log_platform_fee_on_donation (filtro, valor predeterminado false). Devuelve true para añadir una línea “Tarifa de plataforma” al registro de donaciones en cada captura. Útil para sitios que desean visibilidad total de las tarifas de renovación de nivel Lite.
  • charitable_paypal_platform_fee_percentage (filtro, valor predeterminado 3). Ajusta el porcentaje de la tarifa de plataforma aplicado a las donaciones de nivel Lite.
  • charitable_donation_cancellation_page (filtro). Personaliza la página a la que llegan los donantes después de cancelar una aprobación de suscripción de PayPal.
  • charitable_donation_cancellation_args (filtro). Personaliza los argumentos de consulta que se añaden a la URL de cancelación de donaciones.

WP-CLI

El plugin incluye un comando WP-CLI específico para PayPal:

wp charitable paypal force-commerce-tier

Úsalo si Charitable detectó tu sitio como un sitio de PayPal heredado (por ejemplo, si ha importado donaciones de una exportación heredada o una prueba de pasarela heredada abandonada) y deseas optar por PayPal Commerce. Incluye una vista previa --dry-run y un reconocimiento obligatorio --confirm-recurring-impact cuando haya donaciones recurrentes heredadas activas.

Webhooks

Una vez que te conectes, el panel de conexión mostrará la URL de webhook de tu sitio. Suscríbete a estos eventos en tu Panel de Desarrollador de PayPal:

  • CHECKOUT.ORDER.APPROVED
  • PAGO.CAPTURA.COMPLETADO
  • PAGO.CAPTURA.DENEGADO
  • PAGO.CAPTURA.PENDIENTE
  • PAGO.CAPTURA.REEMBOLSADO
  • COMERCIO.ALTA.COMPLETADA
  • COMERCIO.CONSENTIMIENTO-PARTNER.REVOCADO

Para cuentas de sandbox, también puedes hacer clic en Crear Webhook Automáticamente para registrarlos automáticamente.

Recursos adicionales

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

Enviar un ticket de soporte
Contáctanos

Ú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!

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í.

Donaciones Mejora

📊 ¡Tu panel de control Pro ahora puede comparar, exportar y calificar!

La mayoría de los paneles de control de recaudación de fondos solo te dicen cuánto has recaudado. Charitable Pro 1.8.19 reconstruye el panel de control y la Descripción general de informes en torno a las preguntas más difíciles: si algo está roto, si este período superó al anterior y qué cambio único marcaría la mayor diferencia hoy. Por qué esto es importante:

  • 📈 Cada cifra tiene una tendencia: Elige un período y las fichas y el gráfico se mueven juntos, con cada total mostrado frente al período anterior.
  • 🗓️ Gráficos que se mantienen legibles: Los rangos cortos agrupan las donaciones día a día, mientras que los rangos más largos agrupan por semana o mes, por lo que un año completo se lee como una curva en lugar de una línea plana.
  • 🔀 Compara cualquier 2 períodos: No solo los consecutivos, para que puedas preguntar cómo fue este diciembre en comparación con el diciembre pasado. Eso importa porque la recaudación de fondos es estacional.
  • 📤 Exporta el resumen completo: Envía la descripción general completa como CSV o PDF, lista para un paquete de junta directiva o un informe de financiador.
  • 🎯 Califica tu configuración gratis: Haz que tu configuración de recaudación de fondos sea calificada, para que el único cambio que valga la pena hacer a continuación sea el que puedas ver.

Consulta nuestro anuncio aquí.

Función Nuevo

🎟️ Presentamos Eventos Benéficos: ¡Vende entradas dentro de tus campañas!

La mayoría de las organizaciones sin ánimo de lucro venden entradas para eventos en una herramienta y recaudan donaciones en otra, lo que genera dos conjuntos de informes y una conciliación manual al final del año. Eventos Benéficos une ambas cosas, vendiendo entradas a través de los mismos formularios de donación y pasarelas de pago que ya utilizas en Charitable. Por qué esto es importante:

  • 🎟️ Cada entrada es una donación: Las ventas de entradas se procesan a través de la pasarela que ya utilizas y cuentan para el objetivo de la campaña, con todo gestionado en Charitable » Eventos.
  • 📱 Registro con código QR desde cualquier teléfono: Cada asistente recibe su propio código QR en el recibo, y los voluntarios escanean en la puerta a través de un enlace de registro que no necesita cuenta de WordPress.
  • 🧾 Recibos listos para la declaración de impuestos: Asigna a cada tipo de entrada un valor justo de mercado, y Charitable incluirá el importe correcto deducible de impuestos en cada recibo de donante.
  • 📋 Detalles del asistente al finalizar la compra: Pregunta a cada invitado por su elección de comida, talla de camiseta o necesidades de acceso, con un registro de asistente independiente creado para cada entrada.
  • 🗓️ Bloques y calendarios incluidos: Tres bloques de editor, además de la compatibilidad con Sugar Calendar y The Events Calendar, muestran tus eventos donde los colaboradores ya los buscan.

Consulta nuestro anuncio aquí.

ia Nuevo

🚀 ¡Libera el poder de la IA en Charitable!

Tu asistente de IA ahora puede crear, editar y administrar tus campañas de recaudación de fondos de Charitable directamente, solo con pedírselo. Con Charitable Pro añadiendo soporte de escritura para la API de Habilidades de WordPress, herramientas como ChatGPT, Claude y Cursor pueden manejar acciones administrativas completas de forma segura a través de MCP. Por qué esto es importante:

  • 🤖 Creación de campañas en lenguaje natural: Pídele a tu asistente un objetivo como “Configura una recaudación de fondos para el refugio con un objetivo de 5.000 $”, y creará un borrador de campaña real completo con niveles de donación sugeridos.
  • 🎨 Ajustes instantáneos del formulario de donación: Añade campos personalizados, cambia los colores de los botones o reordena elementos sin tener que entrar en la configuración del formulario.
  • 📝 Registro de donaciones sin conexión: Informa a tu asistente sobre donaciones en efectivo o cheque, y cruzará los correos electrónicos de los donantes y registrará las transacciones en tu historial.
  • 🛡️ Seguridad y control por defecto: El acceso de escritura permanece estrictamente desactivado hasta que se active en Charitable » Herramientas » AI MCP, manteniendo el informe de solo lectura seguro por defecto.
  • 📜 Registro de auditoría completo: Cada cambio realizado por un asistente de IA se rastrea en Charitable » Herramientas » Registros, por lo que siempre sabrás quién (o qué) actualizó tu sitio.

Consulta nuestro anuncio aquí.

Ver todos los anuncios