Crear plan de suscripción - Planes - Mercado Pago Developers

Crear un plan de suscripción

POST

/preapproval_plan

Un 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.

Localización: bodyInformación de configuración para la recurrencia.

Localización: bodyURL de retorno exitosa. Use esta configuración para redirigir a tus clientes a su sitio después de nuestro checkout.

Localización: bodyMétodos de pago habilitados en el checkout.

Localización: bodyEs una breve descripción que el suscriptor verá durante el checkout y en las notificaciones.

Localización: bodyIdentificador único del plan de suscripción.

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.

Localización: bodyID único que identifica a tu usuario como vendedor. Este ID coincide con tu User ID en nuestro ecosistema.

Localización: bodyEs una breve descripción que el suscriptor verá durante el checkout y en las notificaciones.

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"
}'

{
  "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"
}

400bad_request

400Parameter back_url is required

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

Política y configuración de cookies