Magento

• Cuenta de comerciante Cost+ activa
• Instalacion de Magento 2.4.6 – 2.4.8
• PHP 8.2 – 8.4
• Acceso de administrador a tu panel de administracion de Magento
• Acceso SSH a tu servidor (para instalacion via Composer)

• Cuenta de comerciante Cost+ activa
• Magento 1.9.x u OpenMage LTS 20+
• PHP 7.4 o posterior
• Acceso de administrador a tu panel de administracion de Magento
• Acceso SSH o FTP a tu servidor

Metodo A: Instalacion via Composer (recomendado)

Conectate a tu servidor Magento via SSH y navega al directorio raiz de Magento.

Instala el plugin:

composer require nopayn/nopayn-magento-2

Ejecuta los comandos de configuracion de Magento:

php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:clean

Si estas en modo produccion, ejecuta tambien:

php bin/magento setup:static-content:deploy

Metodo B: Instalacion manual

1. Navega a tu directorio app/code
2. Descarga y descomprime la release de Cost+ desde GitHub
3. Ejecuta los comandos de configuracion:

php bin/magento setup:upgrade
php bin/magento cache:clean

Si estas en modo produccion:

php bin/magento setup:static-content:deploy

Descarga o clona el modulo desde GitHub.

Copia el contenido de app/ en el directorio app/ raiz de tu Magento:

cp -r app/* /path/to/magento/app/

Limpia la cache de Magento:

rm -rf var/cache/*

Inicia sesion en el panel de administracion de Magento y navega a System → Configuration → Sales → Payment Methods para verificar que aparece la seccion NoPayn Payment Gateway.

1. Ve a Stores → Configuration → Sales → Payment Methods → Cost+ Payments
2. Introduce tu clave API (ver paso 3 abajo)
3. Habilita los metodos de pago para los que hayas sido aprobado
4. Guarda los cambios

1. Ve a System → Configuration → Sales → Payment Methods
2. Localiza la seccion NoPayn Payment Gateway
3. Introduce tu clave API (ver paso 3 abajo)
4. Habilita los metodos de pago individuales (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
5. Opcionalmente restringe por pais
6. Guarda la configuracion

1. El cliente selecciona un metodo de pago en el checkout y realiza el pedido
2. El cliente es redirigido a la pagina de pago alojada de NoPayn
3. Despues del pago, el cliente regresa y el estado del pedido se actualiza automaticamente
4. NoPayn envia un webhook para confirmacion asincrona de estado

1. El cliente selecciona un metodo de pago en el checkout y realiza el pedido
2. El pedido se crea con estado Pending Payment
3. El cliente es redirigido a la pagina de pago segura de NoPayn
4. Despues del pago:
   • Exito — el cliente regresa, el estado se verifica via API, el pedido se establece como Processing
   • Cancelado — el cliente regresa, el pedido se establece como Canceled
   • Expirado (timeout de 5 minutos) — el webhook se activa, el pedido se establece como Canceled
5. NoPayn envia un webhook para confirmacion asincrona de estado

Mapeo de estados del pedido

Webhooks

El modulo registra un endpoint de webhook en /nopayn/payment/webhook. Esta URL se envia automaticamente a NoPayn al crear pedidos. El webhook siempre verifica el estado del pedido via la API de NoPayn antes de actualizar el pedido de Magento.