
Minilección · Español
Cómo aceptar un pago en tu sitio web
Crea un Payment Link de prueba, conéctalo a la página y verifica el pago en tu cuenta sin construir un servidor de pagos.
¿Para quién es esta lección?
Para quienes quieren un botón de pago. La vía básica usa pago alojado y asistente para el enlace; servidor, base y webhooks son ampliaciones avanzadas opcionales.
Antes de empezar
Tu Stripe apto con entorno de prueba y la página. El asistente configura el enlace público. No requiere Supabase, clave secreta en navegador ni servidor propio.
Tiempo estimado: 35–53 min
Estimaciones con los archivos iniciales y las cuentas y herramientas necesarias ya listas. La configuración, las colas de publicación y las esperas de correo o DNS requieren tiempo adicional. La elegibilidad, activación y apertura real del negocio quedan fuera del laboratorio. No se usan fondos ni datos de tarjeta reales.
Qué aprenderás
- Crea un enlace de pago claramente identificado como entorno de prueba.
- Conecta y prueba el botón de pago.
- Verifica estados reales pagado/cancelado en el proveedor, no en la página de retorno.
Paso 1
Elige una meta de pago de prueba
Empieza con pago alojado sin recoger tú los datos de tarjeta.
Usa tu Stripe de prueba y producto/precio ficticios. Abre la página y decide qué describirá el botón.
Mantén el ejercicio en prueba. Abrir una dirección de éxito no demuestra ningún pago.
Un ejemplo concreto
El producto podría ser «Sample digital workshop», con precio único de prueba USD 5. El botón debe indicar pago de prueba; ni página ni lección prometen entrega automática.
Usa la página pública para el ejercicio básico de Payment Link. Ayuda a crear producto/precio en mi Stripe de prueba y poner solo su URL pública de pago de prueba en la configuración. No instales base/webhook opcionales ni uses credenciales reales. Ayuda a publicar solo la página prevista y verificar un pago de prueba en Dashboard. El retorno no prueba pago.Stripe: crear un Payment Link · Stripe: pruebas
Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Inspect individual files (optional)
How it works (optional)
Acepta un pago de prueba con una página alojada
Empieza con una página de prueba del proveedor y un límite de éxito bien definido.
Un Payment Link alojado permite que el proveedor recoja los datos de pago sin campos de tarjeta en tu página. Esta práctica utiliza solo el entorno de prueba de Stripe y valores de tarjetas de prueba.
El sitio abre el pago, mientras el servidor recibe eventos firmados y registra un recibo. La página de vuelta es solo navegación: cualquiera puede abrir una URL, así que su presencia no demuestra un pago.
Ejemplo resuelto
Abrir success.html directamente no debe crear recibos. Una sesión pagada verificada del Payment Link de prueba configurado puede crear uno aunque el cliente nunca vuelva al sitio.
Stripe: después de pagar mediante Payment Link · Stripe: pruebas
Extra implementation exercise
Un usuario visita /success.html?paid=true. ¿Debe el sistema conceder un producto pagado?
Mostrar una solución desarrollada
No. El visitante controla el parámetro. Utiliza un evento verificado o una consulta del proveedor desde servidor vinculada a la transacción prevista.
- Rechaza URL controladas por quien llama como prueba de pago.
- Exige estado de pago verificado del proveedor.
Error habitual
Desbloquear una compra porque se abrió una página de éxito.
Paso 2
Crea y conecta el enlace de prueba
Usa el panel y deja editar al asistente.
Crea producto/precio de pago único y Payment Link en tu cuenta. Abre el pago público sin sesión y da la URL de prueba al asistente para conectarla.
Comprueba artículo, importe, divisa y entorno antes de continuar. Solo va la URL pública de prueba; no requiere firma privada ni clave API.
Un ejemplo concreto
La configuración correcta abre pago público sin sesión. Ajustes de cuenta Stripe o test_REPLACE intacto no son enlaces de pago utilizables.
Pruébalo
¿El botón abre el pago correcto de prueba con artículo y precio correctos?
Comenta tu respuesta con el tutor
Mostrar una solución desarrollada
Ejemplo: El enlace abre pago público de «Sample digital workshop», USD 5, sin iniciar mi cuenta Stripe. La página solo configura ese enlace; este recorrido básico no necesita clave API ni secreto webhook.
- Compara pago público sin sesión con producto, importe, divisa y modo de prueba.
- Configura solo el Payment Link público de prueba en la página.
Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Configura el pago separado de prueba
Distingue URL públicas de pago, credenciales de servidor y secretos webhook.
Sigue START-HERE.txt para crear Payment Link de prueba de pago único, tabla y destino webhook. Instala la dependencia Stripe fijada y conserva el archivo de bloqueo generado.
Pon solo la URL pública de prueba en config.js. El entorno del servidor incluye clave secreta de prueba, secreto de firma del endpoint, ID esperado de Payment Link y clave privada de base. Este código rechaza deliberadamente credenciales reales de producción.
Para la secuencia local completa, abre run-locally.txt: prepara el entorno privado de la raíz, vincula solo el proyecto de práctica e inicia el proxy de funciones de Netlify. server-env.example.txt enumera variables sin secretos reales. Abrir solo el HTML no ejecuta el servidor.
Ejemplo resuelto
El secreto de firma webhook determina los eventos de qué endpoint aceptas. No es el Payment Link público ni la clave API; copiar otro secreto produce fallo de firma.
Node.js: estado de soporte de versiones
Extra implementation exercise
¿Qué pertenece a public/config.js: la URL de prueba o el secreto de firma whsec?
Mostrar una solución desarrollada
Solo la URL pública. Conserva el secreto webhook y las claves secretas del proveedor y la base en variables del servidor.
- Mantiene los secretos de firma y API en el servidor.
- Utiliza solo el destino público de pago en el navegador.
Error habitual
Confundir el secreto del reenvío local con el del endpoint alojado.
Paso 3
Completa un pago de prueba
Usa instrucciones oficiales y examina el resultado de cuenta.
Sigue la guía de Stripe enlazada solo en prueba. Completa un pago desechable y encuentra su pago/sesión real en tu cuenta.
Verifica importe, divisa y pagado allí. Un recorrido completado puede diferir del estado final, sobre todo con métodos que se liquidan después.
Un ejemplo concreto
«Pago finalizado en pantalla» y «pago confirmado» no siempre son la misma observación.
Pruébalo
¿Qué indicó realmente el registro del proveedor?
Comenta tu respuesta con el tutor
Mostrar una solución desarrollada
Ejemplo del proveedor: el pago de prueba correspondiente aparece paid por USD 5, de acuerdo con el precio elegido. Si el proveedor indica processing o unpaid, registraría ese estado en lugar de declarar pagado el pedido solo porque terminó el recorrido de la pantalla.
- Encuentra pago correspondiente y paid real en el proveedor.
- Compara importe y divisa registrados con el precio elegido.
Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Inspect individual files (optional)
How it works (optional)
Verifica el evento y registra una sola vez el estado pagado
Autentica los datos originales antes de interpretar su JSON.
El controlador pasa los bytes originales intactos y Stripe-Signature al SDK oficial. Analizar o reformatear JSON antes puede modificar esos bytes y romper la verificación.
Acepta solo los tipos esperados, modo de prueba, payment_link coincidente y payment_status=paid. Algunos métodos completan el proceso antes de pagar, así que completar checkout no basta. Un session_id único hace inocua la inserción repetida.
Dos ID de evento distintos pueden describir la misma sesión: finalización y después éxito asíncrono. La clave primaria session_id, on_conflict=session_id y resolution=ignore-duplicates hacen repetible la inserción persistente. No se oculta un error de base: devuelve 503 para permitir reintentos.
Ejemplo resuelto
La misma sesión pagada entregada dos veces sigue teniendo una sola clave primaria. Un fallo de base devuelve 503 para reintentar, en vez de confirmar un evento cuyo resultado se perdió.
Stripe: verificar firmas webhook y reintentar
Extra implementation exercise
¿Por qué checkout.session.completed con payment_status=unpaid aún no puede tratarse como pedido pagado?
Mostrar una solución desarrollada
Algunos métodos confirman después. Espera un estado pagado verificado, incluido el evento asíncrono cuando corresponda, antes de guardar un recibo pagado.
- Distingue finalización del proceso de estado de pago confirmado.
- Espera la confirmación de pago adecuada.
Error habitual
Marcar pagado todo checkout completado sin importar payment_status.
Paso 4
Prueba cancelación y retorno directo
Comprueba que navegar no fabrique un resultado pagado.
Empieza otro pago de prueba y abandónalo sin completar, o usa una cancelación realmente ofrecida. Abre success.html por separado directamente y compara ambos con los registros del proveedor.
El abandono puede quedar incompleto o abierto, no necesariamente «canceled». Ninguna acción debe registrarse como nueva compra pagada. La página básica no entrega automáticamente.
Un ejemplo concreto
Abrir success.html o añadir paid=true no crea un pago paid en Stripe. Volver a la web y probar el pago son operaciones distintas.
Pruébalo
¿Qué demostraron cancelación y retorno directo y qué no?
Comenta tu respuesta con el tutor
Mostrar una solución desarrollada
En este ejemplo, el segundo checkout quedó incompleto sin otro pago paid. Abrir success.html mostró solo el mensaje de retorno. Ninguno prueba compra y la página no otorga acceso automático al producto.
- Distingue checkout cancelado o incompleto de pago paid correspondiente.
- Reconoce que el retorno directo no prueba pago ni concede entrega.
Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Inspect individual files (optional)
How it works (optional)
Sigue un pago de prueba de principio a fin
Relaciona sesión de pago, evento firmado y recibo guardado.
Utiliza solo tarjetas oficiales de prueba en el entorno de prueba. Encuentra la sesión y entrega webhook en tu cuenta y examina payment_receipts privada en el proyecto.
Verifica importe y moneda contra la sesión. Reenvía el mismo evento legítimo y confirma que sigue habiendo una fila. Prueba una solicitud sin firma y abrir directamente éxito; ninguno debe crear un pago.
Ejemplo resuelto
Un webhook 200 demuestra que el controlador confirmó algo. Comprueba recibo y sesión correspondientes en vez de suponer que todos los eventos pertenecen al producto previsto.
Extra implementation exercise
El webhook devuelve 200 para un evento ajeno. ¿Debe existir un recibo?
Mostrar una solución desarrollada
No. El controlador confirma eventos ignorados sin recibo. Solo una sesión pagada de prueba coincidente debe crear el registro previsto.
- Comprende los eventos ignorados intencionalmente.
- Relaciona el estado guardado con la sesión pagada concreta.
Error habitual
Esperar que cada webhook confirmado sea un pedido nuevo.
Paso 5
Entrega el recorrido básico de pago
Termina un enlace útil sin afirmar un sistema comercial completo.
Repite botón y pagos de prueba tras corregir. Guarda página/enlace y registro sin datos sensibles de éxito y cancelación o intentos incompletos.
Antes de vender de verdad, confirma empresa/cuenta aptas, precio/divisa, condiciones y operación. Acceso automático, eventos firmados y recuperación de base son material avanzado opcional de abajo.
Un ejemplo concreto
Un botón de pago alojado funcional es un resultado pequeño válido; no prueba que exista un servidor de entrega sin construir.
Pruébalo
Materiales para empezar
Los archivos y contenidos de prueba están incluidos. La verificación real requiere tu propia cuenta, buzón o dominio, según los requisitos. Puedes inspeccionar localmente; registra los pasos reales como no probados hasta ejecutarlos.
Entrega la vía y resultados reales de prueba y lo necesario antes del lanzamiento.
Qué debes entregar Tu enlace/página y observaciones reales de pago/cancelación de prueba; ningún cargo real.
Comenta tu respuesta con el tutor
Mostrar una solución desarrollada
Ejemplo de entrega: La página abre el taller USD 5; un test correspondiente está paid por USD 5; el intento abandonado no; abrir retorno directamente no cambia nada. No probé cobro real ni entrega automática. Para lanzamiento faltan cuenta apta, condiciones reales y proceso verificado de entrega.
- Entrega ruta pública de prueba con resultados pagado e incompleto/cancelado.
- Aclara que cobros reales y entrega automática quedan fuera del test básico.
Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Tu tarea: ensayar recuperación sin cobros reales
Un flujo de pago debe recuperarse de una escritura de base fallida.
En el proyecto desechable, utiliza temporalmente un ajuste de base inválido y reenvía tu evento pagado legítimo. Observa respuesta fallida y ningún recibo nuevo. Restaura y reenvía, y verifica exactamente una fila coincidente.
Explica lo que falta para vender realmente: cuenta y negocio admitidos, precio, moneda y condiciones exactos, entrega persistente del producto, conciliación, devoluciones y monitorización. Este taller solo registra recibos de prueba.
Ejemplo resuelto
Si falla el almacenamiento y el endpoint dice éxito, los reintentos automáticos pueden cesar antes de que exista el registro. Un fallo honesto forma parte de un pago fiable.
Encontrarás el desarrollo completo de referencia en reference/assignment-walkthrough.txt. Compara sus pasos con tu resultado; rellena el registro de pruebas con observaciones de tu propio proyecto.
Extra implementation exercise
Demuestra un intento fallido de almacenamiento y recuperación correcta sin duplicados.
Mostrar una solución desarrollada
Instala dependencias con npm install en el proyecto separado; genera package-lock.json, que debes conservar. Utiliza solo Payment Link de prueba y credenciales sk_test_. El enlace público no es el secreto de firma webhook.
Encuentra la sesión pagada coincidente, su webhook firmado y el recibo privado con mismo session_id, importe y moneda. Reenvía: la clave primaria y preferencia ignore-duplicates deben dejar un recibo. Una solicitud sin firma o visita directa a éxito no deben crear ninguno.
Para ensayar el fallo, cambia temporalmente SUPABASE_URL solo en el entorno local o servidor desechable a un destino inválido de prueba. Reenvía el evento legítimo y observa un fallo reintentable. Restaura, reenvía y verifica un recibo persistente. Nunca cambies producción ni pruebes con una tarjeta real.
- Un fallo de persistencia no confirma procesamiento correcto.
- La recuperación crea un recibo; no se usan fondos ni datos reales de pago.
Error habitual
Presentar un registrador de recibos como un sistema comercial completo de producción.
¿Te resultó útil esta lección?
Deja un me gusta o compártela con alguien a quien pueda servirle.
Sigue aprendiendo
- Cómo crear tu primer sitio web personal
- Cómo publicar tu sitio web desde GitHub
- Cómo conectar un dominio propio a tu sitio web
- Cómo configurar correo en tu propio dominio
- Cómo hacer que tu sitio web se pueda utilizar en teléfonos
- Cómo acelerar la carga de imágenes de tu sitio web
- Cómo recibir los comentarios de tu sitio web en tu bandeja de entrada
- Cómo añadir suscripciones por correo a tu sitio
- Cómo enviar correos automáticos desde tu sitio web
- Cómo guardar envíos de formularios en una base de datos
- Cómo permitir que las personas inicien sesión en tu sitio web
- Cómo mantener privada una página
- Cómo permitir que los usuarios editen su perfil
- Cómo permitir que los usuarios suban imágenes
- Cómo mantener las claves de API fuera del frontend
- Cómo mostrar datos de una API externa en tu sitio web
- Cómo añadir un chatbot de IA a tu sitio web
- Cómo hacer que un chatbot responda desde tu contenido
- Cómo añadir un blog a tu sitio web
- Cómo añadir búsqueda a tu sitio web
- Cómo añadir otro idioma a tu sitio web
- Cómo ayudar a Google a encontrar tu sitio web
- Cómo corregir la vista previa de tu sitio al compartir un enlace
- Cómo medir visitas y acciones útiles en tu sitio web
- Cómo permitir que los visitantes reserven una cita
- Cómo previsualizar cambios de tu sitio antes de publicarlos
- Cómo revertir un despliegue defectuoso de tu sitio web
- Cómo hacer copias de seguridad y restaurar los datos de tu sitio
- Cómo encontrar y corregir errores en tu sitio publicado