Tutorial: integrar Stripe con suscripciones en Node.js

Si estás construyendo un SaaS, tarde o temprano necesitarás integrar una pasarela de pago con suscripciones recurrentes. Stripe es la opción más robusta y bien documentada para proyectos en Node.js. Este tutorial te guía por los pasos esenciales.

1. Configuración inicial

Crea una cuenta en Stripe, activa el modo test y obtén las claves de API (pública y secreta). Instala el SDK oficial con npm install stripe e inicialízalo con tu clave secreta guardada en variables de entorno, nunca en el código.

2. Productos y precios

Define en Stripe tus productos (por ejemplo, Plan Básico, Plan Pro) y para cada uno un precio recurrente (mensual, anual). Stripe genera IDs que usarás desde tu backend.

3. Checkout session

La forma más sencilla de cobrar es crear una sesión de Stripe Checkout desde tu backend. Le pasas el precio, la URL de éxito y la de cancelación, y Stripe te devuelve una URL donde rediriges al usuario para pagar.

4. Webhooks para sincronizar el estado

Stripe te notifica los eventos importantes (pago exitoso, suscripción cancelada, impago) mediante webhooks. Debes verificar la firma con tu secret, actualizar tu base de datos y gestionar los accesos del usuario según el estado de su suscripción.

5. Portal del cliente

Stripe ofrece un Customer Portal listo para usar donde el usuario puede ver sus facturas, cambiar de plan o cancelar la suscripción. Lo activas con una línea y te ahorra construir ese UI desde cero.

Consideraciones RGPD

Stripe trata datos personales como encargado del tratamiento. Necesitas firmar su DPA, informar al usuario en tu política de privacidad y asegurarte de que tu SaaS cumple el RGPD al completo.

Si prefieres delegar la implementación, consulta nuestro servicio de desarrollo SaaS a medida.