LeccionesCómo aceptar un pago en tu sitio web

Minilección 26 de 30 · Operar y mantener tu sitio web

Elige una meta de pago de prueba

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

Empieza con pago alojado sin recoger tú los datos de tarjeta.

Propósito de esta lección

  • 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.
Explicación, ejemplo resuelto y práctica

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.

Comprueba tus habilidades iniciales

Son habilidades útiles, no cursos obligatorios bloqueados. Si ya las tienes, empieza aquí; si no, abre la preparación. Los archivos incluidos evitan necesitar un sitio personal previo.

  1. Cómo publicar tu sitio web desde GitHub

    Conecta un repositorio de práctica al alojamiento.

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.

Comprende la idea

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.

Archivos de este paso

Empieza aquíArchivos del taller

Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

Examinar los archivos por separado (opcional)

Pruébalo

¿Qué artículo y precio describirá el botón y dónde verificarás?

Mostrar una solución desarrollada

Mi producto ilustrativo es «Sample digital workshop», USD 5 en Stripe de pruebas. El botón abre su pago alojado. Revisaría paid, importe y divisa correspondientes en mi cuenta; visitar success.html no demostraría pago.

Qué incluye una respuesta adecuada

  • Nombra producto ficticio, importe y divisa de prueba.
  • Identifica el registro del proveedor para verificar pago.
Cómo funciona (opcional)

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

Ejercicio técnico adicional

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 1 · Cómo aceptar un pago en tu sitio web

Crea y conecta el enlace de prueba

Usa el panel y deja editar al asistente.

Explicación, ejemplo resuelto y práctica

Comprende la idea

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.

Archivos de este paso

Empieza aquíArchivos del taller

Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

Examinar los archivos por separado (opcional)

Pruébalo

¿El botón abre el pago correcto de prueba con artículo y precio correctos?

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.

Qué incluye una respuesta adecuada

  • 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.
Cómo funciona (opcional)

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

Ejercicio técnico adicional

¿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 2 · Cómo aceptar un pago en tu sitio web

Completa un pago de prueba

Usa instrucciones oficiales y examina el resultado de cuenta.

Explicación, ejemplo resuelto y práctica

Comprende la idea

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.

Archivos de este paso

Empieza aquíArchivos del taller

Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

    Examinar los archivos por separado (opcional)

    Pruébalo

    ¿Qué indicó realmente el registro del proveedor?

    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.

    Qué incluye una respuesta adecuada

    • Encuentra pago correspondiente y paid real en el proveedor.
    • Compara importe y divisa registrados con el precio elegido.
    Cómo funciona (opcional)

    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

    Ejercicio técnico adicional

    ¿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 3 · Cómo aceptar un pago en tu sitio web

    Prueba cancelación y retorno directo

    Comprueba que navegar no fabrique un resultado pagado.

    Explicación, ejemplo resuelto y práctica

    Comprende la idea

    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

    Empieza aquíArchivos del taller

    Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

      Examinar los archivos por separado (opcional)

      Pruébalo

      ¿Qué demostraron cancelación y retorno directo y qué no?

      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.

      Qué incluye una respuesta adecuada

      • Distingue checkout cancelado o incompleto de pago paid correspondiente.
      • Reconoce que el retorno directo no prueba pago ni concede entrega.
      Cómo funciona (opcional)

      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.

      Ejercicio técnico adicional

      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 4 · Cómo aceptar un pago en tu sitio web

      Entrega el recorrido básico de pago

      Termina un enlace útil sin afirmar un sistema comercial completo.

      Explicación, ejemplo resuelto y práctica

      Comprende la idea

      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

      Empieza aquíArchivos del taller

      Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

      Examinar los archivos por separado (opcional)

      Pruébalo

      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.

      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.

      Qué incluye una respuesta adecuada

      • 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.
      Cómo funciona (opcional)

      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.

      Ejercicio técnico adicional

      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.