Criar plano de assinaturahttps://api.mercadopago.com/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.
POST
Request parameters
Header
Authorization
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.string
OBRIGATÓRIO
Body
reason
É uma breve descrição que o assinante verá durante o processo de checkout e nas notificações.string
OBRIGATÓRIO
auto_recurring
Configuração da data para recorrência.object
payment_methods_allowed
Meios de pagamento habilitados no checkout.object
back_url
URL de retorno de sucesso. Use esta configuração para redirecionar seus clientes para o seu site após o checkout.string
OBRIGATÓRIO
Response parameters
id
Identificador único do plano de assinatura.string
application_id
ID ú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.number
collector_id
ID único que identifica seu usuário como vendedor. Este ID corresponde ao seu User ID em nosso ecossistema.number
reason
É uma breve descrição que o assinante verá durante o processo de checkout e nas notificações.string
Erros
400Erro
400
Bad-Request
401Erro
401
Unauthorized
404Erro
404
Not-Found
500Erro
500
Error
Request
curl -X POST \
'https://api.mercadopago.com/preapproval_plan'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-5*********956537-12*********ff1a3d36d*********47e7b9985*********770' \
-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": "UYU"
},
"payment_methods_allowed": {
"payment_types": [
{
"id": "visa"
}
],
"payment_methods": [
{
"id": "visa"
}
]
},
"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": "UYU"
},
"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"
}