Vender por Internet
Manual técnico · OpenCart 4.1.0.4

Manual de la extensión Stripe Checkout para OpenCart 4.1.0.4

Striper — Pasarela de pago con Stripe para OpenCart 4.1.0.4, utilizando Stripe Checkout Sessions para ofrecer la experiencia de pago más segura y moderna del mercado.

Máxima seguridad: los datos de la tarjeta nunca pasan por tu servidor. El cliente es redirigido a la página de pago oficial y protegida por Stripe.

+1 (472) 274-2358Lun–Vie 9:00 – 18:00

Qué hace

Añade Credit Card (Stripe) en el checkout

Redirige a Checkout Session de Stripe

Confirma pedidos solo por conexión segura

Modo Prueba y Modo Real independientes

Nunca procesa tarjetas en tu servidor

1. Requisitos del sistema

Antes de empezar, verifica que tu entorno cumple con estos requisitos.

OpenCart 4.1.0.4

Versión específica compatible con esta extensión.

PHP + cURL

Necesario para las conexiones seguras con Stripe.

Certificado SSL (HTTPS)

Obligatorio en tu tienda para recibir las confirmaciones de pago de forma segura.

Cuenta de Stripe

Puedes crearla gratis y empezar a probar sin verificar tu identidad al inicio.

2. Instalación paso a paso

Sigue estos 3 pasos exactamente en el orden indicado. No se utiliza FTP para esta instalación.

1Subir el archivo .ocmod.zip

En el panel de administración, ve a Extensiones → Instalador. Haz clic en el botón de subir y selecciona el archivo striper.ocmod.zip.

El archivo debe llamarse exactamente así (terminado en .ocmod.zip). Si tu navegador le añadió algo como (1) al descargarlo, renómbralo antes de subirlo.

2Instalar la extensión

Ve a Extensiones → Extensiones, filtra por tipo Pagos (Payments), busca Striper (Stripe Checkout) y haz clic en el botón verde de instalar (+).

3Abrir la configuración

Haz clic en el icono de editar (lápiz) junto a Striper para abrir la pantalla de configuración. Desde aquí obtendrás la dirección de conexión y configurarás las claves.

4. Configuración completa

Pega las credenciales obtenidas en el panel de administración de OpenCart.

1Selecciona el modo

Mode: elige entre Test (pruebas) o Live (cobros reales). Asegúrate de usar las claves correspondientes a cada modo.

2Pega las claves de conexión

Pega ambas claves en los campos correspondientes:

  • Publishable key (pk_test_... o pk_live_...)
  • Secret key (sk_test_... o sk_live_...)

3Copia la dirección del Webhook

La extensión te muestra una dirección similar a esta en un campo de solo lectura:

https://tu-tienda.com/index.php?route=extension/striper/payment/striper.webhook

Importante: Usa el botón Copy que aparece junto al campo. No la escribas a mano, ya que el nombre de la extensión es striper (no stripe) para evitar conflictos con otros módulos.

4Estado de pedido y activación

Elige el estado de pedido que se aplicará cuando Stripe confirme el pago (recomendado: Processing o Completed). Luego activa (Enable) la extensión y guarda.

5. Configurar la conexión segura (Webhook)

El webhook es obligatorio: sin él, la extensión no puede confirmar los pagos de forma segura.

1Añadir la dirección en Stripe

En el panel de Stripe, ve a Developers → Webhooks → Add endpoint y pega exactamente la dirección que copiaste con el botón Copy en el paso anterior.

Añadir nuevo endpoint

2Selecciona los eventos

Marca al menos estos dos eventos para que la tienda sepa cuándo un pago fue exitoso o fallido:

  • checkout.session.completed — confirma pagos exitosos
  • checkout.session.async_payment_failed — registra pagos fallidos

3Obtén y copia el Signing Secret

Una vez creado el webhook, Stripe te mostrará un Signing secret que empieza por whsec_.... Haz clic en Reveal, cópialo y pégalo en el campo correspondiente (Test o Live) de la extensión en OpenCart.

El Signing secret es lo que permite verificar que el aviso viene realmente de Stripe. Sin él, no se aceptarán pagos.

¿Ves un error "400 Bad Request" al pegar la URL en tu navegador? ¡Es una buena noticia! Significa que la seguridad está funcionando correctamente. Esa dirección está diseñada para aceptar solo conexiones seguras y firmadas directamente desde Stripe, no visitas normales de navegador.

6. Prueba en Test y paso a Live (Guía a prueba de fallos)

Antes de pasar a Live, te recomiendo probar primero en modo Test para confirmar que todo el flujo funciona (pago, webhook, cambio de estado del pedido). Así evitamos sorpresas con dinero real.

Cómo probar ahora mismo en modo Test

1. En tu admin, la extensión Striper debe tener Mode = Test y las claves pk_test_... / sk_test_... ya puestas.

2. Ve a tu tienda, añade un producto al carrito y haz checkout eligiendo Stripe como pago.

3. Te redirige a la página de Stripe. Usa estos datos de prueba:

  • Tarjeta: 4242 4242 4242 4242
  • Fecha: cualquier fecha futura (ej. 12/28)
  • CVC: cualquier 3 dígitos (ej. 123)
  • Código postal: cualquiera

4. Completa el pago → deberías volver a tu tienda (página de "Pedido confirmado").

