Saltar al contenido principal

MercadoPago para PrestaShop

Descripción​

Integra MercadoPago en tu tienda PrestaShop con soporte para suscripciones recurrentes, marketplace y múltiples métodos de pago. Este módulo te permite aceptar pagos de forma segura y confiable a través de la plataforma MercadoPago.

Índice​

Cómo Instalar​

Para instalar este módulo, sigue las instrucciones generales de instalación de módulos de PrestaShop que puedes encontrar en nuestra guía de instalación de PrestaShop.

Cómo Configurar​

Configuración General​

  1. Accede al panel de administración de PrestaShop
  2. Ve a Módulos > Gestor de Módulos
  3. Busca "MercadoPago Tools Pro" y haz clic en "Configurar"

Credenciales de MercadoPago​

Para comenzar a usar el módulo, necesitas configurar las siguientes credenciales:

  • Public Key: Tu clave pública de MercadoPago
  • Secret Key (Access Token): Tu clave secreta de MercadoPago
  • Client ID: Solo necesario para Marketplaces
  • Client Secret: Solo necesario para Marketplaces
  • Licencia: Tu licencia para usar el módulo

Puedes encontrar tus credenciales en el panel de desarrolladores de MercadoPago.

Configuración de Pagos​

El módulo ofrece tres métodos de pago principales:

1. Checkout Bricks​

  • Activa/desactiva el método de pago
  • Configura el nombre a mostrar
  • Establece comisiones y cargos
  • Configura cuotas y montos mínimos
  • Opciones de modo Gateway (solo Argentina y Colombia)
  • Modo binario
  • Configuración de meses sin intereses:
    • Establece el número máximo de meses sin intereses
    • Configura el monto mínimo para activar meses sin intereses
    • Personaliza las tasas de interés por número de meses
    • Activa/desactiva la visualización del calculador de cuotas en la ficha del producto

2. Checkout Pro (Redirección)​

  • Activa/desactiva el método de pago
  • Configura el nombre a mostrar
  • Establece tiempo de expiración del pago
  • Configura comisiones y cargos
  • Opciones de cuotas y montos mínimos
  • Configuración de devoluciones automáticas
  • Personalización de botones de pago
  • Configuración de meses sin intereses:
    • Establece el número máximo de meses sin intereses
    • Configura el monto mínimo para activar meses sin intereses
    • Personaliza las tasas de interés por número de meses
    • Activa/desactiva la visualización del calculador de cuotas en la ficha del producto

3. Pago con QR​

  • Activa/desactiva el método de pago
  • Configura el nombre a mostrar
  • Establece comisiones y cargos
  • Sube tu imagen QR personalizada

Configuración de Suscripciones​

Para productos con suscripción:

  1. En la página de edición del producto, encontrarás una nueva sección "MercadoPago"
  2. Configura:
    • Máximo de cuotas para el producto
    • Activar/desactivar suscripciones
    • Usar plan personalizado
    • Tipo de frecuencia (días/meses)
    • Cantidad de tiempo entre pagos
    • Número de pagos a realizar

Configuración de Marketplace​

Si deseas usar el módulo como marketplace:

  1. Obtener Credenciales de API:

    • Ingresa a https://www.mercadopago.com/developers/ y selecciona tu país
    • Inicia sesión con tu cuenta de vendedor
    • Ve a "Tus Integraciones" → "Dashboard"
    • Haz clic en "Crear nueva Integración"
    • Configura la integración:
      • Nombre: "MercadoPago para MiDominio"
      • Tipo de solución: "Pagos online"
      • Plataforma e-commerce: "No"
      • Producto: "CheckoutAPI"
      • Modelo de integración: "Marketplace"
    • Guarda las credenciales generadas

  2. Configurar URL de Redirección:

    • Edita la aplicación creada
    • En "Redirect URL" ingresa: 
      https://tudominio.com/module/mptoolspro/plan?show_marketplace=1&gettoken
    • Reemplaza "tudominio.com" con tu dominio real

  3. Configuración en PrestaShop:

    • Ingresa las credenciales obtenidas en el módulo
    • Configura las comisiones y reglas de distribución
    • Establece los porcentajes de comisión por vendedor
    • Configura las reglas de pago a vendedores

  4. Vinculación de Vendedores:

    • Los vendedores deben vincular sus cuentas de MercadoPago
    • Proceso de vinculación:
      1. El vendedor accede a la sección de marketplace
      2. Hace clic en "Vincular MercadoPago"
      3. Autoriza la aplicación
      4. Confirma la vinculación

  5. Gestión de Pagos:

    • Configura el tiempo de retención de pagos
    • Establece las reglas de liberación de fondos
    • Configura las notificaciones de pago
    • Gestiona las devoluciones y disputas

  6. Reportes y Comisiones:

    • Accede a reportes detallados de ventas
    • Visualiza comisiones por vendedor
    • Gestiona pagos a vendedores
    • Configura alertas y notificaciones

Notas Importantes para Marketplace​

  1. Dependencia de JaMarketplace:

    • Las funcionalidades de marketplace solo están disponibles si tienes instalado y activo el plugin JaMarketplace
    • Sin JaMarketplace, las opciones de marketplace no funcionarán correctamente

  2. Credenciales de Prueba vs Producción:

    • Se recomienda usar credenciales de producción desde el inicio
    • Las credenciales de prueba presentan problemas
    • Realiza pruebas con montos mínimos que respeten los límites de MercadoPago

Licencia​

Este plugin requiere una licencia válida de Cujiware para su funcionamiento. Para obtener y activar tu licencia, sigue las instrucciones en nuestra guía de licencias.

Cómo Utilizar​

Para el Cliente​

  1. Proceso de Pago:

    • Selecciona los productos
    • Ve al carrito
    • Elige el método de pago de MercadoPago
    • Completa el pago según el método elegido

  2. Suscripciones:

    • Accede a "Mis Suscripciones" desde tu cuenta
    • Gestiona tus suscripciones activas
    • Cancela, pausa o reanuda suscripciones
    • Consulta próximos cobros y envíos

  3. Marketplace:

    • Vincula tu cuenta de MercadoPago
    • Gestiona tus ventas y comisiones
    • Consulta el estado de tus pagos

Para el Administrador​

  1. Gestión de Pedidos:
    • Visualiza el estado de los pagos
    • Gestiona devoluciones
    • Configura estados de pedido personalizados