¿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
Para la instalación de extensiones (plugins) en Magento 2 es necesario aplicar una serie de comandos en la terminal del servidor donde este alojada nuestra plataforma.
Para implementar las 3 diferentes formas de pago en tu tienda, será necesario instalar y habilitar cada uno de ellos por separado.
1) Ingresar desde la terminal de nuestro servidor a la carpeta raíz de Magento 2 2) 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.2.*
- 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 SPEI
# 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
3) 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 del plugin
- 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
- En su panel de administración de Magento 2, dirigirse a la sección Stores -> Configuration.
- Una vez dentro de la pantalla de Configuración, ubicar en el menú lateral izquierdo Sales -> Payment Methods.
- Configurar el apartado de Openpay.
Configuración general
- Habilitado.- Para habilitar el módulo de pago.
- Sandbox.- Determina si el plugin va a funcionar en entorno de pruebas (Sandbox).
- Título.- 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 (México, Colombia).
Configuración pago con tarjeta
- ¿Cómo procesar el cargo? Define el tipo de cargo que se realizará:
- Directo: Se realizará una evaluación del cargo y se rechazará si el sistema antifraude detectó alguna anomalía.
- 3D Secure: Se realizará un redireccionamiento al banco para que el cliente sea autenticado en su banco.
- Autenticación selectiva: Se realizará una evaluación del cargo y si el sistema antifraude detecta alguna anomalía, se ejecutará un cargo 3D secure.
- Configuración del cargo.- Indica si el cargo se hace o no inmediatamente.
- Pago con puntos.- Recibe pagos con puntos con BBVA, Santander y citibanamex.
- Guardar tarjetas.- Permite a los usuarios registrados guardar sus tarjetas crédito/débito para agilizar sus futuras compras.
- Tipos de tarjetas.-Deberán de estar seleccionados los 3 tipos de tarjetas para aceptar todo tipo de tarjetas permitidas por Openpay.
- Meses sin intereses.- Puede hablitar o deshabilitar pagos con tarjeta con meses sin intereses seleccionando 3,6,9,12 y/o 18 meses sin intereses.
- Configuración de países permitidos.- Puede dejarse con la configuración por default que tiene o bien puede definirse únicamente a México.
- Orden.- Orden en que se mostrará este método de pago.
Configuración pagos en tiendas
- Fecha límite para pago.- Definir el número de horas que tendrá el cliente una vez emitido el recibo de pago.
- Configuración de países permitidos.- Puede dejarse con la configuración por default que tiene o bien puede definirse únicamente a México.
- Mostrar Mapa.- Al generarse el recibo de pago, se desplegará un mapa que muestra las tiendas de conveniencia más cercanas.
- Orden.- Orden en que se mostrará este método de pago.
Configuración pago vía SPEI
- Fecha límite para pago.- Definir el número de horas que tendrá el cliente una vez emitido el recibo de pago.
- Configuración de países permitidos.- Puede dejarse con la configuración por default que tiene o bien puede definirse únicamente a México.
- Orden.- Orden en que se mostrará este método de pago.
Finalizada la configuración dar clic en el botón Save Config que se encuentra en la esquina superior derecha de la pantalla.
- 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 pagos en tiendas y SPEI
Los plugins Openpay están preparados para recibir las notificaciones de pago de forma automática, es decir, sin la necesidad de configurar su cuenta de Openpay o el plugin. Las notificaciones se envían al comercio cuando los pagos han sido realizados o cuando una referencia ha vencido.
Importante: Los plugins asumen que la tienda se encuentra en la raíz del dominio, por lo que se crea el webhook tomando como base está url.
# Pago en tiendas y SPEI
https://[eCommerce domain]/openpay/index/webhook
Verificación de Webhook
Es importante verificar que el Webhook haya sido creado de forma correcta en Openpay.
- 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.