PayPal Commerce es la integración moderna de PayPal para Charitable: una única conexión que permite a tus donantes pagar con PayPal, Venmo, Pay Later, tarjetas de crédito y débito, Apple Pay y Google Pay. Esta página te guía a través de su activación en tu sitio y qué hacer si no aparece en tu lista de pasarelas.

PayPal Commerce reemplaza las configuraciones antiguas de PayPal Standard, Express Checkout y Card Processing con una integración que también habilita Venmo, Pay Later, Apple Pay y Google Pay. Los donantes ven botones de billetera modernos y un proceso de pago más rápido, y tú gestionas los reembolsos y las donaciones recurrentes directamente dentro de WordPress sin tener que lidiar con múltiples productos o cuentas de PayPal. Para obtener más información, consulta Introducing PayPal Commerce.

Disponible en Charitable Pro 1.8.15 o superior.

Activar PayPal Commerce

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. Haz clic en Settings junto a PayPal Commerce, luego haz clic en Connect with 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 te redirigirá de vuelta a WordPress. El panel de conexión mostrará tu ID de comerciante y las capacidades concedidas a tu cuenta.

Eso es todo: tus formularios de donación ofrecerán inmediatamente PayPal Commerce como opción de pago.

Modo de prueba – PayPal Commerce respeta el control estándar de Modo de prueba de Charitable. Deja el Modo de prueba activado mientras validas el flujo del donante, luego desactívalo cuando estés listo para aceptar donaciones en vivo.

¿No ves PayPal Commerce en tu lista de pasarelas?

Para mantener las cosas predecibles,solo se muestra una integración de PayPal por sitio a la vez. Si tu sitio ya está configurado con la pasarela de PayPal existente (PayPal Standard / IPN), PayPal Commerce permanece oculto por defecto y la lista de pasarelas muestra tu configuración de PayPal existente en su lugar.

Charitable decide cuál mostrar durante la actualización 1.8.15 comprobando dos señales:

• ¿Está la pasarela de PayPal existente actualmente habilitada en tu configuración?
• ¿Hay donaciones previas en tu sitio que se procesaron a través de la pasarela de PayPal existente?

Si alguna de estas condiciones es cierta, tu sitio conservará su configuración de PayPal existente y PayPal Commerce permanecerá oculto.

Este es el comportamiento correcto para la gran mayoría de los sitios: ejecutar ambas integraciones una al lado de la otra complica la experiencia del donante y la contabilidad. Pero si deseas cambiar a PayPal Commerce de todos modos, puedes hacerlo.

Cambiar a PayPal Commerce

Antes de cambiar, lee esto

Si tienesdonaciones recurrentes activasen curso a través de la pasarela de PayPal existente, por favor lee esto detenidamente:

• PayPalcontinuará facturando a tus donantessegún el calendario que hayas establecido. Ninguno de tus donantes será cancelado.
• Sin embargo, después de cambiar, Charitable ya no registrará esas renovaciones en tu panel de control, porque el manejador IPN para la pasarela PayPal existente se deshabilita cuando cambias.

Si te importa informar sobre esas renovaciones, cancela las donaciones recurrentes en tu panel de PayPal antes de cambiar. O contacta a nuestro equipo de soporte; podemos ayudarte a migrar donantes activos cuando nuestra herramienta de migración se lance en una futura versión.

Si solo tienes donaciones históricas únicas y ninguna recurrente activa, el cambio no tiene impacto en el donante.

Tres formas de cambiar

Elige el camino que coincida con tu nivel de acceso. Los tres logran lo mismo.

Camino 1 – WP-CLI (recomendado para desarrolladores y agencias)

Si tienes acceso a la línea de comandos de tu servidor (SSH, CLI de hosting, etc.), este es el camino más limpio:

wp charitable paypal force-commerce-tier --confirm-recurring-impact

La opción --confirm-recurring-impact es necesaria cuando tienes donaciones recurrentes activas en la pasarela PayPal existente. El comando se negará a ejecutarse de lo contrario, con un recuento de cuántas donaciones se verían afectadas.

Previsualiza lo que sucedería con la opción --dry-run antes de confirmar:

wp charitable paypal force-commerce-tier --dry-run

Después del cambio, ve a Charitable → Ajustes → Pasarelas de Pago y completa el flujo Conectar con PayPal en la tarjeta PayPal Commerce para empezar a aceptar donaciones.

Camino 2 – Filtro de functions.php (para desarrolladores sin acceso a la línea de comandos)

Añade este fragmento a functions.php de tu tema o a un pequeño plugin personalizado:

add_filter( 'pre_option_charitable_paypal_user_tier', function () {
    return 'commerce';
} );

El filtro se ejecuta en cada llamada a get_option(), por lo que PayPal Commerce se vuelve visible inmediatamente en la siguiente carga de página de administración.

Esta es una anulación en tiempo de ejecución; no cambia el valor almacenado en tu base de datos. La anulación permanece activa mientras el filtro esté en tu código; elimina el filtro y se restaura la visibilidad original. Si deseas hacer el cambio permanente sin mantener el filtro, déjalo activo para verificar que todo funciona, luego ejecuta el comando WP-CLI del Camino 1.

Camino 3 – Actualización SQL (para usuarios de panel de hosting / phpMyAdmin)

Si te sientes cómodo con phpMyAdmin, Adminer o la herramienta de base de datos de tu panel de hosting, ejecuta esta consulta en tu base de datos de WordPress:

UPDATE wp_options
SET option_value = 'commerce'
WHERE option_name = 'charitable_paypal_user_tier';

Reemplaza wp_options con el prefijo de tabla real si no es el predeterminado. El cambio es inmediato; actualiza la página de ajustes de pasarelas y aparecerá PayPal Commerce.

⚠️ Recordatorio: si tienes donaciones recurrentes activas en la pasarela PayPal existente, PayPal seguirá cobrando a los donantes pero Charitable no registrará esas renovaciones. Cancélalas primero en PayPal, o procede sabiendo la contrapartida.

Qué sucede después de cambiar

• La pasarela PayPal existente desaparece de tu lista de ajustes de pasarelas. Sus credenciales API guardadas permanecen en la base de datos en caso de que se añada una ruta inversa en el futuro.
• PayPal Commerce aparece en la lista de pasarelas. Su botón Conectar con PayPal está habilitado. Haz clic en él para iniciar el proceso de incorporación con PayPal.
• Hasta que completes la incorporación, PayPal Commerce mostrará un estado de “no conectado” y los donantes no verán PayPal como opción de pago en el formulario de donación.
• Las donaciones registradas antes del cambio no se ven afectadas; conservan su etiqueta de pasarela original y permanecen visibles en tus informes.

Cómo deshacer un cambio

No hay botón de deshacer en la interfaz. El cambio es unidireccional bajo el modelo actual.

Si realizaste el cambio por error o encontraste un problema inesperado, por favor contacta a nuestro equipo de soporte. Podemos ayudarte a restaurar tu configuración anterior directamente, y estamos registrando estas solicitudes para informar si deberíamos crear una ruta inversa adecuada en una futura versión.

¿Necesitas ayuda?

Si algo de esto no está claro, o si deseas ayuda para realizar el cambio, nuestro equipo de soporte estará encantado de guiarte. Abre un ticket desde tu cuenta de Charitable y menciona “Activación de PayPal Commerce”; nosotros nos encargaremos del resto.