Documentación de Charitable

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

Tipo de cuenta de PayPal Commerce

Requiere:

El ajuste del Tipo de cuenta en la pasarela PayPal Commerce indica a PayPal cómo clasificar cada donación que tu sitio les envía. La elección que hagas aquí afecta a cuatro aspectos del lado de PayPal: el nivel de comisión por transacción que recibes, cómo se gestionan las disputas de los donantes, cómo el motor de fraude y riesgo de PayPal evalúa tus transacciones y cómo aparecen las transacciones tanto en tus informes de comerciante de PayPal como en el historial de actividad de PayPal de tu donante.

El ajuste es obligatorio en Charitable Pro 1.8.16+ – las donaciones de PayPal Commerce se bloquean en el formulario de donación hasta que elijas uno y guardes.

Cómo encontrarlo

Administrador de WordPress > Charitable > Ajustes > Pasarelas de Pago > PayPal Commerce > Organización > Tipo de Cuenta

Verás dos opciones:

  • Organización sin ánimo de lucro / benéfica
  • Empresa / Estándar

No hay una opción predeterminada. Debes elegir una antes de que tu sitio pueda aceptar donaciones de PayPal Commerce.

¿Qué opción debería elegir?

Elige Organización sin ánimo de lucro / benéfica si:

  • Tu organización es una organización benéfica registrada 501(c)(3), 501(c)(4) o equivalente en tu país.
  • Tu organización no está registrada pero funciona como una organización benéfica (recaudación de fondos comunitaria, iglesia sin estatus formal, patrocinio fiscal, causa de base).
  • Las transacciones que estás recaudando son genuinamente donaciones – los donantes dan sin expectativa de recibir bienes o servicios a cambio.

Elige Empresa / Estándar si:

  • Estás utilizando Charitable para recaudar entradas para eventos, cuotas de membresía, pagos de patrocinios o intercambios similares donde el donante recibe algo a cambio.
  • Tu organización es una empresa con ánimo de lucro que utiliza Charitable por cualquier motivo.
  • Tus transacciones no califican como donaciones benéficas según la definición de tu autoridad fiscal local.

Si gestionas una operación híbrida – una organización sin ánimo de lucro que también vende entradas para eventos a través de Charitable – elige Organización sin ánimo de lucro / benéfica como tu opción predeterminada y utiliza el filtro por campaña descrito en las notas del desarrollador a continuación para anular campañas individuales que no sean donaciones.

Qué cambia cuando eliges Organización sin ánimo de lucro / benéfica

Charitable envía category: "DONATION" en cada línea de artículo en la carga útil del pedido de PayPal. PayPal aplica cuatro efectos en su lado:

1. Comisión de donación con descuento

PayPal cobra una comisión por transacción más baja en las transacciones etiquetadas como donaciones. Esta es una reducción de comisión real y automática que se aplica a tu cuenta de inmediato – no se requiere una solicitud separada. La tasa exacta varía según la región y la moneda; PayPal publica las tasas actuales en su página de comisiones para comerciantes.

Si su cuenta PayPal Business también está marcada como una organización benéfica verificada (lo que PayPal determina a partir de la información de la organización sin fines de lucro que proporcionó durante la configuración de su cuenta PayPal Business: EIN, documentos de registro, tipo de negocio, industria, etc.), recibe automáticamente la tarifa de organización benéfica más baja. PayPal aplica la tarifa que sea más baja. Su marca de organización benéfica en el sistema de PayPal es independiente de la configuración del Tipo de cuenta en Charitable: esta configuración le dice a PayPal cómo clasificar la transacción; su marca de cuenta le dice a PayPal a qué nivel de descuento califica. Consulte Estado de organización benéfica en su cuenta de PayPal a continuación para saber cómo verificar o actualizar la información de su organización sin fines de lucro en su cuenta de PayPal.

2. Gestión de disputas

