Subscription management - Production mode - Mercado Pago Developers

Subscription management

Through subscription management, it is possible to pause, cancel or reactivate an already created subscription, in addition to making other specific changes within its initial settings.

In the following table, you will find more information about the management possibilities:

TypeDescription
Search subscriptionAllows you to search for subscriptions regardless of their status (active, paused, canceled). To do so, send a GET with the necessary parameters to the /preapproval/search endpoint and execute the request.
Update card and valueAllows you to change the card or the value of an already created subscription. To change the card, send the new token in the attribute in the card_token_id attribute to the /preapproval/{id} endpoint and execute the request. To change the signature value, send the new value through auto_recurring.transaction_amount, respecify auto_recurring.currency_id and execute the request.
Cancel or pause subscriptionAllows you to cancel or pause an existing subscription. To do so, send a PUT with the status attribute and the canceled value to the /preapproval/{id} endpoint and execute the request. To pause a subscription, send a PUT with the status attribute and the paused value to the /preapproval/{id} endpoint and execute the request.
Reactivate subscriptionAllows you to reactivate a canceled/paused subscription and set a deadline for its completion. To do so, send a PUT with the necessary parameters to the /preapproval/{id} endpoint and execute the request.
Change billing dateFor subscriptions with a monthly payment frequency, you can choose a fixed day of the month for billing to occur. To do so, send a PUT with the necessary parameters to the /preapproval/{id} endpoint and execute the request.
Set pro rataYou can set a prorated amount for billing an individual subscription. To do so, send a PUT with the necessary parameters to the /preapproval/{id} endpoint and execute the request.
Offer free trialIt is possible to offer a free trial period for customers to test the product and service before purchasing it. To do so, send a PUT with the free_trial, frequency, and frequency_type parameters setting the number of days and the type (days/months) to the /preapproval_plan/{id} endpoint and execute the request.