Criar assinatura
POST
Produtos relacionados:
Parâmetros de requisição
BODY
preapproval_plan_id
Identificador único do plano de assinatura. Este é um campo opcional. Nosso modelo suporta a criação de assinaturas com ou sem plano associado. Se você criar uma assinatura com plano, usaremos as configurações recorrente...Ver maisstring
reason
É uma breve descrição que o assinante verá durante o processo de checkout e nas notificações. É obrigatório apenas para assinaturas sem plano associado.string
external_reference
Referência para sincronizar com seu sistema. Este é um campo de texto livre que ajudará na integração com as entidades. Este campo é obrigatório apenas para assinaturas sem plano associado.string
payer_email
Para criar uma assinatura, é necessário vinculá-la a um e-mail. Isso permite obter um identificador único para identificar o assinante. No caso de assinaturas sem plano associado, durante o processo de pagamento, validam...Ver maisstring
OBRIGATÓRIO
Parâmetros de resposta
id
Identificador único de assinaturastring
version
Quantas vezes a assinatura foi modificada.number
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
Erros
400Erro
400
Bad-Request
401Erro
401
Unauthorized
403Erro
403
Forbidden
500Erro
500
Error
Requisição
curl -X POST \
'https://api.mercadopago.com/preapproval'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
-d '{
"preapproval_plan_id": "2c938084726fca480172750000000000",
"reason": "Yoga classes",
"external_reference": "YG-1234",
"payer_email": "test_user@testuser.com",
"card_token_id": "e3ed6f098462036dd2cbabe314b9de2a",
"auto_recurring": {
"frequency": 1,
"frequency_type": "months",
"start_date": "2020-06-02T13:07:14.260Z",
"end_date": "2022-07-20T15:59:52.581Z",
"transaction_amount": 10,
"currency_id": "ARS"
},
"back_url": "https://www.mercadopago.com.ar",
"status": "authorized"
}'Resposta de exemplo
{
"id": "2c938084726fca480172750000000000",
"version": 0,
"application_id": 1234567812345678,
"collector_id": 100200300,
"preapproval_plan_id": "2c938084726fca480172750000000000",
"reason": "Yoga classes.",
"external_reference": 23546246234,
"back_url": "https://www.mercadopago.com.ar",
"init_point": "https://www.mercadopago.com.ar/subscriptions/checkout?preapproval_id=2c938084726fca480172750000000000",
"auto_recurring": {
"frequency": 1,
"frequency_type": "months",
"start_date": "2020-06-02T13:07:14.260Z",
"end_date": "2022-07-20T15:59:52.581Z",
"currency_id": "ARS",
"transaction_amount": 10,
"free_trial": {
"frequency": 1,
"frequency_type": "months"
}
},
"payer_id": 123123123,
"card_id": 123123123,
"payment_method_id": 123123123,
"next_payment_date": "2022-01-01T11:12:25.892-04:00",
"date_created": "2022-01-01T11:12:25.892-04:00",
"last_modified": "2022-01-01T11:12:25.892-04:00",
"status": "pending"
}