Inicio
Documentación
Recursos
Certificaciones
Comunidad
Crear suscripción - Suscripciones - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Crear suscripción

POST

https://api.mercadopago.com/preapproval
Una suscripción es la unión entre un plan y un cliente. La principal característica de este contrato es que tiene configurada una forma de pago y es la base para la creación de las facturas. También puedes crear una suscripción sin un plan.
Parámetros para la solicitud
BODY
preapproval_plan_id
string
Identificador único del plan de suscripción. Este campo es opcional. Nuestro modelo soporta la creación de suscripciones con o sin plan asociado. Si creas una suscripción con un plan, tomaremos la configuración recurrent...Ver más
reason
string
Es una breve descripción que el suscriptor verá durante el proceso de checkout y en las notificaciones. Solo se requiere para suscripciones sin plan asociado.
external_reference
string
Referencia para sincronizar con tu sistema. Este es un campo de texto libre para ayudarte con tu integración, para vincular las entidades. Solo se requiere para suscripciones sin plan asociado.
payer_email
string

REQUERIDO

Para crear una suscripción es necesario vincularla con un correo electrónico. Luego obtendrás un identificador único para identificar al suscriptor.
Parámetros de respuesta
id
string
Identificador único de suscripción.
version
number
Cantidad de veces que esta suscripción fue modificada.
application_id
number
ID ú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.
collector_id
number
ID único que identifica a tu usuario como vendedor. Este ID coincide con tu User ID en nuestro ecosistema.
Errores

400Error

400

Bad-Request

401Error

401

Unauthorized

403Error

403

Forbidden

500Error

500

Error

Solicitud
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"
}'
Respuesta de ejemplo
{
  "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"
}