Stripe es la pasarela de pago más popular y con más funciones para la facturación por suscripción en WooCommerce. Esta guía recorre la integración completa de Stripe con WPSubscription — desde conectar las claves API hasta configurar webhooks, activar Smart Retries para pagos fallidos y establecer la autenticación 3D Secure compatible con SCA.
La integración completa toma de 30 a 45 minutos para una configuración cuidadosa y produce un sistema de facturación por suscripción que funciona de forma confiable a escala.
Por qué es importante
Stripe ofrece la mejor combinación de funciones para negocios de suscripción: Smart Retries (lógica de reintento optimizada con aprendizaje automático que recupera un 10-20% más de pagos fallidos que un reintento básico), Card Updater (actualización automática de tarjetas vencidas sin acción del cliente), soporte sólido de 3DS para cumplimiento SCA, y la entrega de webhooks más confiable de la industria. Stripe también tiene la mejor documentación para desarrolladores, las tasas de rechazo más bajas por parte de los bancos emisores y la cobertura internacional más amplia (más de 40 países).
Para la mayoría de las tiendas WooCommerce con suscripciones, Stripe es la elección predeterminada clara — competidores como PayPal cubren casos de uso específicos, pero Stripe es el caballo de batalla.
Antes de empezar
- Una cuenta de Stripe (créala gratis en stripe.com)
- WPSubscription instalado y activado
- Acceso de administrador tanto a WordPress como a tu panel de Stripe
- Verificación de negocio completada en Stripe (requerida antes de pasar a modo en vivo)
- Certificado SSL activo en tu sitio de WordPress (requerido para el modo en vivo)
Instrucciones paso a paso
Obtén tus claves API de Stripe
Inicia sesión en tu panel de Stripe en dashboard.stripe.com. Ve a Developers → API keys.
Verás dos conjuntos de claves: modo de pruebas (para desarrollo) y modo en vivo (para producción). Copia tu clave publicable (comienza con pk_) y tu clave secreta (comienza con sk_).
Durante la configuración inicial, usa las claves de modo de pruebas (pk_test_ / sk_test_) — cambiarás a las claves en vivo después de verificar que la integración funciona de principio a fin. Mantén tu clave secreta privada; trátala como una contraseña.
Ingresa las claves API en WooCommerce
En tu panel de WordPress, ve a WooCommerce → Ajustes → Pagos → Stripe. Si Stripe no aparece en la lista, es posible que necesites instalar primero la extensión WooCommerce Stripe Payment Gateway.
Pega tu clave publicable en el campo "Publishable key" y tu clave secreta en el campo "Secret key". Activa el interruptor "Modo de pruebas" por ahora.
Configura funciones adicionales de Stripe según desees: Stripe Link para pago en un clic, Apple Pay, Google Pay. Guarda los cambios.
Configura los webhooks de Stripe
En tu panel de Stripe, ve a Developers → Webhooks → Add endpoint. Establece la URL del endpoint como: https://tusitio.com/wc-api/wc_stripe (reemplaza tusitio.com con tu dominio real — debe incluir https).
En "Events to listen to," selecciona al menos: payment_intent.succeeded, payment_intent.payment_failed, customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.payment_succeeded, invoice.payment_failed. Guarda y copia el Signing secret que genera Stripe (comienza con whsec_).
Agrega el secreto de firma del webhook a WooCommerce
Pega el Signing secret del webhook de Stripe en el campo WooCommerce → Ajustes → Pagos → Stripe → Webhook secret. Este paso es crítico — sin él, WooCommerce no puede verificar que los eventos de webhook entrantes realmente provienen de Stripe, y las renovaciones pueden no ejecutarse.
El secreto de firma es diferente para los webhooks de modo de pruebas y modo en vivo — necesitarás actualizarlo al cambiar al modo en vivo. Guarda los cambios.
Activa Smart Retries y Card Updater
En tu panel de Stripe, ve a Settings → Subscriptions and billing. Activa "Smart Retries" — la lógica de reintento de Stripe basada en aprendizaje automático que optimiza el momento del reintento según el motivo específico de rechazo y los patrones del banco.
Activa también "Card Updater" si está disponible — actualiza automáticamente los datos de tarjetas vencidas desde el banco del cliente sin requerir acción de su parte. Ambas funciones reducen significativamente la cancelación involuntaria y son mejoras esencialmente gratuitas.
Prueba y cambia al modo en vivo
Completa una suscripción de prueba usando la tarjeta de prueba de Stripe 4242 4242 4242 4242 con cualquier fecha de vencimiento futura y cualquier CVC de 3 dígitos. Verifica que aparezca en WooCommerce → Subscriptions y en Stripe bajo Customers.
Revisa el panel de webhooks de Stripe para confirmar entregas exitosas de eventos (respuestas 200). Prueba una renovación usando Stripe Test Clocks para adelantar el tiempo.
Una vez confirmado, regresa a WooCommerce → Ajustes → Pagos → Stripe, desactiva el Modo de pruebas, reemplaza las claves de prueba por claves en vivo, actualiza la URL del webhook para usar el secreto de firma del modo en vivo, y realiza una última prueba pequeña con dinero real.
Consejos de experto
- Activa Smart Retries de inmediato — la optimización de reintentos con aprendizaje automático de Stripe recupera un 10-20% más de pagos fallidos
- Configura Stripe Tax para calcular y remitir automáticamente el impuesto de ventas/IVA en cada renovación
- Usa Stripe Radar para detección de fraude — la puntuación de riesgo basada en aprendizaje automático detecta suscripciones fraudulentas antes de que se activen
- Configura consultas de Stripe Sigma para análisis de suscripciones personalizados más allá de lo que muestra el panel
- Activa Stripe Customer Portal para gestión autoservicio de suscripciones como respaldo del área Mi cuenta de WooCommerce
Resultado
Stripe está completamente integrado con WPSubscription, gestionando la creación de suscripciones, la facturación recurrente automática, la detección y recuperación de fallos de pago mediante Smart Retries, la autenticación 3D Secure compatible con SCA, y el manejo de eventos basado en webhooks sin fricciones — todo sin intervención manual.
Solución de problemas
Problema:Los eventos de webhook aparecen como "fallidos" en el panel de Stripe
Solución:La causa más común es una URL de endpoint incorrecta o un problema de certificado SSL. Confirma que la URL sea exactamente tu-tienda.com/wc-api/wc_stripe (sin problemas de barra final, debe ser https). Verifica que tu sitio tenga un certificado SSL válido (no autofirmado ni vencido). Verifica también que tu sitio no esté bloqueando las solicitudes de webhook mediante un firewall, plugin de seguridad (Wordfence, Sucuri) o límite de tasa.
Problema:Las suscripciones aparecen como activas pero los cobros de renovación no se ejecutan
Solución:Revisa WooCommerce → Estado → Registros en busca de entradas relacionadas con Stripe. Esto suele indicar un secreto de firma de webhook faltante o vencido. Vuelve a copiar el secreto de firma desde Stripe → Developers → Webhooks → tu endpoint → Signing secret y actualiza el campo en WooCommerce. Verifica también que el cron de WordPress esté funcionando — ve a WooCommerce → Estado → Acciones programadas.
Problema:Los clientes ven errores de autenticación 3D Secure
Solución:Esto es normal para clientes de la UE/Reino Unido debido a los requisitos PSD2/SCA. WPSubscription con Stripe gestiona 3DS automáticamente — pero el cliente debe completar la autenticación del lado del banco (código SMS, notificación push de la app bancaria, biometría). Si el cliente no puede completar 3DS, contacta a su banco para verificar que el método de autenticación esté correctamente configurado. Algunos bancos requieren inscripción en 3DS antes de poder usarlo.
Problema:Stripe cobra a los clientes pero no aparecen pedidos en WooCommerce
Solución:Esto indica un fallo en la entrega del webhook — Stripe cobró pero no notificó a WooCommerce. Revisa los registros de webhooks de Stripe en busca de entregas fallidas. Causas comunes: URL de endpoint de webhook incorrecta, tiempo de inactividad del servidor, plugin de seguridad bloqueando la solicitud, o discrepancia en el secreto de firma del webhook. Reenvía los webhooks fallidos desde el panel de Stripe para sincronizar manualmente.
Preguntas frecuentes
¿Por qué Stripe en lugar de PayPal para suscripciones en WooCommerce?
¿Cuánto cuesta Stripe para suscripciones?
¿Cómo gestiono Stripe Tax con suscripciones?
¿Qué es Stripe Radar y debería activarlo?
¿Puedo usar Stripe en modo de pruebas mientras acepto pagos reales por PayPal?
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 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.
Cómo automatizar las renovaciones de suscripción en WooCommerce
6 pasos · Configura la facturación de renovación de suscripción totalmente automatizada con WPSubscription para que el ingreso funcione en piloto automático.