Mercado Pago - Get Subscriptions

Description

Gets subscriptions (preapproval) from Mercado Pago. Allows searching by specific ID, filtering by subscriber email, status, or listing with pagination.

Configuration

Field	Type	Required	Description
credentials_id	credential	Yes	Mercado Pago credentials
preapproval_id	string	No	Specific subscription ID
payer_email	string	No	Filter by subscriber email
status	select	No	Filter by status
limit	number	No	Number of results (default: 10)
offset	number	No	Offset for pagination

Credentials

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

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

Output

Search by 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"
  }
}

Search with filters

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

Subscription Statuses

• pending: Pending authorization
• authorized: Active and charging
• paused: Paused (not charging)
• cancelled: Permanently canceled

Usage Example

Get subscription by ID

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

Search active subscriptions

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

API Used

• Endpoint: GET /preapproval/{id} or GET /preapproval/search
• Documentation: Mercado Pago Subscriptions API

Notes

• Subscriptions in Mercado Pago are called “preapproval”
• The init_point allows the user to complete the initial payment
• The frequency can be in days or months

Related Nodes

• MercadopagoCreateSubscription - Create subscription
• MercadopagoCancelSubscription - Cancel/pause subscription
• MercadopagoGetCustomers - Get customers