AI resources
Subscriptions
The Subscriptions API allows creating and managing automatic recurring charges. Define the frequency and amount; Mercado Pago handles the billing and retries if a payment is declined. This reference describes the available endpoints and how to interact with them.
Looking for integration steps? Go to the Subscriptions documentation
Available endpoints
All endpoints that make up the Subscriptions API integration.
A subscription is the central object of the integration. It can be created directly with the subscriber's payment method or linked to an existing plan.
| Operation | Path | Description |
| Create subscriptionPOST | /preapproval | Creates a subscription with amount, frequency and the subscriber's payment method; can be linked to a plan or configured independently. |
| Search subscriptionsGET | /preapproval/search | Searches subscriptions by filters such as status, preapproval_plan_id or payer; returns paginated results. |
| Get subscriptionGET | /preapproval/{id} | Returns the status and details of a subscription by its ID. |
| Update subscriptionPUT | /preapproval/{id} | Updates subscription data such as status, amount or payment method. |
| Export subscriptionsGET | /preapproval/export | Exports a CSV file with the subscriptions matching the search parameters. |
A plan defines the billing parameters shared by a group of subscribers: amount, frequency and payment method configuration.
| Operation | Path | Description |
| Create subscription planPOST | /preapproval_plan | Creates a subscription template with fixed frequency and amount to link multiple subscribers. |
| Search plansGET | /preapproval_plan/search | Searches subscription plans by filters such as status or name; returns paginated results. |
| Get subscription planGET | /preapproval_plan/{id} | Returns the details of a subscription plan by its ID. |
| Update subscription planPUT | /preapproval_plan/{id} | Updates the data of an existing subscription plan. |
An invoice represents each recurring charge generated by a subscription, including the status and result of the corresponding billing attempt.
| Operation | Path | Description |
| Get invoice dataGET | /authorized_payments/{id} | Returns the details of an invoice (authorized charge) for a subscription by its ID. |
| Search invoicesGET | /authorized_payments/search | Searches invoices by filters such as preapproval_id or status; returns paginated results. |
Payments are the transactions linked to a subscription's invoices. Use them to verify the status and final details of each processed charge.
| Operation | Path | Description |
| Search paymentsGET | /v1/payments/search | Searches payments associated with a subscription by filters such as date or status; covers the last 12 months. |
| Get paymentGET | /v1/payments/{id} | Returns the status and details of a payment by its ID. |
All set to get started?
Go to the first endpoint and start creating your first subscriptions.