Documentación de Charitable

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

Referencia de campos de Charitable Zapier

¿Quieres saber exactamente qué datos llegan a tu Zap cuando se activa un disparador de Charitable? Cada disparador envía un paquete estructurado de campos de donación, donante, suscripción recurrente o campaña, y esta referencia enumera cada campo por tipo de disparador para que puedas mapearlos con confianza al siguiente paso.

Esta guía te guiará a través de los campos disponibles en cada disparador de Zapier de Charitable.

Nota: La integración de Zapier de Charitable requiere Charitable Pro 1.8.14+ y el complemento Automation Connect 2.1.0+ (plan Pro o superior).

Antes de empezar, asegúrate de haber conectado Charitable a Zapier.

Campos del disparador de donación

Estos campos son enviados por Nueva donación, Donación completada, Donación reembolsada, y Donante por primera vez. La forma exacta del paquete es la misma para los cuatro, por lo que un Zap creado para uno es fácil de adaptar a los otros.

CampoDescripciónEjemplo
donation_idEl ID de publicación interno de WordPress para la donación.123
eventoEl slug del evento del disparador.donacion_completada
títuloPrefijo del título del donante, cuando se recopila en el formulario.Sra.
nombreNombre del donante.Wanda
apellidoApellido del donante.Maximoff
correo electrónicoDirección de correo electrónico del donante.[email protected]
direccionLínea de dirección postal.Unidad 2b
ciudadCiudad.Novi Grad
provinciaEstado o región.Estado de Novi Grad
codigo_postalCódigo postal.12345
paisCódigo de país o nombre completo, según la configuración del formulario.Sokovia
telefonoNúmero de teléfono del donante, cuando se recopila.987654321
subtotalEl importe base de la donación, antes de comisiones.25
totalEl importe final de la donación que se cobra al donante, incluidas las comisiones que haya cubierto.26.50
fechaMarca de tiempo de la donación en formato ISO 8601.2026-05-08T14:20:27+00:00
estadoEstado interno de Charitable con el prefijo charitable-. Consulte la referencia de estados a continuación.charitable-completed
pasarela_donacionSlug de la pasarela de pago utilizada.stripe, paypal, manual
id_transaccion_pasarelaLa referencia de la transacción de la pasarela, útil para la conciliación.ch_abc123def
modo_prueba1 si la donación se realizó en el modo de prueba de la pasarela, de lo contrario 0.0
id_campañaLa campaña a la que se realizó la donación. Cuando una donación se divide entre varias campañas, esta es una lista de IDs separada por comas.8
consentimiento_contacto1 si el donante aceptó ser contactado, de lo contrario 0.1
cubrir_comisiones1 si el donante optó por cubrir la comisión de procesamiento.1
importe_comisionLa parte del total que cubre las comisiones de la pasarela.1.50
consentimiento para rastrear1 si el donante optó por los píxeles de seguimiento y análisis.0
Boletín de noticias1 si el donante se suscribió al boletín informativo.1
Gift Aid1 si el donante reclamó la bonificación fiscal (donantes del Reino Unido).0
donación anónima1 si el donante optó por mostrarse como anónimo públicamente.1
comentario del donanteMensaje de texto libre dejado por el donante con la donación.En memoria de María

Valores de estado de la donación

El campo status utiliza los slugs internos de Charitable, todos prefijados con charitable-. Las reglas de filtrado y la lógica condicional deben coincidir con estos valores exactos.

  • charitable-completed – pago recibido y confirmado por la pasarela. Úselo cuando solo quiera actuar sobre donaciones reales.
  • charitable-pending – fila de donación creada pero pago aún no confirmado. Común para pasarelas fuera de línea y transferencias bancarias.
  • charitable-failed – la pasarela informó de un error. No se cobró al donante.
  • charitable-cancelled – el donante o el administrador abandonaron la transacción.
  • charitable-refunded – la donación fue reembolsada después de completarse.

Campos del disparador de suscripción recurrente