Las transacciones de donación no están cubiertas por Protección al Comprador de PayPal. Cualquier disputa que inicie un donante se tramita a través de su emisor de tarjeta o banco en lugar del programa de protección al comprador de PayPal. Esto generalmente funciona a su favor: tiene un vector menos de contracargos contra el que defenderse, y las disputas de donantes contra donaciones son raras.

3. Evaluación de riesgos y fraude

PayPal procesa las transacciones de donación a través de un marco de riesgo específico para donaciones con umbrales y patrones calibrados para donaciones benéficas. Su equipo evalúa las transacciones de organizaciones sin fines de lucro por separado de las compras comerciales, y el modelo de riesgo tiene en cuenta patrones específicos de donaciones (regalos únicos de nuevos donantes, pequeñas cantidades recurrentes de donantes establecidos, picos de donaciones de fin de año) que parecerían sospechosos en un contexto comercial estándar.

4. Informes y experiencia del donante

Las transacciones aparecen como donaciones, no como compras, tanto en sus informes comerciales de PayPal como en el historial de actividad de PayPal de su donante. PayPal también ajusta el contenido en el proceso de pago de PayPal que ve el donante para usar un lenguaje apropiado para donaciones. Los donantes ven que donaron a su organización, no que pagaron por un producto.

¿Qué cambia al elegir Business / Standard?

Charitable envía category: "DIGITAL_GOODS" en cada línea de artículo. PayPal trata las transacciones como compras comerciales:

  • Se aplican las tarifas de transacción comerciales estándar.
  • La Protección al Comprador de PayPal cubre las disputas de los donantes.
  • Marco de riesgo de comercio estándar.
  • Las transacciones aparecen como compras en los informes comerciales y la actividad del donante.

Esta es la configuración correcta para entradas de eventos, membresías, patrocinios y cualquier pago en el que el donante reciba algo a cambio.

Esta configuración clasifica las transacciones, no su cuenta

Esta configuración controla cómo PayPal clasifica cada transacción de donación individual que envía Charitable. No actualiza el estado de organización sin fines de lucro de su cuenta de PayPal (PayPal lo maneja por separado, durante la configuración de su cuenta Business; consulte Estado de organización benéfica en su cuenta de PayPal a continuación).

Si seleccionas Sin ánimo de lucro / Benéfica pero tu cuenta PayPal Business no está realmente asociada a una organización benéfica, seguirás enviando transacciones clasificadas como donaciones, pero no recibirás la tarifa de caridad más baja (esta depende de la marca de la cuenta, no de esta configuración). PayPal también puede marcar la discrepancia a través de su monitorización de riesgos con el tiempo. Sé honesto sobre qué opción coincide con tu operativa.

Estado de caridad en tu cuenta PayPal

Dos cosas diferentes determinan las tarifas que pagas por las donaciones:

  1. La clasificación de la transacción que envías (controlada por esta configuración de Tipo de cuenta). Elegir Sin ánimo de lucro / Benéfica le dice a PayPal “esta transacción es una donación”, lo que desbloquea el nivel de tarifa de donación con descuento de PayPal.
  2. El estado de caridad de tu cuenta PayPal Business (determinado por PayPal durante la configuración de tu cuenta). Si tu cuenta PayPal Business está marcada como una organización benéfica verificada, PayPal aplica la tarifa de caridad más baja en su lugar, automáticamente, sin necesidad de ningún cambio en Charitable.

Ambas funcionan juntas. La mayoría de los usuarios de Charitable con la configuración Sin ánimo de lucro / Benéfica reciben la tarifa de donación con descuento (de la clasificación). Los usuarios de Charitable cuyas cuentas PayPal también están marcadas como organizaciones benéficas verificadas reciben la tarifa de caridad más baja (de la marca de la cuenta).

Comprobar o actualizar tu estado de caridad en PayPal

