Pagos con Stripe en LaunchFast Starter Kits: checkout y…

Pagos con Stripe en LaunchFast Starter Kits: checkout y webhooks incluidos

4 min de lectura
Rishi Raj JainRishi Raj JainAutor

Los pagos con Stripe vienen integrados en cada LaunchFast starter kit, para Astro, Next.js y SvelteKit. Los kits incluyen una ruta de checkout que crea una sesión de Stripe Checkout y una ruta de webhook que da acceso al cliente cuando ha pagado, así que puedes empezar a cobrar con solo dos variables de entorno.

LaunchFastEmpieza a lanzar tu producto.$99

¿Qué es Stripe?

Stripe es una plataforma de pagos para aceptar tarjetas, billeteras y pagos bancarios en línea. A diferencia de un merchant of record, Stripe procesa los pagos por ti mientras tú sigues siendo el vendedor, lo que te da control total sobre precios, descuentos y la experiencia de checkout.

Por qué es una buena opción por defecto para un nuevo SaaS:

  • Stripe Checkout: Una página de pago alojada y lista para móviles, así nunca manejas datos de tarjetas tú mismo.
  • Cobros únicos y recurrentes: Vende licencias de por vida o suscripciones desde la misma ruta de checkout.
  • Modo de prueba: Recorre todo el flujo con tarjetas de prueba y webhooks reenviados antes de cobrar dinero real.

Comenzando con Stripe

  1. Elige tu framework: Astro, Next.js o SvelteKit
  2. Crea un producto: Regístrate en Stripe y añade un producto
  3. Copia tu clave: Copia tu clave secreta desde Developers > API keys
  4. Añade el webhook: Apunta un webhook a https://<your-domain>/api/stripe/webhook que escuche checkout.session.completed y payment_intent.succeeded, y copia su signing secret
  5. Lanza: Coloca el botón de checkout en tu página de precios y empieza a aceptar pagos

Añadir un checkout a cualquier página requiere un solo componente. Así se ve en el Astro starter kit:

---
import ButtonCheckout from '@/components/Buttons/Checkout.astro'
---
<ButtonCheckout brand_name="ACME" />

Al hacer clic en el botón se llama a la ruta /api/stripe/checkout, que crea una sesión de Stripe Checkout y redirige al usuario. Para cambiar el producto, el precio, los descuentos o los campos personalizados del checkout, edita la llamada a stripe.checkout.sessions.create en esa ruta. Los starter kits de Next.js y SvelteKit incluyen las mismas rutas de checkout y webhook, escritas en el formato de rutas de cada framework.

Gestión de webhooks

Cuando un pago se completa, Stripe llama a tu ruta de webhook. El starter kit verifica la firma contra el cuerpo original de la petición, lee el correo del cliente y le da acceso en tu base de datos:

src/pages/api/stripe/webhook.ts
// Obtain the raw body of the request to be used in Stripe for verification
const rawBody = await request.text()
const event = stripe.webhooks.constructEvent(rawBody, sig, `${getSecret('STRIPE_WEBHOOK_SIG')}`)
// Two events in Stripe point to succesful payment
if (event.type === 'checkout.session.completed' || event.type === 'payment_intent.succeeded') {
const customerEmail = event.type === 'checkout.session.completed' ? event.data.object.customer_details?.email : event.data.object.receipt_email
if (customerEmail) {
// Add the 'email' to the access list in the database
await setAccess(customerEmail, '1')
return webResponse('approved user access', 200)
}
}

A partir de aquí puedes reutilizar los helpers que ya trae el starter kit, como sendEmail para enviar un recibo, o guardar el pedido en tu base de datos.

Configuración

Añade estos valores a tu archivo .env:

Terminal window
## Stripe Environment Variables
STRIPE_SECRET_KEY="sk_live_..."
STRIPE_WEBHOOK_SIG="whsec_..."

El starter kit lee ambos como secretos del lado del servidor, así que tu clave secreta nunca llega al navegador.

Pruebas

En el modo de prueba de Stripe, paga con la tarjeta 4242 4242 4242 4242, cualquier fecha de caducidad futura y cualquier CVC. Para recibir webhooks en tu máquina local, reenvíalos con la Stripe CLI:

Terminal window
stripe listen --forward-to localhost:3000/api/stripe/webhook

El modo de prueba y el modo real usan claves y secretos de webhook distintos, así que cambia ambos cuando salgas a producción.

Qué está incluido

Cada LaunchFast starter kit con soporte para Stripe incluye:

  • ✅ Botón de checkout: Un componente listo para usar que envía a los clientes a Stripe Checkout
  • ✅ Ruta de checkout: Crea una sesión de Stripe Checkout y redirige a los usuarios
  • ✅ Ruta de webhook: Verificación de firma y acceso de pago mediante setAccess
  • ✅ Seguridad de tipos: Soporte completo de TypeScript con el SDK oficial stripe

Precios

El soporte para Stripe está incluido en todos nuestros starter kits sin coste adicional:

Otros proveedores de pago

¿Prefieres un merchant of record que gestione los impuestos de venta por ti? Stripe convive con estos proveedores y puedes cambiar sin reescribir tu flujo de compra:

Comienza hoy

¿Listo para empezar a cobrar con Stripe?

Lee la guía de Stripe, luego consigue el LaunchFast Starter Kit y empieza a vender.

Preguntar a la IAChatGPTClaudePerplexityGrok

Sigue leyendo

Deja de reconstruir auth y pagos. Empieza a lanzar tu producto.