Mercado Pago - Crear Suscripcion

Descripcion

Crea una suscripcion recurrente (preapproval) en Mercado Pago. Permite configurar cobros automaticos periodicos con frecuencia en dias o meses.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Mercado Pago
payer_email	string	Sí	Email del suscriptor
amount	number	Sí	Monto recurrente
currency	select	No	Moneda (ARS, BRL, MXN, etc.)
frequency	number	No	Frecuencia de cobro (default: 1)
frequency_type	select	No	Tipo: days o months
reason	string	No	Descripción de la suscripción
external_reference	string	No	Referencia externa
free_trial_days	number	No	Días de prueba gratis
start_date	string	No	Fecha de inicio (ISO 8601)
end_date	string	No	Fecha de fin (ISO 8601)
back_url	string	No	URL de retorno
notification_url	string	No	URL para webhooks

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

{
  "success": true,
  "subscription": {
    "id": "2c9380848...",
    "payer_email": "cliente@email.com",
    "status": "pending",
    "auto_recurring": {
      "frequency": 1,
      "frequency_type": "months",
      "transaction_amount": 99.99,
      "currency_id": "ARS"
    },
    "init_point": "https://...",
    "sandbox_init_point": "https://sandbox..."
  },
  "preapproval_id": "2c9380848...",
  "status": "pending",
  "init_point": "https://...",
  "sandbox_init_point": "https://sandbox...",
  "message": "Suscripción 2c9380848... creada (pending)"
}

Flujo de Suscripción

1. Crea la suscripción con este módulo
2. Redirige al usuario a init_point para autorizar el cobro
3. El usuario ingresa su método de pago
4. La suscripción pasa a estado authorized
5. Mercado Pago cobra automáticamente según la frecuencia
6. Recibe notificaciones via webhook

Monedas Soportadas

• ARS: Peso Argentino
• BRL: Real Brasileño
• MXN: Peso Mexicano
• CLP: Peso Chileno
• COP: Peso Colombiano
• PEN: Sol Peruano
• UYU: Peso Uruguayo

Ejemplo de Uso

{
  "payer_email": "cliente@email.com",
  "amount": 99.99,
  "currency": "ARS",
  "frequency": 1,
  "frequency_type": "months",
  "reason": "Plan Premium mensual",
  "back_url": "https://mitienda.com/suscripcion",
  "notification_url": "https://mitienda.com/webhook"
}

API Utilizada

• Endpoint: POST /preapproval
• Documentacion: Mercado Pago Subscriptions API

Notas

• La suscripcion se crea en estado pending hasta que el usuario la autorice
• El usuario debe ser redirigido a init_point para autorizar el cobro
• La moneda por defecto es ARS (Peso Argentino)
• Se pueden configurar dias de prueba gratis con free_trial_days

Nodos relacionados

• MercadopagoGetSubscriptions - Obtener suscripciones
• MercadopagoCancelSubscription - Cancelar/pausar suscripcion
• MercadopagoCreateCustomer - Crear cliente