DocsOpenCart
Integra Cost+ con tu tienda OpenCart (4.x y 3.x / ocStore 3)
Integra Cost+ como metodo de pago en tu tienda OpenCart. La extension oficial NoPayn Payment Gateway esta disponible para OpenCart 4 y OpenCart 3 / ocStore 3.
Requisitos previos
- Cuenta de comerciante Cost+ activa
- OpenCart 4.0.0.0 o posterior
- PHP 8.0 o posterior
- Acceso de administrador a tu panel de OpenCart
- Cuenta de comerciante Cost+ activa
- ocStore 3.0.x u OpenCart 3.0.3.x
- PHP 7.4 o posterior
- Acceso de administrador a tu panel de OpenCart
Metodos de pago soportados
- Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
- Apple Pay
- Google Pay
- Vipps / MobilePay
- Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
- Apple Pay
- Google Pay
- Vipps / MobilePay
- Swish
1. Instalar la extension
Metodo A: Subir via panel de administracion (recomendado)
- Descarga la ultima release
.ocmod.zipdesde GitHub - En tu admin de OpenCart, ve a Extensions → Installer
- Sube el archivo
.ocmod.zip - Ve a Extensions → Extensions → Payment
- Encuentra NoPayn Payment Gateway y haz clic en Install, luego Edit
Metodo B: Subida manual
- Descarga o clona el repositorio
- Copia el contenido de la carpeta
upload/en el directorio raiz de tu OpenCart - Ve a Extensions → Extensions → Payment
- Encuentra NoPayn Payment Gateway y haz clic en Install, luego Edit
Arquitectura
OpenCart 3 utiliza una configuracion multi-extension:
- NoPayn - Global Settings — configuracion compartida (clave API, estados de pedido, disponibilidad de metodos, captura manual, registro de depuracion)
- NoPayn - Card Payments — checkout con tarjeta de credito/debito
- NoPayn - Apple Pay / Google Pay — checkout con wallet (si solo un wallet esta habilitado, la etiqueta se ajusta automaticamente)
- NoPayn - Vipps MobilePay — checkout con Vipps/MobilePay
- NoPayn - Swish — checkout con Swish
Metodo A: Subir via panel de administracion (recomendado)
- Descarga el asset
.ocmod.zipde la ultima release en GitHub
Usa el asset .ocmod.zip de la release — no las descargas "Source code" auto-generadas por GitHub, que contienen la estructura del repositorio, no la estructura del instalador.
- En el admin, ve a Extensions → Installer
- Sube el archivo
.ocmod.zip - Ve a Extensions → Extensions → Payments
- Instala NoPayn - Global Settings primero
- Abre NoPayn - Global Settings y configura:
- Clave API
- Estados de pedido para completado, pendiente y cancelado
- Metodos de pago disponibles para los que tu cuenta de comerciante esta aprobada
- Opcional: captura manual de tarjeta
- Opcional: registro de depuracion
- Instala los modulos de checkout que deseas exponer:
- NoPayn - Card Payments
- NoPayn - Apple Pay / Google Pay
- NoPayn - Vipps MobilePay
- NoPayn - Swish
- Para cada modulo de checkout, establece: Status, Geo Zone y Sort Order
Metodo B: Subida manual
- Descarga o clona el repositorio
- Copia el contenido de la carpeta
upload/en la raiz de tu tienda - Ve a Extensions → Extensions → Payments
- Sigue el mismo orden de instalacion que el Metodo A (Global Settings primero, luego modulos de checkout)
2. Introducir las credenciales de la API
Inicia sesion en el portal de comerciante y navega a Websites, luego haz clic en el sitio web que deseas conectar. Haz clic en Integration donde encontraras tu clave API.
En los ajustes de NoPayn Payment Gateway, introduce tu API Key en el campo correspondiente.
En NoPayn - Global Settings, introduce tu API Key en el campo correspondiente. La clave API se comparte entre todos los modulos de checkout — solo necesitas introducirla una vez.
3. Configurar los ajustes de pago
- Habilita los metodos de pago para los que hayas sido aprobado
- Establece tus estados de pedido preferidos para pagos completados, pendientes y cancelados
- Opcionalmente restringe los pagos por Geo Zone
- Establece Status en Enabled
- Haz clic en Save
Configuracion global
NoPayn - Global Settings almacena toda la configuracion compartida:
| Ajuste | Descripcion |
|---|---|
| API Key | Tu clave API de NoPayn |
| Order Statuses | Mapeo de estados para completado, pendiente y cancelado |
| Method Availability | Metodos de pago para los que tu cuenta de comerciante esta aprobada |
| Manual Capture | Solo autorizar pagos con tarjeta de credito — capturar despues |
| Debug Logging | Habilitar registro detallado para solucion de problemas |
Ajustes de modulos de checkout
Cada modulo de checkout tiene sus propios ajustes de escaparate:
| Ajuste | Descripcion |
|---|---|
| Status | Habilitar o deshabilitar este metodo de pago en el checkout |
| Geo Zone | Restringir a zonas geograficas especificas |
| Sort Order | Orden de visualizacion en la pagina de checkout |
Solo activa los metodos de pago para los que hayas sido aprobado y hayas recibido confirmacion.
Flujo de pago
- El cliente selecciona un metodo de pago de Cost+ en el checkout
- El cliente es redirigido a la pagina de pago alojada de NoPayn
- Despues del pago, el cliente regresa y el estado del pedido se actualiza automaticamente
- NoPayn envia un webhook para confirmacion asincrona de estado
La extension utiliza la pagina de pago alojada de Cost+, lo que significa que los clientes son redirigidos a un formulario de pago seguro. Ningun dato sensible de tarjeta es manejado por tu servidor.
Cada modulo de checkout es una extension de pago separada de OpenCart, dando a los clientes opciones de radio distintas en el checkout (ej. "Card Payments", "Apple Pay & Google Pay").
- El cliente selecciona una etiqueta de metodo de pago en el checkout (ej. Card Payments)
- La extension crea un pedido de pago alojado de NoPayn
- El cliente es redirigido a la pagina de pago segura de NoPayn
- Despues del pago, el cliente regresa y el estado del pedido se actualiza automaticamente
- NoPayn envia un webhook para confirmacion asincrona de estado
El modulo de Apple Pay / Google Pay envia ambos metodos en una transaccion para que la pagina alojada de NoPayn pueda ofrecer ambas opciones de wallet en un solo flujo.
Actualizacion de v1.0.0 a v2.0.0
La version 1.0.0 usaba un unico metodo de checkout llamado "NoPayn Checkout". La version 2.0.0 cambia a modulos de checkout separados por metodo de pago. Al actualizar:
- Sube el nuevo paquete
- Tu entrada existente "NoPayn Checkout" se convierte en NoPayn - Global Settings
- Revisa y guarda los ajustes globales
- Instala y habilita los nuevos modulos de checkout que deseas que vean los clientes
4. Probar y lanzar
Realiza algunas transacciones de prueba para asegurarte de que todo funciona correctamente. Recomendamos probar tanto pagos exitosos como fallidos para confirmar que todos los escenarios se manejan adecuadamente.
Soporte
Necesitas ayuda? Contacta a nuestro equipo de soporte en support@costplus.io.