About Magento
Magento is a web platform that allows content management for online stores, offering a flexible and scalable solution on which any eCommerce can be built.
The Openpay plugin for Magento enables you to use our supported payment methods (credit card, stores and wire transfers) within the shopping flow of your eCommerce.
Supported versions
- Magento Open Source Edition (Magento Community) 2.1.1 or greater
- Magento Adobe Commerce (Magento Enterprise)
- Magento Commerce Cloud Edition (Magento Cloud)
Requirements
It is required for the server that hosts your Magento 2 store to fulfill the following:
- Versión instalada de PHP 8.1.
- Versión instalada de MySQL 8.0 o mayor.
- Have a SSL certificate for your eCommerce, in case you wish to accept credit card payments.
Installation
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 tu plataforma.
To implement the three payment methods in your store, it is necessary to install and enable each one separately.
1.- Ingresar desde la terminal de nuestro servidor a la carpeta raíz de Magento.
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.
- Credit card payment module
composer require openpay/magento2-cards:3.5.*- Store payment module
# Para versiones de Magento < 2.3.0
composer require openpay/magento2-stores:~3.1.0
# Para versiones de Magento >= 2.3.0
composer require openpay/magento2-stores:~3.5.0
# Para versiones de Magento >= 2.3.5
composer require openpay/magento2-stores:4.2.0- SPEI payment module
# Para versiones de Magento < 2.3.0
composer require openpay/magento2-banks:~3.1.0
# Para versiones de Magento >= 2.3.0
composer require openpay/magento2-banks:~3.5.0
# Para versiones de Magento >= 2.3.5
composer require openpay/magento2-banks:4.2.03) Enable the modules, update and clear cache of the platform to complete the installation process.
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:cleanConfiguración de módulos.
2.- Aparecerá una pantalla como la que se muestra a continuación.
3.- En tu panel de administración de Magento2 (Dashboard Magento), dirigirse a la sección Stores > Configuration.
4.- Una vez dentro de la pantalla de configuración, ubicar el menú lateral izquierdo Sales > Payment Methods.
5.- Le aparecerán los Módulos que instaló.
Configuración Openpay Tarjetas.
- Habilitado: Enables or disables Openpay as the payment platform for your eCommerce.
- Sandbox: Determines whether the plugin is working on a testing environment (Sandbox) or productive environment.
- País: Seleccionar el país donde se encuentra (México).
- Clasificación del comercio: Tipo de comercio electrónico (por default Openpay).
- Title: Name of the payment method displayed in the store.
- Merchant ID: El Id de su comercio que se obtuvo en pasos anteriores (Credenciales de API).
- Llave Secreta: La llave secreta de su comercio (Credenciales de API).
- Llave Pública: La llave pública de su comercio (Credenciales de API).
- ¿Cómo procesar el cargo?: Define el tipo de cargo que se realizará: Directo, 3Dsecure o Autenticación Selectiva.
- Configuración del cargo: Indicates whether the charge is made immediately or not.
- Pago con puntos: Receive point payments with BBVA, Santander and citibanamex.
- Guardar Tarjetas: Enable saving credit cards.
- Tipos de tarjetas (Credit card types).-The 3 types of cards must be selected to accept all types of cards allowed by Openpay.
- Meses sin intereses: Puede habilitar o deshabilitar pagos con tarjeta con meses sin intereses seleccionando 3,6,9,12 y/o 18 meses sin intereses.
- Configurar Montos Mínimos MSI: Puede configurar un monto mínimo para Meses Sin Intereses.
- Pago aplicable para países: Seleccione si quiere que el método de pago este disponible solo para un país o para todos.
- Pago para países específicos: Si en la opción anterior selecciono países específicos, aquí deberá seleccionar los países.
- Openpay processing: Debe seleccionar el estatus que tendrá la orden una vez que el módulo de tarjetas lo establezca en processing.
- Openpay Pendiente de Pago: Debe seleccionar el estatus que tendrá la orden un vez que el módulo de tarjetas lo establezca en payment_review.
- Openpay Cancelado: Debe seleccionar el estatus que tendrá la orden una vez que el módulo de tarjetas lo establezca en canceled.
- Orden (Sort order).- Order in which the payment method is shown.
Configuración Pagos en Tiendas
Fecha límite para pago (Payment deadline).- Define the hours on which your customer will be able to make a payment via Convenience Store.
Configuración de países permitidos (Payment from applicable countries, payment from specific countries).- you can leave the default configuration or define only Mexico.
Orden (Sort order).- Order in which the payment method is shown.
Configuración Pagos vía SPEI (Banks).
Fecha límite para pago (Payment deadline).- Define the hours on which your customer will be able to make a payment via Convenience Store.
Configuración de países permitidos (Payment from applicable countries, payment from specific countries).- you can leave the default configuration or define only Mexico.
Orden (Sort order).- Order in which the payment method is shown.
6.- Cuando finalize las configuraciones de su preferencia, dar clic en el botón de Save Config.
7.- Una vez que se hayan guardado los cambios, Magento te solicitará que limpies la cache del sistema, dar clic en Cache Management.
8.- En la pantalla que le aparecerá, dar clic en Flush Magento Cache.
una vez hecho esto, tu tienda dispondrá de las formas de pago que ofrece Openpay.
Store and SPEI payment notifications
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 (wire transfer)
https://[eCommerce domain]/openpay/index/webhook
Pago con tarjeta
https://[eCommerce domain]/openpay/cards/webhook
Webhook verification
NOTA: Recuerde que no es necesario agregar el Webhook manualmente, al guardar la configuración del módulo este lo crea de forma automática.
It is necessary to verify that the Webhooks were created correctly in Openpay.
1.- En su panel de configuración de Openpay ir a Ajustes (icono de engrane) -> Configuraciones.
2. Locate the Webhookssection. If the webhook was configured correctly there will be a record in Verified.
