¡Ya llegó la Encuesta de Cancelación de Suscripciones! Saber más
Guía práctica 6 pasos

Cómo integrar Stripe con suscripciones de WooCommerce

Conecta Stripe a WPSubscription para una facturación recurrente confiable, webhooks y recuperación de pagos.

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

1

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.

2

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.

3

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_).

4

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.

5

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.

6

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?
Stripe ofrece funciones de suscripción superiores: Smart Retries recupera un 10-20% más de pagos fallidos, Card Updater gestiona las tarjetas vencidas automáticamente, 3D Secure funciona sin fricciones, y los webhooks son más confiables que el IPN de PayPal. PayPal aún tiene valor como opción secundaria para clientes que lo prefieren, pero Stripe debería ser tu pasarela principal.
¿Cuánto cuesta Stripe para suscripciones?
La tarifa estándar es 2.9% + $0.30 por cobro exitoso en EE. UU. (3.4% + $0.30 para tarjetas internacionales). Stripe Billing (funciones avanzadas de suscripción) cuesta un 0.5-0.8% adicional, pero no es obligatorio — WPSubscription proporciona la funcionalidad de suscripción sobre el procesamiento de pagos estándar de Stripe. Hay descuentos por volumen disponibles para comercios con más de $80K/mes.
¿Cómo gestiono Stripe Tax con suscripciones?
Activa Stripe Tax en tu panel de Stripe — Settings → Tax. Stripe Tax calcula automáticamente el impuesto de ventas, IVA o GST correcto según la ubicación del cliente y el tipo de producto, aplicándolo automáticamente a cada renovación. La integración con las suscripciones de WooCommerce funciona sin fricciones. Cuesta 0.5% por transacción en regiones con soporte de impuestos.
¿Qué es Stripe Radar y debería activarlo?
Radar es el servicio de detección de fraude de Stripe, incluido gratis con todas las cuentas de Stripe. Usa aprendizaje automático entrenado con miles de millones de transacciones para puntuar el riesgo y bloquear pagos fraudulentos antes de que se procesen. Para negocios de suscripción, Radar reduce significativamente tanto las pérdidas por fraude como los contracargos. Actívalo — es esencialmente una reducción de riesgo gratuita.
¿Puedo usar Stripe en modo de pruebas mientras acepto pagos reales por PayPal?
Sí — cada pasarela funciona de forma independiente. Puedes ejecutar Stripe en modo de pruebas para desarrollo mientras PayPal acepta pagos en vivo. Solo recuerda cambiar Stripe a modo en vivo antes de lanzar las suscripciones, y asegúrate de que los clientes no vean ambas opciones simultáneamente si Stripe sigue en modo de pruebas.

El plugin de suscripciones nº 1 para WooCommerce

Empieza a vender suscripciones sin costo alguno.

Descarga, instala y empieza a cobrar ingresos recurrentes en todo el mundo con WPSubscription.