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.
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.
3. Crear cuenta y obtener credenciales
Todos los enlaces oficiales que necesitarás para configurar Stripe correctamente.
1Crear una cuenta en Stripe
Si aún no tienes cuenta, regístrate gratis. Stripe te permite usar el entorno de pruebas sin verificar tu identidad al inicio.
Crear cuenta en Stripe2Obtener las claves de conexión
En el panel de Stripe, ve a Developers → API keys. Necesitarás dos claves:
- Publishable key (empieza por
pk_...): se usa para conectar con el frontend. - Secret key (empieza por
sk_...): se usa solo en el servidor de tu tienda.
Usa las claves de Prueba (Test) mientras configuras todo (activa el interruptor Test data en la parte superior del panel de Stripe). No uses las claves Reales (Live) hasta estar completamente seguro de que todo funciona.
3Preparar la conexión segura (Webhook)
El webhook es la forma en que Stripe le avisa a tu tienda que un pago fue exitoso de forma segura. Lo configurarás en el siguiente paso, pero necesitarás acceder a esta sección:
Abrir Webhooks4. 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_...opk_live_...) - Secret key (
sk_test_...osk_live_...)
3Copia la dirección del Webhook
La extensión te muestra una dirección similar a esta en un campo de solo lectura:
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 endpoint2Selecciona 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 exitososcheckout.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.completedycheckout.session.async_payment_failed - Copia su "Signing secret" (
whsec_...) — será distinto al de Test.
5. En tu OpenCart, pega:
pk_live_...→ Live Publishable Keysk_live_...→ Live Secret Keywhsec_...(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.
¿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.