Estos campos son enviados por Nueva Suscripción Recurrente, Donación Recurrente Renovada, Suscripción Recurrente Cancelada, y Pago Recurrente Fallido. La carga útil describe el plan recurrente en sí, no un cargo único.

CampoDescripciónEjemplo
ID de donación recurrenteEl ID de la publicación del plan recurrente.122
eventoEl slug del evento del disparador.subscription_renewed
ID de la primera donaciónEl ID de la donación del primer cargo que inició este plan.123
Subtotal recurrenteEl importe base recurrente antes de las comisiones.50
Total recurrenteEl importe recurrente cobrado, incluidas las comisiones.53
periodo_recurrenteLa unidad de recurrencia.día, semana, mes, año
Intervalo recurrenteCuántas unidades de recurring_period entre cobros. 1 = cada mes, 3 = cada tres meses, etc.1
Duración recurrenteNúmero total de cobros. 0 significa que no hay fin fijo.6
Fecha de expiración recurrenteFecha de finalización del plan, ISO 8601. Vacío si es de duración indefinida.2026-09-08T00:00:00+00:00
Fecha de renovación recurrenteFecha del próximo cobro programado, ISO 8601.2026-06-01T00:00:00+00:00
ID de suscripción de la pasarelaReferencia de suscripción de la pasarela. Útil para conciliar directamente con Stripe o PayPal.sub_xyz987
nombreNombre del donante.Wanda
apellidoApellido del donante.Maximoff
correo electrónicoDirección de correo electrónico del donante.[email protected]
dirección, dirección_2, ciudad, provincia, código_postal, país, teléfonoDirección y teléfono del donante, cuando se recopilan en el formulario.
subtotalEl importe base del cargo individual más reciente.25
totalEl importe final del cargo individual más reciente.26.50
fechaCuándo se creó el plan, ISO 8601.2026-05-08T14:20:27+00:00
estadoEl estado actual del plan. Ver abajo.charitable-active
pasarela_donacionSlug de la pasarela.stripe
modo_prueba1 si se creó en modo de prueba.0
id_campañaLa campaña que apoya el plan. Separado por comas cuando se divide.8
consentimiento_contacto, cubrir_comisiones, importe_comision, consentimiento_seguimiento, optin_boletin, giftaid_reclamado, donacion_anonima, comentario_donanteMismos significados que en el payload de donación anterior.
ID de cliente de GoCardlessReferencia del cliente de GoCardless, cuando corresponda.goc123123
ID de mandato de GoCardlessReferencia del mandato de GoCardless, cuando sea aplicable.goc987987

Valores del estado de la suscripción recurrente

  • charitable-active – el plan está activo y se renueva según lo programado.
  • charitable-cancelled – el donante o el administrador canceló el plan.
  • charitable-expired – el plan alcanzó su fecha de finalización.
  • charitable-failed – un intento de renovación falló y el plan está suspendido.

Campos del disparador de campaña

Estos campos son enviados por Campaign Goal Reached y Campaign Ended. La carga útil describe la campaña en sí.

CampoDescripciónEjemplo
id_campañaEl ID de la publicación de la campaña.123
eventoEl slug del evento del disparador.campaign_goal_reached
títuloTítulo de la campaña.Llamada de fin de año
descriptionTexto de descripción corta de la campaña.Ayúdanos a alcanzar nuestro objetivo de igualación
ObjetivoObjetivo de recaudación de fondos en la moneda de tu tienda.2000
Monto donadoTotal recaudado en el momento en que se activó el evento.2045
Número de donantesNúmero total de donantes únicos.38
Fecha de finalizaciónFecha de finalización de la campaña, ISO 8601. Vacío si la campaña no tiene fecha de finalización.2026-12-31T23:59:59+00:00
fechaCuándo se publicó la campaña por primera vez, ISO 8601.2026-05-01T10:00:00+00:00
estadoEstado de la publicación de WordPress.publish
Enlace permanenteURL pública de la campaña.https://example.org/campaigns/year-end/
ID del creador de la campañaID de usuario de WordPress del propietario de la campaña.4
Nombre del creador de la campañaNombre para mostrar del propietario de la campaña.Bruce Banner
Correo electrónico del creador de la campañaDirección de correo electrónico del propietario de la campaña.[email protected]
DestinatarioA dónde van los fondos – normalmente fundraiser para peer-to-peer o parent para campañas secundarias.fundraiser
Elemento padreSi la campaña es hija de peer-to-peer, el ID de la campaña principal. 0para campañas independientes.99
Tipo de recaudadorPara campañas peer-to-peer, el tipo de recaudador.individual, equipo
team_id, team_name, team_captain_idMetadatos del equipo para recaudadores de equipos peer-to-peer.

