PayPal es la segunda pasarela de pago más popular para suscripciones en WooCommerce, particularmente importante para clientes en regiones donde es el método de pago preferido (Alemania, partes de Europa y muchos mercados internacionales). Sin embargo, las suscripciones de PayPal requieren que las "Transacciones de referencia" estén habilitadas en tu cuenta antes de que la facturación recurrente funcione — una función que PayPal no habilita de forma predeterminada y que requiere una solicitud manual.
Esta guía cubre la configuración completa, incluyendo el proceso de habilitación de las Transacciones de referencia.
Por qué es importante
Ofrecer PayPal como opción de pago puede aumentar la conversión entre un 5 y 15% en mercados donde los clientes lo prefieren. Los usuarios de PayPal a menudo confían más en la marca para la seguridad y resolución de disputas que al ingresar los datos de la tarjeta directamente.
Para clientes internacionales especialmente, PayPal elimina la fricción en torno a la conversión de moneda extranjera y los nombres de comercio poco familiares. Aunque Stripe debería ser tu pasarela principal, agregar PayPal como opción secundaria captura el segmento de clientes que de otro modo abandonaría el pago.
El trabajo de configuración es considerable pero es un esfuerzo único.
Antes de empezar
- Una cuenta PayPal Business (las cuentas personales no admiten pagos recurrentes)
- Transacciones de referencia habilitadas en tu cuenta de PayPal (requiere solicitud manual)
- WPSubscription instalado y activado
- Credenciales API de PayPal (Client ID y Secret desde el panel de PayPal Developer)
- Acceso de administrador a tu cuenta de PayPal para la configuración de webhook/IPN
Instrucciones paso a paso
Habilita las Transacciones de referencia en tu cuenta de PayPal
La función de Transacciones de referencia de PayPal es necesaria para la facturación recurrente automática, pero no está habilitada de forma predeterminada. Contacta al Soporte Técnico para Comercios de PayPal y solicita explícitamente que se habiliten las "Transacciones de referencia" en tu cuenta Business.
La solicitud normalmente tarda de 1 a 5 días hábiles en procesarse. Sin esto, WooCommerce solo puede procesar el primer pago de la suscripción — todas las renovaciones posteriores fallarán.
Esta es la causa más común de que las suscripciones de PayPal no funcionen correctamente.
Conecta PayPal a WooCommerce
Ve a WooCommerce → Ajustes → Pagos → PayPal. Tienes dos opciones de conexión: 1) Haz clic en "Conectar con PayPal" e inicia sesión en tu cuenta PayPal Business para autorizar la conexión (más fácil, recomendado), o 2) Usa credenciales API manuales obteniendo tu Client ID y Secret desde PayPal Developer → My Apps & Credentials → tu aplicación, e ingresándolos en los ajustes de PayPal de WooCommerce.
Ambos métodos funcionan; la conexión OAuth es más simple para quienes no son desarrolladores.
Activa el modo Sandbox para pruebas
En los ajustes de la pasarela PayPal, activa el modo Sandbox e ingresa las credenciales de sandbox (prueba). Ve a developer.paypal.com → Sandbox → Accounts para crear cuentas de comprador y comercio de sandbox para pruebas.
El sandbox te permite probar el flujo completo de suscripción sin usar dinero real. Completa una compra de suscripción de prueba usando una cuenta de comprador sandbox para verificar que la integración funciona antes de pasar a modo en vivo.
Configura las notificaciones IPN
PayPal usa Notificaciones de Pago Instantáneo (IPN) para notificar a WooCommerce sobre eventos de suscripción. En tu cuenta de PayPal, ve a Account Settings → Notifications → Instant payment notifications.
Configura la URL de notificación como: https://tusitio.com/?wc-api=WC_Gateway_Paypal. Activa el IPN.
Guarda los cambios. Sin el IPN configurado correctamente, WooCommerce no será notificado de los pagos de renovación y el estado de tu suscripción se desincronizará de PayPal.
Prueba el flujo completo de suscripción
Suscríbete como comprador sandbox a un producto de suscripción de prueba. Verifica que el pago inicial se procese correctamente y que la suscripción aparezca en WooCommerce → Subscriptions.
Luego verifica una renovación: PayPal no tiene una función de "test clock" como Stripe, así que puede que necesites esperar a un ciclo de renovación real o usar las funciones de avance de tiempo simulado del sandbox. Verifica que se envíe el correo de renovación, que el pedido se cree en WooCommerce y que el pago se registre en tu cuenta sandbox de PayPal.
Cambia al modo en vivo y activa
Cuando las pruebas de principio a fin confirmen que todo funciona en sandbox, cambia al modo en vivo: desactiva el modo Sandbox en WooCommerce → Ajustes → Pagos → PayPal, reemplaza las credenciales API de sandbox por las de modo en vivo, actualiza la URL de IPN para que apunte a tu cuenta de PayPal en vivo, y confirma que las Transacciones de referencia estén habilitadas en tu cuenta en vivo. Realiza una pequeña suscripción de prueba con dinero real para verificar que la integración en vivo funciona antes de lanzarla públicamente.
Consejos de experto
- Solicita la habilitación de las Transacciones de referencia con anticipación — tarda de 1 a 5 días hábiles, planifícalo en tu cronograma de lanzamiento
- Ofrece PayPal junto a Stripe en lugar de en su lugar — distintos clientes prefieren distintas pasarelas
- Prueba los flujos de renovación a fondo — PayPal tiene más casos límite que Stripe para suscripciones
- Monitorea las disputas de PayPal semanalmente — el volumen de disputas de PayPal suele ser mayor que los contracargos de Stripe
- Documenta tu configuración de PayPal en detalle — el requisito de Transacciones de referencia sorprende a muchos comercios
Resultado
PayPal está completamente configurado para la facturación recurrente de suscripciones en WooCommerce. Los clientes que prefieren PayPal ahora pueden suscribirse con cargos de renovación automáticos en cada ciclo de facturación.
Combinado con Stripe como tu pasarela principal, capturas las preferencias de los clientes en múltiples métodos de pago.
Solución de problemas
Problema:PayPal solo cobra el primer pago, sin renovar automáticamente
Solución:Esto casi siempre significa que las Transacciones de referencia no están habilitadas en tu cuenta PayPal Business. Contacta al Soporte Técnico para Comercios de PayPal para verificar y habilitar esta función. Es un proceso de aprobación manual que PayPal no habilita de forma predeterminada. No hay solución alternativa — sin las Transacciones de referencia, los pagos recurrentes automáticos simplemente no pueden funcionar a través de PayPal.
Problema:El pedido de renovación se crea en WooCommerce pero PayPal no cobra
Solución:Revisa WooCommerce → Estado → Registros en busca de errores de IPN de PayPal. Causas comunes: URL de notificación IPN incorrecta, discrepancia entre sandbox y modo en vivo de PayPal, o un bloqueo de IP que impide que PayPal llegue a tu servidor (algunos firewalls bloquean las IPs de PayPal). Confirma que la URL de IPN sea accesible públicamente y que los servidores de PayPal puedan alcanzarla.
Problema:Las disputas de PayPal se acumulan más rápido que en Stripe
Solución:El proceso de disputas de PayPal es más amigable para el cliente que los contracargos, lo que genera mayor volumen de disputas pero una resolución más fácil. Responde a cada disputa con prontitud y evidencia (términos de registro, registros de comunicación, datos de uso). Facilita la cancelación desde Mi cuenta — las disputas de PayPal suelen ser presentadas por clientes que no lograron entender cómo cancelar.
Problema:Los clientes no pueden completar el pago porque no tienen cuenta de PayPal
Solución:PayPal puede configurarse para aceptar pagos con tarjeta de clientes sin cuenta de PayPal — esto se llama "Guest Checkout" o "PayPal Smart Buttons." Actívalo en los ajustes de tu cuenta de PayPal. Sin esto, los clientes sin cuenta de PayPal no pueden usar esta pasarela, lo que reduce significativamente la conversión en comparación con Stripe.
Preguntas frecuentes
¿Por qué necesito habilitar las Transacciones de referencia para suscripciones de PayPal?
¿Debería usar PayPal como pasarela principal o secundaria?
¿Cuál es la diferencia entre IPN y webhooks?
¿Las comisiones de suscripción de PayPal son más altas que las de Stripe?
¿Puedo migrar suscripciones existentes de PayPal a Stripe?
Términos del glosario relacionados
Más guías
Cómo configurar pagos recurrentes en WooCommerce
6 pasos · Conecta tu pasarela de pago y configura calendarios de facturación automática para productos de suscripción.
Cómo integrar Stripe con suscripciones de WooCommerce
6 pasos · Conecta Stripe a WPSubscription para una facturación recurrente confiable, webhooks y recuperación de pagos.
Cómo gestionar los pagos fallidos en WooCommerce
6 pasos · Configura la lógica de reintento automático y las notificaciones al cliente para recuperar pagos de suscripción fallidos.