Inicio

Guías

Referencia

Plugins

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

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á:
  1. Directo: Se realizará una evaluación del cargo y se rechazará si el sistema antifraude detectó alguna anomalía.
  2. 3D Secure: Se realizará un redireccionamiento al banco para que el cliente sea autenticado en su banco.
  3. 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.