Mercado Pago - Create Subscription

Description

Creates a recurring subscription (preapproval) in Mercado Pago. Allows configuring automatic periodic charges with frequency in days or months.

Configuration

Field	Type	Required	Description
credentials_id	credential	Yes	Mercado Pago credentials
payer_email	string	Yes	Subscriber email
amount	number	Yes	Recurring amount
currency	select	No	Currency (ARS, BRL, MXN, etc.)
frequency	number	No	Charge frequency (default: 1)
frequency_type	select	No	Type: days or months
reason	string	No	Subscription description
external_reference	string	No	External reference
free_trial_days	number	No	Free trial days
start_date	string	No	Start date (ISO 8601)
end_date	string	No	End date (ISO 8601)
back_url	string	No	Return URL
notification_url	string	No	Webhook URL

Credentials

This module requires a mercadopago type credential with the following fields:

• Access Token: Mercado Pago access token (obtained from the developer dashboard)

Output

{
  "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)"
}

Subscription Flow

1. Create the subscription with this module
2. Redirect the user to init_point to authorize the charge
3. The user enters their payment method
4. The subscription changes to authorized status
5. Mercado Pago charges automatically according to the frequency
6. Receive notifications via webhook

Supported Currencies

• ARS: Argentine Peso
• BRL: Brazilian Real
• MXN: Mexican Peso
• CLP: Chilean Peso
• COP: Colombian Peso
• PEN: Peruvian Sol
• UYU: Uruguayan Peso

Usage Example

{
  "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 Used

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

Notes

• The subscription is created in pending status until the user authorizes it
• The user must be redirected to init_point to authorize the charge
• The default currency is ARS (Argentine Peso)
• Free trial days can be configured with free_trial_days

Related Nodes

• MercadopagoGetSubscriptions - Get subscriptions
• MercadopagoCancelSubscription - Cancel/pause subscription
• MercadopagoCreateCustomer - Create customer