GuíasE-commerce
Tutorial: integrar el pago con Stripe Checkout en una web app
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
- 1Clic en PagarEl navegador llama a tu servidor.
- 2Sesión creadaTu servidor redirige a la página de Stripe.
- 3PagoEn Stripe: tarjeta, Apple Pay, Google Pay, 3-D Secure.
- 4Webhook
checkout.session.completedvalida 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.