PayPal gestiona la verificación de caridad como parte de la configuración estándar de la cuenta Business; no es un programa separado con una URL de solicitud separada. Cuando configuras (o actualizas) una cuenta PayPal Business, PayPal solicita:

  • Tipo de negocio (Sin ánimo de lucro / Benéfica es una de las opciones)
  • Clasificación de la industria
  • Número EIN o de identificación fiscal
  • Documentación de registro sin ánimo de lucro (en EE. UU., tu carta de determinación 501(c)(3); en otros países, tu registro de caridad local)

Si configuraste tu cuenta PayPal Business antes de que tu organización sin ánimo de lucro estuviera formalmente registrada (o no te identificaste como tal al registrarte), ponte en contacto con el soporte de PayPal Business y pídeles que actualicen tu perfil de empresa para reflejar tu estado de organización sin ánimo de lucro. Una vez que PayPal actualice la marca de tu cuenta, la tarifa de caridad más baja se aplicará automáticamente a cada transacción futura que Charitable envíe con la clasificación Sin ánimo de lucro / Benéfica.

No necesitas cambiar nada en Charitable cuando se actualice la marca de tu organización benéfica en el lado de PayPal. La configuración de Tipo de cuenta en Charitable permanece en Sin ánimo de lucro / Benéfica; PayPal aplica la tarifa más baja basándose en la marca de tu cuenta.

Cambiar tu Tipo de cuenta más adelante

Puedes cambiar la configuración en cualquier momento. Las nuevas donaciones realizadas después de guardar utilizan la nueva clasificación. Las donaciones existentes y sus registros de PayPal no se reclasifican retroactivamente.

Si cambias de Sin ánimo de lucro / Benéfica a Business / Estándar mientras tienes donaciones recurrentes activas, el próximo ciclo de renovación utilizará la nueva clasificación. No se notifica al donante; solo cambia la clasificación en el lado del comerciante en PayPal.

Por qué se requiere la configuración

Charitable Pro 1.8.16 hizo obligatoria esta configuración porque la opción predeterminada incorrecta tiene consecuencias reales. Si asumiéramos tácitamente que todos son organizaciones sin fines de lucro, los comerciantes con fines de lucro que usan Charitable para entradas de eventos tendrían sus transacciones clasificadas erróneamente como donaciones, exponiéndolos a posibles problemas con los términos de servicio de PayPal. Si asumiéramos que todos son empresas, los comerciantes sin fines de lucro pagarían tarifas más altas de las que deberían.

El manejo predeterminado estricto (B-strict) fuerza una elección explícita en cada sitio para que el comerciante, no el plugin, sea el propietario de la decisión de clasificación.

Notas para desarrolladores

Anulación por campaña

Los sitios avanzados pueden anular la categoría en una base por campaña utilizando el filtro `charitable_paypal_commerce_line_item_category`:

add_filter(
    'charitable_paypal_commerce_line_item_category',
    function ( $category, $payment_method, $context ) {
        // Override for a specific campaign ID - e.g., a nonprofit's
        // separate event-ticket campaign.
        if ( $context instanceof Charitable_Campaign_Donation
            && 1234 === (int) $context->get_campaign_id() ) {
            return 'DIGITAL_GOODS';
        }
        return $category;
    },
    10,
    3
);

Los métodos de pago de Apple Pay recurren automáticamente a `PHYSICAL_GOODS` independientemente de la configuración del Tipo de Cuenta, ya que PayPal actualmente rechaza `DONATION` para Apple Pay (estado en reevaluación por PayPal). PayPal Wallet, Venmo, los campos de tarjeta ACDC, Google Pay y las renovaciones de tarjetas almacenadas admiten `DONATION` y utilizan el valor derivado de la configuración del Tipo de Cuenta. La recurrencia de Apple Pay se ejecuta antes del filtro, por lo que no se puede anular.

Renovaciones de tarjetas almacenadas

Las donaciones recurrentes procesadas a través del modo Vault + Cron de Charitable conservan la misma categoría en cada renovación que su donación original, según la configuración de la pasarela en el momento de la renovación. Si cambia el Tipo de Cuenta, el cambio se propagará automáticamente a las renovaciones futuras.

Relacionado

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