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!

Mejora Pagos

💰 Acepta donaciones recurrentes con Windcave y Charitable

Un donante configura su donación una vez en la página de pago segura de Windcave, y Charitable factura cada renovación según lo programado. Por qué esto es importante:

🏦 Organizaciones con sede en Nueva Zelanda o Australia: donaciones mensuales en la pasarela con la que tu banco ya te ha configurado, sin un segundo procesador que incorporar.
⛪ Iglesias que reciben diezmos y ofrendas regulares: los miembros de la congregación establecen su propio calendario una vez, que es la forma más sencilla de lanzar donaciones recurrentes para la iglesia sin una plataforma separada.
🌏 Grupos con donantes en varias divisas: Windcave gestiona más de 20, por lo que un donante puede dar en la divisa que realmente posee.
📅 Fondos operativos en lugar de campañas puntuales: activa el modo Solo Recurrente y la opción única desaparece, por lo que cada donación a esa campaña es una suscripción.
🧾 Equipos sin desarrollador en plantilla: 3 conjuntos de credenciales pegados en una página de configuración, y sin código en ninguna parte.

Consulta nuestro anuncio aquí.

automatización actualizar

⚡ Creador Visual de Automatización: ¡Arrastrar y Soltar Sin Código!

Charitable Automation Connect 2.3.0 presenta el Generador de Automatización Visual, un lienzo a pantalla completa que presenta cada automatización como un flujo de tarjetas conectadas: un desencadenador, condiciones opcionales y una lista de acciones que se ejecutan en orden.

🧩 Muchas acciones, un desencadenador: Etiqueta a un donante, envía un correo electrónico, agrega una nota y activa una llamada webhook desde un solo evento, arrastrado en cualquier orden.

✉️ Actúa dentro de Charitable: Las nuevas acciones Enviar correo electrónico, Etiquetar donante y Agregar nota de donante se ejecutan sin necesidad de un servicio externo.

🔤 Etiquetas de combinación: Personaliza correos electrónicos y notas con campos en vivo como {first_name}, {total} y {campaign_name}.

🔁 Aplicar a donantes existentes: Ejecuta Etiquetar donante y Agregar nota de donante contra los donantes que ya tienes.

🖥️ Lienzo o Simple: Cambia de vista en cualquier momento, y las automatizaciones creadas antes de la 2.3.0 siguen funcionando sin cambios.

Lee más aquí.

Integración actualizado

📬 Presentamos Brevo para Charitable: Convierte donantes en suscriptores automáticamente

El momento en que un donante realiza una donación es cuando está más comprometido. Con la nueva integración de Brevo para Charitable, puedes convertir automáticamente a esos donantes únicos en suscriptores a largo plazo sin tocar una sola hoja de cálculo.

Simplemente recopila el consentimiento del donante directamente en tu formulario de donación y comienza tu serie de bienvenida de inmediato.

Novedades:

🔄 Sincronización automática de suscriptores: Los nuevos donantes que aceptan se añaden directamente a tu lista de contactos de Brevo tan pronto como se procesa su pago, sin necesidad de exportaciones manuales ni importaciones de CSV.

🎯 Control granular de consentimiento y opción de suscripción: Personaliza la etiqueta de tu casilla de verificación, elige si se marca por defecto o no, o activa la doble opción de suscripción de Brevo para mantener tu lista limpia y conforme.

📋 Mapeo de listas por campaña: Dirige a los donantes a tu lista de correo global o mapea campañas específicas a listas de Brevo dirigidas para adaptar tus mensajes de seguimiento.

⚡ Configuración en 5 minutos: Conéctate al instante pegando tu clave API de Brevo en la configuración de Newsletter, mapea tus campos de contacto y empieza a crear tu lista de correo en piloto automático.

¿Listo para hacer crecer tu lista de correo? Brevo ya está disponible a partir del plan Charitable Plus. ¡Conecta tu cuenta hoy mismo!

donaciones recurrentes actualizado

💳 Presentamos Actualizaciones de Tarjeta: ¡Soluciona Tarjetas Caducadas Sin Perder Suscripciones!

Las tarjetas de crédito caducadas o actualizadas son una de las mayores fugas silenciosas en la recaudación de fondos recurrente. Con las actualizaciones de tarjetas en la extensión de donaciones recurrentes, los donantes ahora pueden actualizar sus detalles de pago directamente, manteniendo intactas su suscripción, su calendario y su historial de donaciones.

Sin planes cancelados, sin historial perdido y sin dolores de cabeza administrativos para tu equipo.

Novedades:

⚡ Autoservicio en 30 Segundos: Los donantes obtienen un botón dedicado de “Actualizar Tarjeta” en su panel que abre el Portal de Clientes seguro y compatible con PCI de Stripe para actualizar los detalles de la tarjeta al instante.

🔒 Acceso Seguro y Delimitado: Delimitado exclusivamente a las actualizaciones de tarjetas por defecto, los donantes no pueden cancelar ni alterar accidentalmente sus planes desde el portal, manteniendo tus webhooks y datos sincronizados.

🤝 Soporte Asistido por Administrador: ¿Ayudando a un donante por teléfono? Abre su portal seguro de Stripe con un solo clic desde tu pantalla de administrador o genera un enlace de actualización de un solo uso para enviárselo por correo electrónico.

📋 Pista de Auditoría Automática: Cada actualización de método de pago se registra automáticamente con una marca de tiempo tanto en los registros generales del sistema como en el perfil del donante individual.

¡Listo para proteger tus ingresos recurrentes? Obtén el plan Plus o Pro y actualiza Donaciones Recurrentes a la versión 2.3.0+ y activa “Actualizar Método de Pago” en tu Configuración hoy mismo.

Integración constructor de páginas

¡Fans de Divi, regocíjense! ¡Módulo nativo de barra de progreso de campaña para Divi 5!

Con nuestro nuevo módulo nativo para Divi 5, puedes anclar tus micrositios con estadísticas de recaudación de fondos en tiempo real directamente en el lienzo visual. Así es como funciona y por qué vale la pena activarlo hoy.

Crea actualizaciones de campaña que sean VISUALES Y EN VIVO. También puedes:

📊 Barra de progreso de la campaña: Inserta una barra de progreso en vivo en cualquier diseño de Divi 5 y muestra el progreso de los objetivos en tiempo real.

🎨 Controles de estilo avanzados: Personaliza fácilmente el color de la barra y el seguimiento, la altura y el radio para que coincidan perfectamente con tu marca.

👁️ Listo para el constructor visual: Configura y previsualiza todo directamente en el lienzo de Divi como un módulo de primera clase.

🔁 Renderizado idéntico: El mismo motor exacto impulsa este módulo, lo que significa un diseño consistente sin soluciones alternativas heredadas.

✅ Lanzamientos más rápidos: Nunca salgas de la interfaz de Divi 5 para configurar códigos cortos o adivinar cómo se verán las etiquetas de tus objetivos.

Más información aquí.