Home
Documentation
Resources
Certifications
Community
Update subscription plan - Plans - Mercado Pago Developers

Intelligent search powered by OpenAI 

Update a subscription plan

PUT

https://api.mercadopago.com/preapproval_plan/{id}
Renew the data of a plan. Indicate the plan ID and send the body with the information you want to update.
Request's parameters
PATH
id
string

REQUIRED

Subscription plan identifier.
BODY
reason
string
It is a short description that the subscriber will see during the checkout process and in the notifications.
auto_recurring
object
Configuration data for recurrence.
payment_methods_allowed
object
Payment methods enabled at checkout.
back_url
string
Successful return URL. Use this setting to redirect your customers to your site after our checkout.
Response parameters
id
string
Unique subscription plan identifier.
application_id
number
Unique 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
Unique ID that identifies your user as a seller. This ID matches your User ID in our ecosystem.
reason
string
It is a short description that the subscriber will see during the checkout process and in the notifications.
Errors

400Bad request

400

Bad-Request

401Error

401

Unauthorized

404Error

404

Not-found

500Error

500

Error

Request
curl -X PUT \
    'https://api.mercadopago.com/preapproval_plan/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
    -d '{
  "reason": "Yoga classes",
  "auto_recurring": {
    "frequency": 1,
    "frequency_type": "months",
    "repetitions": 12,
    "billing_day": 10,
    "billing_day_proportional": false,
    "free_trial": {
      "frequency": 1,
      "frequency_type": "months"
    },
    "transaction_amount": 10,
    "currency_id": "ARS"
  },
  "payment_methods_allowed": {
    "payment_types": [
      {
        "id": "credit_card"
      }
    ],
    "payment_methods": [
      {
        "id": "bolbradesco"
      }
    ]
  },
  "back_url": "https://www.yoursite.com"
}'
Sample answer
{
  "id": "2c938084726fca480172750000000000",
  "application_id": 1234567812345678,
  "collector_id": 100200300,
  "reason": "Yoga classes",
  "auto_recurring": {
    "frequency": 1,
    "frequency_type": "months",
    "repetitions": 12,
    "billing_day": 10,
    "billing_day_proportional": true,
    "free_trial": {
      "frequency": 7,
      "frequency_type": "months",
      "first_invoice_offset": 7
    },
    "transaction_amount": 10,
    "currency_id": "ARS"
  },
  "payment_methods_allowed": {
    "payment_types": [
      {}
    ],
    "payment_methods": [
      {}
    ]
  },
  "back_url": "https://www.mercadopago.com.ar",
  "external_reference": "23546246234",
  "init_point": "https://www.mercadopago.com.ar/subscriptions/checkout?preapproval_plan_id=2c938084726fca480172750000000000",
  "date_created": "2022-01-01T11:12:25.892-04:00",
  "last_modified": "2022-01-01T11:12:25.892-04:00",
  "status": "active"
}