GuíasE-commerce

Tutorial: integrar el pago con Stripe Checkout en una web app

Por el equipo de Banzai LabsActualizado el 2 min de lectura

PagarStripe CheckoutVueltawebhookEl pedido lo valida el webhook, no la página de vuelta
El cliente paga en la página de Stripe; el pedido lo confirma el webhook.

1. Crear la sesión (servidor)

import Stripe from 'stripe';
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);

export async function POST() {
  const session = await stripe.checkout.sessions.create({
    mode: 'payment',
    line_items: [{ price: 'price_123', quantity: 1 }],
    success_url: 'https://ejemplo.es/gracias?session_id={CHECKOUT_SESSION_ID}',
    cancel_url: 'https://ejemplo.es/carrito',
  });
  return Response.redirect(session.url!, 303);
}

El precio price_123 se crea en el panel de Stripe o por la API: el importe nunca viene del navegador.

2. El recorrido

  1. 1Clic en PagarEl navegador llama a tu servidor.
  2. 2Sesión creadaTu servidor redirige a la página de Stripe.
  3. 3PagoEn Stripe: tarjeta, Apple Pay, Google Pay, 3-D Secure.
  4. 4Webhookcheckout.session.completed valida el pedido.

3. La página de retorno

Da las gracias y muestra el resumen releyendo la sesión (session_id). No crea nada: eso le toca al webhook.

4. Suscripciones

El mismo código con mode: 'subscription' y un precio recurrente. El portal de cliente de Stripe gestiona después tarjeta, facturas y bajas.

El paso imprescindible: webhooks de Stripe fiables. El principio: qué es un webhook.

Preguntas frecuentes

¿Checkout o formulario integrado?
Checkout se pone en marcha en un día y gestiona tarjetas, monederos y 3-D Secure. Un formulario integrado (Payment Element) da más libertad de diseño, a cambio de más trabajo.
¿Por qué no validar el pedido en la página de retorno?
El cliente puede cerrar la pestaña antes de llegar. El webhook siempre llega, y Stripe lo reenvía si falla.
¿Cómo probar sin pagar?
En modo de prueba, con las claves de prueba y los números de tarjeta de prueba que da Stripe.

Para leer después

Todas las guías