Conectar MercadoPago

MercadoPago es el provider más usado en Argentina. Conectarlo es OAuth: nosotros nunca vemos tu contraseña ni tu token de larga vida.

Antes de empezar

Necesitás:

• Una cuenta de MercadoPago activa (puede ser personal o empresarial).
• Permisos de owner en tu organización en Beepers.
• 5 minutos.

Si tu organización es una persona jurídica, conectá la cuenta de la empresa, no la tuya personal. Los settlements van a CBU asociada a la cuenta conectada.

Paso a paso

1. Configuración → Pagos en el dashboard.
2. Tocá Conectar MercadoPago.
3. Te redirige al login de MercadoPago. Iniciá sesión con la cuenta de la organización.
4. MP te muestra los permisos que solicitamos:
   • Ver tu información de identificación
   • Crear preferencias de pago en tu nombre
   • Ver tus pagos
5. Tocá Aceptar. Te redirige de vuelta a Beepers.

Si todo salió bien, ves un check verde junto a MercadoPago en la lista de providers, y los nuevos eventos van a poder activar el método de pago "MP".

Qué guardamos

Solo:

• Tu mp_user_id (público, no sensible)
• El access_token cifrado (para crear preferencias)
• El refresh_token cifrado (para renovar)
• Las fechas de creación y última rotación

NO guardamos: tu password, tu token de larga vida, ningún CBU.

Rotación automática

Los tokens de MP duran 6 meses. Tenemos un cron que corre todos los días y rota cualquier token con más de 120 días sin rotar. Es transparente — nunca vas a ver la conexión "vencida" salvo que MP nos rechace por algún motivo (cambio de password, revocación manual desde MP, etc.).

Si la conexión falla por revocación, te avisamos por email y por banner en el dashboard. Para reconectar, repetí el flow desde el paso 1.

Liquidaciones

MP liquida la plata directamente a tu cuenta de MP. Beepers no toca el dinero — somos un intermediario que crea las preferencias y verifica los webhooks.

Tiempos típicos:

• Compra → MP cuenta: instantáneo
• MP cuenta → tu CBU: 24-48 hs hábiles según el método de pago original
• Tarjeta de crédito: liberación a los 14 días por default (configurable en MP)

Webhook de confirmación

Cuando MP confirma un pago, nos manda un webhook a https://<dominio>/api/v1/webhooks/mp. Lo verificamos con HMAC, validamos que el external_reference matchee con una compra pendiente nuestra, y marcamos el ticket como confirmado.

Si el webhook tarda más de 30 segundos en llegar (raro), igual hacemos un poll a la API de MP cada minuto durante los próximos 10 min para no perder pagos.

Desconectar

Configuración → Pagos → MercadoPago → Desconectar. Eventos que ya tienen MP activo siguen funcionando con el último token válido hasta su fin de venta. Eventos nuevos no podrán activarlo.

Para desconexión inmediata (Ej. revocación de seguridad), también podés revocar desde MP: https://www.mercadopago.com.ar/devaccount/applications.