MercadoPago para WooCommerce
Descripción
Integra MercadoPago en tu tienda WooCommerce con soporte para suscripciones recurrentes, marketplace y múltiples métodos de pago. Este plugin te permite aceptar pagos de forma segura y confiable a través de la plataforma MercadoPago.
Índice
- MercadoPago para WooCommerce
Cómo Instalar
Para instalar este plugin, sigue las instrucciones generales de instalación de plugins de WooCommerce que puedes encontrar en nuestra guía de instalación de WooCommerce.
Cómo Obtener las Credenciales de MercadoPago
Para obtener tus credenciales de acceso a la API de MercadoPago, sigue estos pasos:
-
Acceso al Panel de Desarrolladores
- Ingresa a https://www.mercadopago.com/developers/
- Selecciona tu país de origen
- Inicia sesión con tu cuenta de vendedor
-
Crear Nueva Integración
- En el menú superior, ve a Tus Integraciones → Dashboard
- Haz clic en Crear nueva Integración
- Completa los siguientes campos:
- Nombre de la integración (ej: "MercadoPago para MiDominio")
- Tipo de solución: Pagos online
- ¿Usas plataforma e-commerce?: No
- Producto a integrar: Checkout API
- Modelo de integración: Marketplace (solo si planeas usar marketplace)
-
Obtener Credenciales
- Al finalizar, obtendrás las credenciales necesarias para el plugin:
- Access Token
- Public Key
- Puedes usar las credenciales de prueba para realizar pruebas
- Al finalizar, obtendrás las credenciales necesarias para el plugin:
-
Configuración Adicional para Marketplace Si planeas usar marketplace, necesitas configurar la URL de redirección:
- Edita la aplicación creada
- En el campo "Redirect URL" ingresa:
https://tudominio.com/mi-cuenta/mercadopago-marketplace/ - Reemplaza "tudominio.com" con tu dominio real
Notas Importantes sobre Credenciales
- Las credenciales de prueba pueden presentar problemas, se recomienda usar credenciales de producción
- Para pruebas en producción, usa montos bajos que respeten los límites mínimos de MercadoPago
- Si necesitas ayuda con la configuración de marketplace, contacta al soporte
Cómo Configurar
-
Configuración Principal
- Ve a WooCommerce > Ajustes > Integraciones
- Busca la sección "MercadoPago"
- Configura los siguientes campos:
- Access Token de MercadoPago
- Public Key de MercadoPago
- Prefijo para las facturas
- Configuración de moneda y conversión
- Modo de prueba (sandbox) o producción
-
Configuración de Métodos de Pago
- Ve a WooCommerce > Ajustes > Pagos
- Habilita los métodos de pago que desees usar:
- MercadoPago Checkout Pro
- MercadoPago Checkout Bricks
- MercadoPago QR
- Configura cada método individualmente
-
Configuración de MercadoPago Checkout Pro
- Ajusta el título y descripción del método de pago
- Configura las opciones de marketplace si las necesitas
- Configura las opciones de suscripción si las necesitas
- Configuración de métodos de pago disponibles:
- Depósitos/Transferencias Bancarias
- Tarjetas Prepagadas
- Tarjetas de Crédito
- Tarjetas de Débito
- Pagos con Cupones
- Configuración de Meses sin Intereses: (Funcionara bien solo si estás suscrito en MercadoPago a este servicio y aplica solo para pagos con tarjeta)
- Activa la comisión fija para Meses sin Intereses
- Configura el comportamiento por defecto para montos mínimos
- Establece el porcentaje de comisión para 3 a 18 meses
- Opción para ocultar pago en 1 cuota
-
Configuración de MercadoPago Checkout Bricks
- Ajusta el título y descripción del método de pago
- Configuración de Meses sin Intereses:
- Activa la comisión fija para Meses sin Intereses (solo si estás suscrito al plan)
- Configura el comportamiento por defecto para montos mínimos
- Establece el porcentaje de comisión para 3 a 18 meses
- Opción para ocultar pago en 1 cuota
- Configuración de métodos de pago disponibles:
- Depósitos/Transferencias Bancarias
- Tarjetas Prepagadas
- Tarjetas de Crédito
- Tarjetas de Débito
- Pagos con Cupones
-
Configuración de MercadoPago QR
- Sube una imagen QR personalizada
- Configura las comisiones si lo deseas
- Ajusta el título y descripción del método de pago
-
Configuración de Webhooks
- Para suscripciones recurrentes, configura los webhooks en tu cuenta de MercadoPago
- Agrega la URL del webhook:
[tu-sitio]/?webhook_woo_kmercadopago
-
Modo de Prueba
- Usa las credenciales de prueba (sandbox) proporcionadas por MercadoPago
- Usa las tarjetas de prueba proporcionadas por MercadoPago
- Verifica que los pagos se procesen correctamente
Cómo Utilizar
El plugin soporta tres métodos de pago diferentes:
1. MercadoPago Checkout Pro (Basic)
Método de pago estándar que redirige al cliente al checkout de MercadoPago. Características:
- Procesamiento de pagos en la plataforma de MercadoPago
- Soporte para múltiples métodos de pago
- Integración con marketplace
- Gestión de reembolsos
2. MercadoPago Checkout Bricks (Anteriormente Tokenize)
Método de pago que permite a los clientes guardar sus tarjetas de crédito/débito para futuras compras. Características:
- Procesamiento seguro de tarjetas sin redireccion a MercadoPago
- Cálculo de cuotas automático
- Validación de tarjetas en tiempo real
3. MercadoPago QR
Este método permite a los clientes pagar escaneando un código QR desde la aplicación de MercadoPago. Características principales:
- Configuración de imagen QR personalizada
- Opción para agregar comisiones porcentuales y fijas
- Validación automática del comprobante de pago
- Soporte para conversión de moneda
Configuración General
Para todos los métodos de pago, necesitarás configurar:
- Access Token de MercadoPago
- Public Key de MercadoPago
- Prefijo para las facturas
- Configuración de moneda y conversión
- Modo de prueba (sandbox) o producción
Notas Importantes
- Para suscripciones recurrentes, debes configurar los webhooks en tu cuenta de MercadoPago
- El plugin soporta conversión automática de moneda
- Puedes habilitar/deshabilitar cada método de pago individualmente
- Se recomienda probar primero en modo sandbox antes de activar en producción
Notas Importantes sobre Meses sin Intereses
- La comisión fija para Meses sin Intereses solo está disponible si:
- Estás suscrito al plan de Meses sin Intereses
- Tienes el plan Ahora (Argentina)
- No tienes activo el modo Marketplace
- El comportamiento por defecto de MercadoPago se aplica cuando el monto del carrito no supera el mínimo para activar cuotas
- Puedes configurar diferentes porcentajes de comisión para cada rango de meses
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.