¿Qué estás buscando?
¿No sabes cómo empezar la integración?
Accede a los primeros pasosCrear suscripción
POST
Productos que lo utilizan:
Parámetros para la solicitud
BODY
auto_recurring
Datos de configuración para recurrencia.object
back_url
URL de retorno exitosa. Usa esta configuración para redirigir a tus clientes a tu sitio después de nuestro checkout. Solo se requiere para suscripciones sin plan asociado.string
REQUERIDO
card_token_id
card_token_id es un token generado al enviar el formulario con la captura de datos de pago. Al enviar el formulario, se genera un token que representa de forma segura los datos de la tarjeta. Para obtener el card_token_i...Ver másstring
external_reference
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.string
Parámetros de respuesta
id
Identificador único de suscripción.string
version
Cantidad de veces que esta suscripción fue modificada.number
application_id
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.number
collector_id
ID único que identifica a tu usuario como vendedor. Este ID coincide con tu User ID en nuestro ecosistema.number
Errores
400Error
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
400
Bad-Request
401Error
401
Unauthorized
401
Unauthorized
401
Unauthorized
401
Unauthorized
403Error
403
Forbidden
403
Forbidden
403
Forbidden
500Error
500
Error
¿Te sirvió esta información?
Sí
No
Solicitud
curl -X POST \
'https://api.mercadopago.com/preapproval'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
-d '{
"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",
"card_token_id": "e3ed6f098462036dd2cbabe314b9de2a",
"external_reference": "YG-1234",
"payer_email": "test_user@testuser.com",
"preapproval_plan_id": "2c938084726fca480172750000000000",
"reason": "Yoga classes",
"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"
}