AI resources
Create subscription planhttps://api.mercadopago.com/preapproval_plan
A plan is a template to create subscriptions thats tell how often and how much to charge your customers. Plans can be created with free trials, biiling cycles and more. The subscriptions created from a plan are related to it and allows synchronizing modifications such as reason or amount.
POST
Request parameters
Header
Authorization
string
REQUIRED
Access Token obtained through the developer panel. Must be sent in all requests.
Body
reason
string
REQUIRED
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
REQUIRED
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
400Error
400
Bad-Request
401Error
401
Unauthorized
404Error
404
Not-Found
500Error
500
Error
Request
curl -X POST \
'https://api.mercadopago.com/preapproval_plan'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-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": 24.5,
"currency_id": "ARS"
},
"payment_methods_allowed": {
"payment_types": [
{
"id": "master"
}
],
"payment_methods": [
{
"id": "master"
}
]
},
"back_url": "https://www.yoursite.com"
}'Response
{
"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": 1,
"frequency_type": "months"
},
"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-01T15:12:25.892Z",
"last_modified": "2022-01-01T15:12:25.892Z",
"status": "active"
}