Criar plano de assinatura - Planos - Mercado Pago Developers
Criar um plano de assinatura

POST

/preapproval_plan
Um plano é um template para criar assinaturas que informa a frequência e valor que deverão ser cobrados dos seus clientes. Planos podem ser criados com testes grátis, ciclos de cobrança, entre outros. As assinaturas criadas a partir de um plano são relacioadas a ele e permitem sincronizar informações como reason e amount.
Parâmetros de requisição
auto_recurring
object
Localização: bodyConfiguração da data para recorrência.
back_url

OBRIGATÓRIO

string
Localização: bodyURL de retorno de sucesso. Use esta configuração para redirecionar seus clientes para o seu site após o checkout.
payment_methods_allowed
object
Localização: bodyMeios de pagamento habilitados no checkout.
reason

OBRIGATÓRIO

string
Localização: bodyÉ uma breve descrição que o assinante verá durante o processo de checkout e nas notificações.
Parâmetros de resposta
id
string
Localização: bodyIdentificador único do plano de assinatura
application_id
number
Localização: bodyID único que identifica sua aplicação/integração. Uma das chaves do par que compõe as credenciais que identifica uma aplicação/integração na sua conta.
collector_id
number
Localização: bodyID único que identifica seu usuário como vendedor. Este ID corresponde ao seu User ID em nosso ecossistema.
reason
string
Localização: bodyÉ uma breve descrição que o assinante verá durante o processo de checkout e nas notificações.
Solicitação
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"
}'
Resposta
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"
}
Erros
400bad_request
400400--Bad-Request--Parameter back_url is required
400400--Bad-Request--Parameter reason is required
400400--Bad-Request--Parameter external_reference has unsupported characters
400400--Bad-Request--Parameter auto_recurring is required
400400--Bad-Request--Parameters frequency and frequency_type are required in the recurring payments scheme
400400--Bad-Request--Invalid value for back_url. Must be a valid URL
400400--Bad-Request--Invalid value for status. Valid ones ar active, inactive, cancelled.
400400--Bad-Request--Invalid value for transaction_amount, must be a positive number
400400--Bad-Request--Invalid value for transaction_amount, must be a positive integer
400400--Bad-Request--Invalid value for transaction_amount, only two decimals are allowed
400400--Bad-Request--Invalid value for payer_email, must be a valid email address
400400--Bad-Request--Invalid value for currency_id
400400--Bad-Request--Invalid value for frequency, must be a positive integer
400400--Bad-Request--Invalid value for frequency_type
400400--Bad-Request--Invalid value for frequency_type, valid ones are days or months
400400--Bad-Request--Invalid value for repetitions, mus be a positive integer
400400--Bad-Request--Cannot pay an amount greater than max
400400--Bad-Request--Cannot pay an amount lower than min
400400--Bad-Request--Cannot operate with this currency_id in this site
400400--Bad-Request--Cannot operate between diferent countries
400400--Bad-Request--Field currency_id is required
400400--Bad-Request--Reason has unsupported characters
400400--Bad-Request--Plan are not available for this country yet
401bad_request
401401--Unauthorized--Must provide your access_token to proceed
404bad_request
404404--Not-Found--The application id does not exist
500bad_request
500500--Error--Internal server error