Crear un plan de suscripción/preapproval_planUn plan es un template para crear suscripciones que indican con qué frecuencia y cuánto cobrar a tus clientes. Se pueden crear planes con pruebas gratuitas, ciclos de facturación y más. Las suscripciones creadas a partir de un plan están relacionadas con el mismo y permiten sincronizar modificaciones como reason o amount.
POST
Productos que lo utilizan:
Parámetros para la solicitud
auto_recurring
Localización: bodyInformación de configuración para la recurrencia.object
back_urlstring
Localización: bodyURL de retorno exitosa. Use esta configuración para redirigir a tus clientes a su sitio después de nuestro checkout.REQUERIDO
payment_methods_allowed
Localización: bodyMétodos de pago habilitados en el checkout.object
reasonstring
Localización: bodyEs una breve descripción que el suscriptor verá durante el checkout y en las notificaciones.REQUERIDO
Parámetros de respuesta
id
Localización: bodyIdentificador único del plan de suscripción.string
application_id
Localización: bodyID único que identifica tu aplicación/integración. Una de las claves del par que componen las credenciales que identifican una aplicación/integración en tu cuenta.number
collector_id
Localización: bodyID único que identifica a tu usuario como vendedor. Este ID coincide con tu User ID en nuestro ecosistema.number
reason
Localización: bodyEs una breve descripción que el suscriptor verá durante el checkout y en las notificaciones.string
Solicitud
curl
curl -X POST \
'https://api.mercadopago.com/preapproval_plan' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"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.yoursite.com"
}'
Respuesta
json
{
"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"
}
Errores
400bad_request
400
400Parameter reason is required
400Parameter external_reference has unsupported characters
400Parameter auto_recurring is required
400Parameters frequency and frequency_type are required in the recurring payments scheme
400Invalid value for back_url. Must be a valid URL
400Invalid value for status. Valid ones ar active, inactive, cancelled.
400Invalid value for transaction_amount, must be a positive number
400Invalid value for transaction_amount, must be a positive integer
400Invalid value for transaction_amount, only two decimals are allowed
400Invalid value for payer_email, must be a valid email address
400Invalid value for currency_id
400Invalid value for frequency, must be a positive integer
400Invalid value for frequency_type
400Invalid value for frequency_type, valid ones are days or months
400Invalid value for repetitions, mus be a positive integer
400Cannot pay an amount greater than max
400Cannot pay an amount lower than min
400Cannot operate with this currency_id in this site
400Cannot operate between diferent countries
400Field currency_id is required
400Reason has unsupported characters
400Plan are not available for this country yet
401bad_request
401Must provide your access_token to proceed
404bad_request
404The application id does not exist
500bad_request
500Internal server error