Saltar al contenido principal

Gaia_MercadoPago

Descripción General​

El módulo Gaia_MercadoPago personaliza y extiende la funcionalidad del módulo de pagos MercadoPago en Magento 2. Incluye modificaciones en la configuración de Checkout Pro, gestión de URLs de retorno, cálculo de descuentos y costos, e integración GraphQL para operaciones de MercadoPago.

Features​

Configuración de Checkout Pro Personalizada​

  • Descripción: Personaliza la configuración de MercadoPago Checkout Pro con parámetros específicos de Gaia.
  • Tipo de modificación: Plugin en configuración.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Plugin/ConfigCheckoutProPlugin.php
  • Notas importantes:
    • Afecta la configuración base de MercadoPago Checkout Pro.

URLs de Retorno Personalizadas​

  • Descripción: Personaliza las URLs de retorno para el flujo de MercadoPago.
  • Tipo de modificación: Plugin en request de URLs de retorno.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Plugin/BackUrlsDataRequestPlugin.php
  • Notas importantes:
    • Permite personalizar las URLs de éxito, cancelación y error.

Gestión de Descuentos y Costos​

  • Descripción: Personaliza el cálculo y gestión de descuentos y costos en MercadoPago.
  • Tipo de modificación: Plugin en request de items y costos.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Plugin/ItemsAndDatailsCostDataRequestPlugin.php
  • Notas importantes:
    • Afecta el cálculo de totales enviados a MercadoPago.

Integración GraphQL​

  • Descripción: Proporciona funcionalidades GraphQL para operaciones de MercadoPago.
  • Tipo de modificación: Resolvers GraphQL.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Graphql/resolvers/OrderIdResolver.php
    • etc/schema.graphqls
  • Notas importantes:
    • Permite operaciones de MercadoPago a través de GraphQL.

Resolver de ID de Orden​

  • Descripción: Implementa resolver GraphQL para obtener ID de orden de MercadoPago.
  • Tipo de modificación: Resolver GraphQL personalizado.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Graphql/resolvers/OrderIdResolver.php
  • Notas importantes:
    • Utiliza sesión de checkout para obtener información de orden.

Schema GraphQL Personalizado​

  • Descripción: Define schema GraphQL específico para MercadoPago.
  • Tipo de modificación: Schema GraphQL.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • etc/schema.graphqls
  • Notas importantes:
    • Extiende las capacidades GraphQL para MercadoPago.

Overrides, Observers y Plugins Importantes​

Plugins​

  • MercadoPago\AdbPayment\Gateway\Request\BackUrlsDataRequest
    • mp_back_urls_rewrite: Plugin para personalizar URLs de retorno
  • MercadoPago\AdbPayment\Gateway\Config\ConfigCheckoutPro
    • mp_config_checkout_pro_rewrite: Plugin para personalizar configuración de Checkout Pro
  • MercadoPago\AdbPayment\Gateway\Request\ItemsAndDatailsCostDataRequest
    • mp_discount_overwrite: Plugin para personalizar descuentos y costos

Configuraciones de Inyección de Dependencias​

  • Gaia\MercadoPago\Graphql\resolvers\OrderIdResolver
    • Descripción: Configura resolver GraphQL con sesión de checkout

CLI Commands​

Este módulo no define comandos CLI personalizados.

APIs​

Expone funcionalidades GraphQL para operaciones de MercadoPago:

  • Schema GraphQL en etc/schema.graphqls
  • Resolver para ID de orden en Graphql/resolvers/OrderIdResolver.php

Consideraciones para Mantenimiento​

  • El módulo es crítico para el procesamiento de pagos con MercadoPago y no debe desactivarse sin revisar dependencias.
  • Depende de varios módulos: Magento_Catalog, Magento_Webapi, Magento_GraphQl, Gaia_Headless, MercadoPago_AdbPayment.
  • Los plugins se ejecutan en operaciones críticas de pago y deben ser eficientes.
  • Las modificaciones en URLs de retorno pueden afectar el flujo de pago.
  • El cálculo personalizado de descuentos puede afectar los totales enviados a MercadoPago.
  • La integración GraphQL puede ser utilizada por aplicaciones headless.
  • Revisar compatibilidad con actualizaciones del módulo base de MercadoPago.
  • Los resolvers GraphQL requieren sesión de checkout activa.