Magento 2

¿Cómo instalar?

El módulo de Mercado Pago ofrece más de una forma de instalar el módulo, pero todas tienen el mismo resultado de integración.

Instalación vía FTP

Descargue el módulo Mercado Pago disponible en Github.
Cree una carpeta con el nombre code dentro de la carpeta app de Magento.
Para tener acceso a la carpeta MercadoPago es necesario descomprimir el ZIP.
Copie la carpeta MercadoPago que está dentro de la carpeta src en la carpeta de code.
Ejecute el comando para actualizar la lista de plugins de Magento:

bin/magento setup:upgrade

Ejecute el comando para limpiar el caché de Magento:

bin/magento cache:clean

Cuando la tienda está en modo productivo, es necesario generar los archivos static nuevamente:

bin/magento setup:static-content:deploy -f

Si tiene problemas de permiso de carpeta al acceder a la tienda, debe renovar los permisos:

chmod 777 -R var/ pub/ generated/

Actualización Automática del estado de la Order (Webhooks)

El módulo está preparado para actualizar el estado de la orden automáticamente de acuerdo con el estado del pago, por lo que es importante realizar la configuración de estado order de acuerdo con el estado del pago:

NOTA: Explicando de una forma sencilla, cuando el Mercado Pago notifica un pago Aprobado el módulo actualizará la orden con status Processing de acuerdo con la pantalla de ejemplo.

El módulo está diseñado para enviar la url de su tienda en el momento de la creación del pago, de esa forma no será necesario realizar la configuración de la url de la tienda en el Mercado Pago.

El Mercado Pago identificará la url enviada en el pago y notificará todas los cambios de status realizadas en el pago.

El Mercado Pago dará prioridad a la url enviada en el Pago, si usted configura una url en su cuenta no será accionada si el pago fue creado a través del módulo.

El módulo actualizará sólo los pagos que se realizaron a través del módulo, si utiliza otra herramienta de Mercado Pago para crear un pago, el módulo no será capaz de actualizar la tienda ni la order.

Integración de API

Para mantener el status actualizado entre el pedido y el pago, el módulo está integrado a dos API de gestión de pagos del Mercado Pago.

Devolución de Pagos

Al habilitar esta opción, el módulo realizará la devolución parcial o total del pago en el Mercado Pago cuando se crea un Credit Memo en la Order.

La devolución sólo se realiza en los pagos que tienen el estado Approved (aprobados).

Si la devolución se realiza en el panel del Mercado Pago, el módulo no está preparado para crear Credit Memo automáticamente. Debido a esta limitación, es aconsejable que sea creado a partir de la tienda.

Cancelar Pagos

Al habilitar esta opción, el módulo cancelará el pago en Mercado Pago cuando se cancela la Order.

El pago se cancelará cuando el estado esté en pending o in_process, de lo contrario el módulo devolverá un mensaje de error.

Instalación via Composer

Ejecute el comando del composer para descargar el plugin:

composer require mercadopago/magento2-plugin:3.*

Ejecute el comando para actualizar la lista de plugins de Magento:

bin/magento setup:upgrade

Ejecute el comando para limpiar el cache de Magento:

bin/magento cache:clean && bin/magento cache:flush

Cuando la tienda está en modo productivo, es necesario generar los archivos static nuevamente:

bin/magento setup:static-content:deploy -f

Si tiene problemas de permiso de carpeta al acceder a la tienda, debe renovar los permisos:

chmod 777 -R var/ pub/ generated/

Instalación en Marketplace

Acceso Magento marketplace
Buscar por Mercado Pago M2 -> Seleccionar versión Magento -> Agregar al carrito
Ir al carrito -> Checkout -> Place Order
Crear nueva Access Key

Avanzado

Configuración de tienda

Categoría de la tienda

La categoría se utiliza como una información complementaria al crear el pago, esta información puede o no ayudar en la aprobación del pago.

Página de resultado de pago (Success Page)

La página de resultado de Mercado Pago viene configurada por defecto. Esta página está preparada para mostrar mensajes para cada estado de pago, también está preparada para mostrar el botón de pago para medios offline.

Mostrar valor del cupón de descuento

Esta opción está deshabilitada por defecto, si desea que el valor del cupón del descuento sea detallado en los totales de la orden y de la invoice, basta marcar esa opción como SI.

Opciones de Email

Email de creación de orden

El módulo no es responsable del envío del email, la configuración del servidor de envío de email se realiza en la tienda y en el servidor.

Las configuraciones de templates y si un determinado tipo de emails tiene que ser enviado está en la tienda, en las opciones de Stores > Configuration > Sales >Sales Emails. Ejemplo:

El módulo es responsable de añadir una Flag en el orden para enviar o no el email. Pero si está configurado en la tienda para no enviar y el módulo está marcado como SI, el email NO será enviado.

NOTA: Debido a las limitaciones de Magento, solo es posible enviar un email por proceso. Si la orden es creada y el pago aprobado, sólo se enviará el email de creación de la orden. No se enviarán los emails de actualización y ni de creación de invoices.

Email de creación de orden

Esta opción viene marcada como SI por defecto. Esta opción marcará la order para enviar el email al cliente que el pedido fue creado, pero no significa que el pago fue aprobado.

Email de actualización de orden

En esta opción se puede seleccionar en qué estado de pago el módulo marcará para enviar el email. Por defecto, está configurado estos estados:

No se envía email en la primera actualización de estado porque se envía el email de creación de orden. Si el email de creación de orden está desactivado, el email de actualización de orden para la primera actualización de status del pago será enviado.

Opciones para desarrolladores

Logs en Archivos

Esta opción está activada por defecto.

Un archivo llamado mercadopago.log será creado en la carpeta de logs de Magento (var/log) para detallar el comportamiento del módulo.

Problemas frecuentes

Checkout Mercado Pago. ¿Se actualizan las órdenes utilizando IPN Merchant Order?

Si, utilizamos la notificación IPN Merchant Order para actualizar las órdenes generadas por el Checkout Mercado Pago.

La orden no se actualiza cuando utiliza el checkout Mercado Pago en sandbox (Test mode)

En modo sandbox no se actualiza el pago. Mercado Pago en modo sandbox no vincula payment en la Merchant Order

Checkout personalizado – Paga con dinero en efectivo. Se actualizan las ordenes utilizando Webhook payment?

Si, se usa la notificación Webhook payment para actualizar las ordenes generadas por el Checkout personalizado – Paga con dinero en efectivo.

Checkout personalizado – Paga con tarjetas de débito y crédito. Se actualizan las ordenes utilizando Webhook payment?

Si. Utilizamos la notificación Webhook payment para actualizar las ordenes generadas por el Checkout personalizado – Paga con tarjetas de débito y crédito.

Notificación status 526

Si el código del status es 526 Mercado Pago no acepta el certificado https.

Errores más comunes:

certificate signed by unknown authority

Mercado pago recomienda utilizar https://www.mercadopago.com.br/developers/en/guides/resources/pci-compliant-merchants/disabling-tls-10

Links de consulta del certificado:

Utilice la prueba del servidor SSL para confirmar que se ha implementado SSL y solucionar cualquier problema.

Realice una verificación SSL para descubrir cualquier vínculo y contenido no seguro.

Notificación status 200

La notificación fue exitosa, la orden en el Magento 2 debe cambiar de estado.

Plugins

Este sitio usa cookies