Mercado Pago - Obtener Suscripciones

Descripcion

Obtiene suscripciones (preapproval) de Mercado Pago. Permite buscar por ID especifico, filtrar por email del suscriptor, estado o listar con paginacion.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Mercado Pago
preapproval_id	string	No	ID de una suscripción específica
payer_email	string	No	Filtrar por email del suscriptor
status	select	No	Filtrar por estado
limit	number	No	Cantidad de resultados (default: 10)
offset	number	No	Desplazamiento para paginación

Credenciales

Este modulo requiere una credencial de tipo mercadopago con los siguientes campos:

• Access Token: Token de acceso de Mercado Pago (obtenido en el panel de desarrolladores)

Salida

Búsqueda por ID

{
  "success": true,
  "subscription": {
    "id": "2c9380848...",
    "payer_email": "cliente@email.com",
    "status": "authorized",
    "auto_recurring": {
      "frequency": 1,
      "frequency_type": "months",
      "transaction_amount": 99.99,
      "currency_id": "ARS"
    },
    "init_point": "https://...",
    "date_created": "2024-01-15T10:00:00.000-03:00"
  }
}

Búsqueda con filtros

{
  "success": true,
  "subscriptions": [ ... ],
  "paging": {
    "total": 25,
    "offset": 0,
    "limit": 10
  }
}

Estados de Suscripción

• pending: Pendiente de autorización
• authorized: Activa y cobrando
• paused: Pausada (no cobra)
• cancelled: Cancelada definitivamente

Ejemplo de Uso

Obtener suscripcion por ID

{
  "preapproval_id": "2c9380848..."
}

Buscar suscripciones activas

{
  "status": "authorized",
  "limit": 20
}

API Utilizada

• Endpoint: GET /preapproval/{id} o GET /preapproval/search
• Documentacion: Mercado Pago Subscriptions API

Notas

• Las suscripciones en Mercado Pago se llaman “preapproval”
• El init_point permite al usuario completar el pago inicial
• La frecuencia puede ser en días o meses

Nodos relacionados

• MercadopagoCreateSubscription - Crear suscripcion
• MercadopagoCancelSubscription - Cancelar/pausar suscripcion
• MercadopagoGetCustomers - Obtener clientes