osCommerce

Integra Cost+ como metodo de pago en tu tienda osCommerce 4. El modulo oficial NoPayn Payments utiliza el flujo de pagina de pago alojada, de modo que ningun dato de tarjeta toca tu servidor — totalmente compatible con PCI DSS.

Requisitos previos

Cuenta de comerciante Cost+ activa
osCommerce 4.x
PHP 8.1 o posterior
Extension cURL habilitada
Certificado SSL (HTTPS obligatorio)
Acceso de administrador a tu panel de administracion de osCommerce

Metodos de pago soportados

Etiqueta en checkout	Identificador NoPayn
Credit / Debit Card	`credit-card`
Apple Pay	`apple-pay`
Google Pay	`google-pay`
Vipps MobilePay	`vipps-mobilepay`

Cada metodo puede habilitarse o deshabilitarse individualmente desde el panel de administracion.

1. Instalar el modulo

Descarga o clona el modulo desde GitHub.

Copia el directorio lib/ en la raiz de tu osCommerce 4:

cp -r lib/ /path/to/oscommerce/

Esto coloca los archivos del modulo en:

lib/common/modules/orderPayment/nopayn.php
lib/common/modules/orderPayment/nopayn/NoPaynApiClient.php
lib/common/modules/orderPayment/nopayn/NoPaynLogger.php
lib/common/modules/orderPayment/nopayn/NoPaynWebhookHandler.php

En tu panel de administracion de osCommerce:

Navega a Modules → Payment → Online
Habilita los filtros "Show inactive" y "Show not installed" si es necesario
Encuentra NoPayn Payments y haz clic en Install

2. Configurar el modulo

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.

Portal de comerciante de Cost+ mostrando la clave API

Introduce tu API Key y configura los siguientes ajustes:

Ajuste	Descripcion	Predeterminado
Enable NoPayn Payments	Interruptor principal de habilitacion/deshabilitacion	True
API Key	Tu clave API de NoPayn	—
Enable Credit / Debit Card	Mostrar tarjeta de credito/debito en el checkout	True
Enable Apple Pay	Mostrar Apple Pay en el checkout	True
Enable Google Pay	Mostrar Google Pay en el checkout	True
Enable Vipps MobilePay	Mostrar Vipps MobilePay en el checkout	True
Manual Capture (Credit Card)	Solo autorizar — capturar cuando el pedido se complete	False
Debug Logging	Escribir solicitudes/respuestas de API en el log	False
Completed Order Status	Estado establecido cuando el pago tiene exito	Processing
Pending Order Status	Estado establecido mientras se espera el pago	Pending
Cancelled Order Status	Estado establecido en cancelacion/fallo/expiracion	Cancelled
Payment Zone	Restringir a una zona geografica (opcional)	All zones
Sort Order	Orden de visualizacion en la pagina de checkout	0

Solo activa los metodos de pago para los que hayas sido aprobado y hayas recibido confirmacion.

3. Actualizar etiquetas del checkout (recomendado)

Las etiquetas predeterminadas de los botones del checkout de osCommerce asumen un flujo de un solo paso. Para una mejor experiencia con la redireccion a pago externo, actualiza estas traducciones en Admin → Localisation → Languages → English → Define:

Clave	Predeterminado	Recomendado
`TEXT_PAY_WITH_CARD`	Pay with card	Go to payment
`TEXT_CONFIRM_AND_PAY`	Confirm and pay	Review order
`CONFIRM_ORDER`	Confirm order	Confirm and pay

Esto mejora la experiencia del cliente al hacer el flujo de checkout mas claro — los clientes entienden que seran redirigidos para completar el pago en una pagina segura.

4. Flujo de pago

Una vez configurado, el flujo de pago funciona de la siguiente manera:

El cliente selecciona un metodo de pago de Cost+ en el checkout
El cliente confirma el pedido
El modulo crea un pedido pendiente y llama a la API de Cost+
El cliente es redirigido a la pagina de pago alojada de Cost+ (HPP)
El cliente completa el pago en el HPP seguro
El cliente es redirigido de vuelta a la tienda
El modulo verifica el estado del pago a traves de la API de Cost+
El estado del pedido se actualiza en consecuencia

Los enlaces de pago expiran despues de 5 minutos. Si el cliente no completa el pago dentro de este periodo, el pedido se marca automaticamente como cancelado.

5. Webhooks

El modulo registra una URL de webhook con Cost+ para actualizaciones de estado servidor a servidor. Cuando cambia el estado de un pago, Cost+ envia una notificacion y el modulo:

Recibe el POST del webhook
Verifica el estado del pago via API (nunca confia en el payload del webhook)
Actualiza el estado del pedido en osCommerce

No se requiere configuracion manual de webhooks — el modulo gestiona el registro automaticamente.

Captura manual

Cuando esta habilitada para pagos con tarjeta de credito:

El pago es autorizado pero no capturado en el checkout
Los fondos se capturan cuando el pedido transiciona a estado completed
Si el pedido se cancela, la autorizacion se anula automaticamente

Usa la captura manual si deseas cobrar a los clientes solo cuando se envie su pedido. Esto es util para comerciantes con tiempos de cumplimiento mas largos.

Registro de depuracion

Cuando Debug Logging esta habilitado, el modulo escribe en nopayn_debug.log en el directorio de logs de osCommerce. Las entradas del log incluyen:

Todas las solicitudes y respuestas de la API
Eventos de webhook y resultados de procesamiento
Operaciones de captura y anulacion
Errores (siempre registrados, independientemente del toggle de depuracion)

Todas las entradas llevan el prefijo NoPayn_ para facilitar el filtrado.

Desinstalacion

Ve a Modules → Payment → Online en el panel de administracion
Selecciona NoPayn Payments
Haz clic en Remove

Desinstalar el modulo elimina la configuracion y elimina las tablas de base de datos nopayn_transactions y nopayn_refunds. Asegurate de exportar cualquier dato que necesites antes de desinstalar.

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.

On this page