Magento 2
¿Qué es Magento?
Magento es una plataforma que permite la gestión de contenidos web para un comercio electrónico, ofreciendo una solución flexible y escalable sobre la cual se puede basar cualquier proyecto de tienda en línea.
El plugin de Openpay para Magento le permite configurar y añadir nuestros métodos de pago soportados (tarjeta de crédito/débito, tiendas de conveniencia y SPEI) dentro del flujo compra de su comercio electrónico.
Versiones soportadas
- Magento Open Source Edition (Magento Community) 2.1.1 en adelante.
- Magento Commerce Edition (Magento Enterprise)
- Magento Commerce Cloud Edition (Magento Cloud)
Requerimientos
Es necesario que el servidor donde se encuentre alojado su comercio electrónico basado en Magento 2 cuente con las siguientes características:
- Versión instalada de PHP 5.4 o mayor.
- Versión instalada de MySQL 5.0 o mayor.
- Contar con un certificado SSL para su comercio electrónico.
Instalación
- Ingresar desde la terminal de nuestro servidor a la carpeta raíz del proyecto de Magento
- Ingresar los siguientes comandos, los cuales descargarán las extensiones al proyecto y adicional a ello descargarán la librería de Openpay de PHP
- Módulo de pagos con tarjeta de crédito
composer require openpay/magento2-cards:3.1.*
- Módulo para pagos en efectivo
# Para versiones de Magento < 2.3.0 composer require openpay/magento2-stores:~3.0.0 # Para versiones de Magento >= 2.3.0 composer require openpay/magento2-stores:~3.4.0 # Para versiones de Magento >= 2.3.5 composer require openpay/magento2-stores:~4.0.0
- Módulo para pagos vía PSE
#Para versiones de Magento < 2.3.0 composer require openpay/magento2-banks:~3.0.0 # Para versiones de Magento >= 2.3.0 composer require openpay/magento2-banks:~3.4.0 # Para versiones de Magento >= 2.3.5 composer require openpay/magento2-banks:~4.0.0
- Módulo de pagos con tarjeta de crédito
- Después se procede a habilitar los módulos, actualizar y limpiar cache de la plataforma.
php bin/magento module:enable Openpay_Cards --clear-static-content php bin/magento module:enable Openpay_Stores --clear-static-content php bin/magento module:enable Openpay_Banks --clear-static-content php bin/magento setup:upgrade php bin/magento cache:clean
Configuración
- Identificar las credenciales de API asignadas a su comercio dentro del panel de administración de Openpay.

Para ver las credenciales, dar clic en el engrane del menú superior derecho y luego seleccionar la opción Credenciales de API
2. En su panel de administración de Magento 2, dirigirse a la sección Stores -> Configuration.

3. Una vez dentro de la pantalla de Configuración, ubicar en el menú lateral izquierdo Sales -> Payment Methods.

4. Configurar el apartado de Openpay
Configuración general
- Habilitado (Enabled).- Para habilitar el modo de pago.
- Sandbox.- Determina si el plugin va a funcionar en entorno de pruebas (Sandbox).
- Título (Title).- Nombre del método de pago que se mostrará en la tienda.
- Credenciales de Openpay (Merchant ID, Llave Secreta, Llave Pública).- Credenciales de API para utilizar el plugin (ya sea en modo Sandbox o Producción). Copiar y pegar cada dato (obtenido en el Paso 1) como corresponda.
- País.- Seleccionar el país donde se encuentra (Colombia, México).

Configuración pago con tarjeta
- Guardar tarjetas.- Permite a los usuarios registrados guardar sus tarjetas crédito/débito para agilizar sus futuras compras.
- Tipos de tarjetas (Credit card types).-Deberán de estar seleccionados los 3 tipos de tarjetas para aceptar todo tipo de tarjetas permitidas por Openpay.
- IVA.- Debe contener el valor de IVA, es campo solo informativo, no tiene ningún efecto sobre el campo amount.
- Cuotas.- Puede habilitar o deshabilitar pagos con cuotas seleccionando el número de cuotas disponibles.
- Configuración de países permitidos (Payment from applicable countries, payment from specific countries).- Puede dejarse con la configuración por default que tiene o bien puede definirse únicamente a Colombia.
- Orden (Sort order).- Orden en que se mostrará este método de pago.

Configuración pagos en tiendas
- Fecha límite para pago (Payment deadline).- Definir el número de horas que tendrá el cliente una vez emitido el recibo de pago para efectuar éste.
- IVA.- Debe contener el valor de IVA, es campo solo informativo, no tiene ningún efecto sobre el campo amount.
- Configuración de países permitidos (Payment from applicable countries, payment from specific countries).- Puede dejarse con la configuración por default que tiene o bien puede definirse únicamente a Colombia.
- Orden (Sort order).- Orden en que se mostrará este método de pago.

Configuración pago con PSE
- Configuración de países permitidos (Payment from applicable countries, payment from specific countries).- Puede dejarse con la configuración por default que tiene o bien puede definirse únicamente a Colombia.
- IVA.- Debe contener el valor de IVA, es campo solo informativo, no tiene ningún efecto sobre el campo amount.
- Orden (Sort order).- Orden en que se mostrará este método de pago.

5. Una vez que se hayan guardado los cambios, Magento te solicitará que limpies la cache del sistema, y una vez hecho esto, tu tienda dispondrá de las formas de pago que ofrece Openpay.


Notificaciones de pago en tienda
Importante: Es necesario verificar que el Webhook haya sido creado de forma correcta en Openpay.
Store payments -> https://[eCommerce domain]/stores/payments/confirm
- En su panel de configuración de Openpay ir a Ajustes (ícono de engrane) -> Configuraciones.

2. Ubicar el apartado de Webhooks. Si el webhook fue configurado correctamente habrá un registro en estado Verificado.
