Update subscription - Subscriptions - Mercado Pago Developers
Update a subscription

PUT

/preapproval/{id}
Renew the data of a subscription. Indicate the preapproval ID and send the body with the information you want to update. You can update reason, amount, payment method and status and more.
Request's parameters
id

REQUIRED

string
Localization: pathUnique subscription identifier you want to modify.
auto_recurring
object
Localization: bodyConfiguration data for recurrence.
back_url
string
Localization: bodySuccessful return URL. Use this setting to redirect your customers after our checkout to your site.
card_token_id
number
Localization: bodyUnique identifier to retrieve data from the card used as a payment method.
Response parameters
id
string
Localization: bodyUnique subscription identifier.
version
number
Localization: bodyHow many times the subscription was modified
application_id
number
Localization: bodyUnique ID that identifies your application/integration. One of the keys in the pair that make up the credentials that identify an application/integration in your account.
collector_id
number
Localization: bodyUnique ID that identifies your user as a seller. This ID matches your User ID in our ecosystem.
Request
curl
curl -X PUT \
    'https://api.mercadopago.com/preapproval/{id}' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
  "reason": "Yoga classes.",
  "external_reference": 23546246234,
  "back_url": "https://www.mercadopago.com.ar",
  "auto_recurring": {
    "transaction_amount": 10,
    "currency_id": "ARS"
  },
  "card_token_id": 123123123,
  "status": "pending"
}'
Answer
json
{
  "id": "2c938084726fca480172750000000000",
  "version": 0,
  "application_id": 1234567812345678,
  "collector_id": 100200300,
  "preapproval_plan_id": "2c938084726fca480172750000000000",
  "reason": "Yoga classes.",
  "external_reference": 23546246234,
  "back_url": "https://www.mercadopago.com.ar",
  "init_point": "https://www.mercadopago.com.ar/subscriptions/checkout?preapproval_id=2c938084726fca480172750000000000",
  "auto_recurring": {
    "frequency": 1,
    "frequency_type": "months",
    "start_date": "2020-06-02T13:07:14.260Z",
    "end_date": "2022-07-20T15:59:52.581Z",
    "currency_id": "ARS",
    "transaction_amount": 10,
    "free_trial": {
      "frequency": 1,
      "frequency_type": "months"
    }
  },
  "first_invoice_offset": 7,
  "payer_id": 123123123,
  "card_id": 123123123,
  "payment_method_id": "account_money",
  "next_payment_date": "2022-01-01T11:12:25.892-04:00",
  "date_created": "2022-01-01T11:12:25.892-04:00",
  "last_modified": "2022-01-01T11:12:25.892-04:00",
  "summarized": {
    "quotas": 6,
    "charged_quantity": 3,
    "charged_amount": 1000,
    "pending_charge_quantity": 1,
    "pending_charge_amount": 200,
    "last_charged_date": "2022-01-01T11:12:25.892-04:00",
    "last_charged_amount": 100,
    "semaphore": "green"
  },
  "status": "pending"
}
Errors
400bad_request
400Invalid transition from cancelled to authorized
400You can not modify a cancelled preapproval.
400You can not modify a paused subscription.
400This preapproval can not be authorized with a credit card
400This preapproval can not disable account_money
400This preapproval can not be authorized only with account_money
400This preapproval require account_money to be authorized
400You must provide a card_id
400preapproval without another payment method
401bad_request
401Unauthorized access to resource
500bad_request
500Internal server error