Nota: Para Objetivo de campaña alcanzado, el evento incluye amount_raised, goal, y percent_funded como campos adicionales más allá de la carga útil estándar de la campaña. Estos se calculan en el momento en que se cruzó el objetivo y no se actualizarán después.

Entradas de acción y búsqueda

Los dos pasos de acción y los dos pasos de búsqueda tienen sus propios campos de entrada visibles en el editor de Zap. Dado que los campos de entrada evolucionan con más frecuencia que las cargas útiles de los desencadenadores, esta sección es un resumen rápido en lugar de una tabla exhaustiva: abra el paso en el editor de Zap para obtener la lista completa actual con texto de ayuda.

  • Crear donante – acepta campos de perfil de donante (nombre, apellidos, correo electrónico, campos de dirección, teléfono, consentimiento de contacto, suscripción al boletín). Devuelve el registro completo del donante creado o coincidente.
  • Actualizar donante – toma un campo de búsqueda (correo electrónico o ID de donante) más cualquiera de los mismos campos de perfil de donante. Solo se cambian los campos que usted proporciona.
  • Buscar donante por correo electrónico – toma una entrada, la dirección de correo electrónico. Devuelve el registro completo del donante, o ninguna coincidencia.
  • Buscar campaña – toma un slug de campaña o un ID de campaña. Devuelve la carga útil de la campaña descrita en la sección Campos de desencadenador de campaña anterior.

¡Eso es todo! Ahora sabe qué envía cada desencadenador de Zapier de Charitable, lo que significa que el mapeo de campos en cualquier paso posterior de Zap debería ser sencillo. A continuación, consulte Filtrar Zaps de Charitable por campaña para limitar un Zap a campañas o condiciones específicas, y Conectar Charitable a Zapier para la guía principal de inicio.

Preguntas frecuentes

¿Cuál es la diferencia entre subtotal y total?

subtotal es el importe base de la donación que el donante seleccionó. total es lo que se cobró realmente, que puede ser superior si el donante optó por cubrir la comisión de procesamiento de la pasarela. La diferencia aparece en el campo fee_amount.

¿Por qué status siempre empieza con charitable-?

Charitable registra sus propios estados de publicación de WordPress para mantenerlos separados de los estados integrados de WordPress como publish y draft. El prefijo charitable- es interno pero es necesario al filtrar: las reglas de (Texto) Coincide exactamente necesitan el valor completo con prefijo, no solo completed o refunded.

¿Hay algún campo que no esté en esta lista?

Sí. Charitable permite a los desarrolladores añadir campos personalizados de donación, donante y campaña, y cualquier campo marcado show_in_webhook en la API de Campos de Donación se incluye automáticamente en la carga útil junto con los valores predeterminados. Comprueba los datos de ejemplo del desencadenador en el editor de Zap para ver los campos personalizados añadidos por tu instalación específica o por otras extensiones de Charitable.

¿Puedo enviar solo un subconjunto de campos a mi acción posterior?

Sí. El paso de acción del editor de Zap te permite mapear cualquier subconjunto de los campos del desencadenador en las entradas de la acción. Los campos que no mapees simplemente se ignoran. Esta es la forma más limpia de mantener los registros de contactos de CRM despejados.

¿Cómo sé a qué campaña pertenece un recaudador de fondos entre pares?

Mira post_parent en la carga útil de un desencadenador de campaña. Para las campañas secundarias, post_parent contiene el ID de la campaña principal. Para las campañas independientes es 0.

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

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

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