Integración con Mercado Pago
Aprende cómo funciona el proceso de pago de suscripciones con Mercado Pago en SGG, ideal para usuarios en Argentina y Latinoamérica.
💡 ¿Por qué Mercado Pago? Es la plataforma de pagos líder en Latinoamérica, con soporte para múltiples métodos de pago locales como tarjetas, transferencia bancaria, efectivo en puntos de pago, y billeteras digitales.
Monedas Soportadas
Mercado Pago procesa pagos en las siguientes monedas:
- ARS - Peso Argentino (principal)
- BRL - Real Brasileño
- MXN - Peso Mexicano
- CLP - Peso Chileno
- COP - Peso Colombiano
- PEN - Sol Peruano
- UYU - Peso Uruguayo
Flujo de Pago para el Usuario
Paso 1: Seleccionar Plan
- Ve a Configuración → Planes y Suscripción
- Revisa los planes disponibles (Starter, Pro, Enterprise)
- Haz clic en "Mejorar Plan" o "Suscribirse"
- Selecciona el ciclo de facturación: Mensual o Anual
💰 Ahorra con pago anual: El plan anual incluye un descuento significativo equivalente a 2 meses gratis comparado con el pago mensual.
Paso 2: Elegir Mercado Pago como Método de Pago
- En la pantalla de checkout, verás las opciones de pago disponibles
- Selecciona "Mercado Pago"
- El sistema creará una preferencia de pago con los datos de tu suscripción
- Serás redirigido al checkout seguro de Mercado Pago
Paso 3: Completar el Pago en Mercado Pago
En el checkout de Mercado Pago puedes pagar con:
💳 Tarjetas
- Visa, Mastercard, American Express
- Tarjetas de débito
- Cuotas sin interés (según promociones)
🏦 Otros métodos
- Transferencia bancaria
- Dinero en cuenta de Mercado Pago
- Efectivo en puntos de pago (Rapipago, Pago Fácil)
Paso 4: Confirmación y Activación
Según el resultado del pago, serás redirigido a una de estas páginas:
Pago Aprobado
Tu suscripción se activa inmediatamente. Tendrás acceso a todas las funciones de tu nuevo plan.
Pago Pendiente
Si elegiste pagar en efectivo o transferencia, el pago quedará pendiente hasta que lo completes. Una vez acreditado, tu plan se activará automáticamente.
Pago Rechazado
Si hubo un problema con el pago (fondos insuficientes, tarjeta bloqueada, etc.), podrás intentar nuevamente con otro método de pago.
Proceso Técnico (Para Desarrolladores)
// 1. Usuario inicia checkout
POST /api/{slug}/plans/checkout/mercadopago
Body: { planId: "...", billingCycle: "monthly" }
// 2. Backend crea preferencia de pago
const preference = await preferenceClient.create({
items: [{
title: "Plan Pro - Mensual",
unit_price: 2999,
currency_id: "ARS"
}],
back_urls: {
success: "/admin/plans/success",
failure: "/admin/plans/failure",
pending: "/admin/plans/pending"
}
});
// 3. Frontend redirige a initPoint
window.location.href = preference.init_point;
// 4. Mercado Pago notifica via webhook
POST /api/v1/plans/webhook/mercadopago
// Se valida el pago y se actualiza la suscripciónInformación de la Suscripción
Una vez activada tu suscripción con Mercado Pago, se guardan los siguientes datos:
- ID de cliente: Tu identificador en Mercado Pago
- ID de pago: Referencia única de la transacción
- Fecha de inicio del período: Cuándo comenzó tu suscripción
- Último pago: Fecha del último pago exitoso
- Método de pago: Se registra como "mercadopago"
Renovación y Pagos Recurrentes
📌 Nota importante: Actualmente, SGG no implementa cobros automáticos recurrentes con Mercado Pago. Cuando tu período de suscripción está por vencer, recibirás un email recordatorio para renovar manualmente tu plan.
Seguridad del Pago
🔒 Datos protegidos
- SGG nunca ve ni almacena tu tarjeta
- El pago se procesa 100% en Mercado Pago
- Cumple con estándares PCI DSS
- Cifrado SSL en todas las transacciones
✅ Garantías
- Protección al comprador de Mercado Pago
- Comprobante de pago en tu email
- Historial visible en tu cuenta MP
- Soporte de Mercado Pago disponible
¿Qué sigue?
Pagar con Stripe →
Alternativa internacional para pagos con tarjeta en USD
Ver planes disponibles →
Compara características y precios de cada plan
Solución de Problemas
El pago fue aprobado pero mi plan no se activó
Esto puede ocurrir si el webhook de Mercado Pago no se procesó correctamente. Soluciones:
- Espera unos minutos y recarga la página
- Verifica que el pago aparezca como aprobado en tu cuenta de Mercado Pago
- Contacta a soporte con el ID de la transacción
Mi tarjeta fue rechazada
Motivos comunes de rechazo:
- Fondos insuficientes en la tarjeta
- Tarjeta vencida o bloqueada
- Límite de compras excedido
- El banco rechazó la transacción (contacta a tu banco)
¿Puedo pagar en cuotas?
Sí, Mercado Pago ofrece opciones de cuotas según tu tarjeta y las promociones vigentes. Las cuotas se muestran directamente en el checkout de Mercado Pago.
¿Cómo solicito un reembolso?
Para solicitar un reembolso:
- Contacta al equipo de soporte de SGG explicando el motivo
- Proporciona el ID de la transacción
- Los reembolsos se procesan en 5-10 días hábiles
- El dinero vuelve al mismo método de pago utilizado
¿Puedo cambiar de Mercado Pago a Stripe?
Sí, puedes cambiar tu método de pago en cualquier momento. Al renovar tu suscripción, simplemente selecciona Stripe en lugar de Mercado Pago. Tu plan continuará sin interrupciones.