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.

Comenzar la lección interactivaLeer los apuntes

¿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.

Archivos del taller

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

Start hereArchivos del taller

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.

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.

Stripe: crear un Payment Link

Archivos de este paso

Start hereArchivos del taller

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)

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.

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.

Stripe: pruebas

Archivos de este paso

Start hereArchivos del taller

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.

    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.

    Archivos de este paso

    Start hereArchivos del taller

    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.

      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.

      Archivos de este paso

      Start hereArchivos del taller

      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)

      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.

      ¿Te resultó útil esta lección?

      Deja un me gusta o compártela con alguien a quien pueda servirle.

      Sigue aprendiendo

      Explora las otras lecciones