5. Paso crucial: En el admin, ve a Ventas → Pedidos, abre ese pedido y comprueba que su estado cambió al que configuraste. Esto confirma que el webhook funcionó, no solo el redirect.

¡Listo! Si ese último paso funciona, el 100% del flujo está probado y puedes pasar a Live con confianza.

Cómo conseguir las claves Live y activar

1. En el Dashboard de Stripe, arriba a la derecha hay un interruptor "Test mode" — desactívalo (pásalo a modo real/Live).

2. Si tu cuenta de Stripe aún no está activada del todo (verificación de negocio, datos bancarios, etc.), Stripe te pedirá completar ese proceso antes de darte claves Live funcionales. Es un paso de Stripe, no de la extensión.

3. Con el interruptor en Live, ve otra vez a Developers → API keys. Ahí verás tus claves Live:

  • Publishable key: pk_live_...
  • Secret key: sk_live_... (clic en "Reveal live key" para verla)

4. Importante: El webhook Live es independiente del de Test. Con el interruptor en Live, ve a Developers → Webhooks → Add endpoint otra vez (sí, hay que crear uno nuevo, Stripe no comparte webhooks entre Test y Live) y repite exactamente lo mismo que hiciste para Test:

  • Misma URL: https://tu-tienda.com/index.php?route=extension/striper/payment/striper.webhook
  • Mismos eventos: checkout.session.completed y checkout.session.async_payment_failed
  • Copia su "Signing secret" (whsec_...) — será distinto al de Test.

5. En tu OpenCart, pega:

  • pk_live_... → Live Publishable Key
  • sk_live_... → Live Secret Key
  • whsec_... (el del webhook Live) → Live Webhook Signing Secret

6. Cambia Mode de "Test" a "Live" y guarda.

Advertencia: A partir de ese guardado, cualquier pago será real y cobrará dinero de verdad. Te recomiendo hacer una primera compra real tú mismo por un importe pequeño (ej. 1.00) para confirmar que todo llega bien a tu cuenta bancaria antes de anunciarlo a clientes.

7. Seguridad y buenas prácticas

Decisiones técnicas que mantienen tu tienda y los datos de tus clientes seguros.

Nunca se procesan tarjetas en tu servidor

El cliente es redirigido a la página de pago oficial de Stripe. Tu servidor nunca ve ni manipula números de tarjeta.

Conexión con firma verificada

El pedido solo se confirma cuando Stripe envía un aviso firmado. Nunca se confía en el simple regreso del navegador del cliente.

Importe recalculado en servidor

El importe cobrado se recalcula siempre desde el pedido guardado en tu base de datos; nunca se confía en datos modificados desde el navegador.

Claves nunca al navegador

Las claves secretas y el código de verificación nunca se envían al frontend. Se guardan cifrados en la base de datos.

Reembolsos y disputas: no se gestionan automáticamente desde la extensión. Debes hacerlo directamente desde el Panel de Stripe.

Preguntas frecuentes
Dudas comunes sobre la extensión Striper (Stripe Checkout) para OpenCart 4.1.0.4.
¡Es una buena noticia! Significa que la seguridad está funcionando correctamente. Esa dirección está diseñada para aceptar solo conexiones seguras y firmadas directamente desde Stripe, no visitas normales de navegador. Si te diera un error 404, ahí sí habría un problema; con 400 confirmamos que la ruta existe y está protegida.
El Signing Secret lo genera Stripe, no tu tienda, y solo cuando creas el webhook desde el Panel de Stripe. Ve a Developers > Webhooks > Add endpoint, pega tu URL, selecciona los eventos requeridos y, una vez creado, haz clic en "Reveal" junto a "Signing secret" para copiarlo y pegarlo en OpenCart.
Sí, es obligatorio. Sin webhook, la extensión no puede confirmar los pagos de forma segura. La extensión nunca confía en el simple regreso del navegador del cliente para confirmar un pedido, porque esa información puede ser manipulada. Solo un aviso con firma verificada garantiza que el pago proviene realmente de Stripe.
Sí. Stripe ofrece un modo Test con credenciales independientes. En el Panel de Stripe activa el interruptor "Test data" en la cabecera. Usa la tarjeta de prueba oficial de Stripe (4242 4242 4242 4242) con cualquier fecha futura y CVC para simular pagos exitosos sin mover dinero real.
No. El cliente es redirigido a la página de pago alojada por Stripe (Stripe Checkout). Tu servidor nunca ve ni manipula números de tarjeta, CVV ni datos sensibles. Esto reduce significativamente el alcance de cumplimiento de seguridad (PCI-DSS) de tu tienda.
Cuando estés listo, ve a la configuración de la extensión, cambia el "Mode" a Live, pega tus claves Live (pk_live_... y sk_live_...) y crea un nuevo webhook en el Panel de Stripe (asegurándote de que el interruptor "Test data" esté desactivado) para obtener un nuevo Signing Secret de producción.

¿Necesitas ayuda configurando Stripe?

Si tienes dudas específicas sobre esta extensión o necesitas que configuremos la pasarela de pago en tu tienda OpenCart, escríbenos. Te ayudamos a tener todo funcionando correctamente.

+1 (472) 274-2358Lun–Vie 9:00 – 18:00
Desarrollo Web Profesional | Tiendas Online, Ecommerce y Soluciones Digitales