Crear una suscripción - Preferencia de Subscripción - Mercado Pago Developers
Developers
Referencia de API
Soporte
Ingresar

    Introducción

    LISTA DE API

    Preferencias

    Crear una preferencia

    POST

    Buscar preferencias

    GET

    Obtener una preferencia

    GET

    Actualizar una preferencia

    PUT

    Tipos de documento

    Obtener tipos de documentos

    GET

    Medios de pago

    Obtener los medios de pago

    GET

    Pagos

    Crear un pago

    POST

    Buscar pagos

    GET

    Obtener un pago

    GET

    Actualizar un pago

    PUT

    Contracargos

    Obtener un contracargo

    GET

    Clientes

    Crear un cliente

    POST

    Buscar clientes

    GET

    Obtener un cliente

    GET

    Actualizar un cliente

    PUT

    Tarjetas

    Guardar una tarjeta

    POST

    Obtener tarjetas de un cliente

    GET

    Obtener una tarjeta

    GET

    Actualizar una tarjeta

    PUT

    Eliminar una tarjeta

    DELETE

    Sucursales

    Obtener una Sucursal

    GET

    Crear una Sucursal

    POST

    Buscar sucursales

    GET

    Actualizar una Sucursal

    PUT

    Eliminar una Sucursal

    DELETE

    Cajas

    Crear una Caja

    POST

    Buscar cajas

    GET

    Obtener una Caja

    GET

    Actualizar una Caja

    PUT

    Eliminar una Caja

    DELETE

    Órdenes presenciales

    Crear una orden

    POST

    Eliminar una orden

    DELETE

    Órdenes presenciales v2

    Crear una orden

    PUT

    Obtener una orden

    GET

    Eliminar una orden

    DELETE

    Órdenes

    Crear una orden

    POST

    Buscar órdenes

    GET

    Obtener una orden

    GET

    Actualizar una orden

    PUT

    Preferencia de Subscripción

    Crear una suscripción

    POST

Crear una suscripción

POST

/preapproval
Genera una suscripción con todas las configuraciones que necesites.
Productos que lo utilizan:
Suscripciones
Parámetros para la solicitud
auto_recurring
object
Localización: bodyDatos de recurrencia de suscripción
back_url
string
Localización: bodyurl de retorno
collector_id
string
Localización: bodyIdentificador de vendedor
external_reference
string
Localización: bodyValor de referencia de suscripción
Parámetros de respuesta
id
string
Localización: bodyid
payer_id
number
Localización: bodypayer_id
payer_email
string
Localización: bodypayer_email
back_url
string
Localización: bodyback_url
Solicitud
curl
curl -X POST \
    'https://api.mercadopago.com/preapproval' \
    -H 'Authorization: Bearer ACCESS_TOKEN_ENV' \ 
    -d '{
  "auto_recurring": {
    "frequency": 1,
    "frequency_type": "months",
    "transaction_amount": 10,
    "currency_id": "ARS",
    "start_date": "2020-06-02T13:07:14.260Z",
    "end_date": "2022-07-20T15:59:52.581Z"
  },
  "back_url": "https://www.mercadopago.com.ar",
  "external_reference": 23546246234,
  "payer_email": "test_user@testuser.com"
}'
Respuesta
json
{
  "id": "2c938084726fca480172750000000000",
  "payer_id": 123123123,
  "payer_email": "test_user@testuser.com",
  "back_url": "https://www.mercadopago.com.ar",
  "collector_id": 100200300,
  "application_id": 1234567812345678,
  "status": "pending",
  "reason": "Suscripcion Particular",
  "external_reference": 23546246234,
  "date_created": "2020-06-02T13:07:14.260Z",
  "last_modified": "2020-06-02T13:07:14.263Z",
  "init_point": "https://www.mercadopago.com/MLB/debits/new?preapproval_id=2c938084726fca480172750000000000",
  "sandbox_init_point": "https://sandbox.mercadopago.com/MLB/debits/new?preapproval_id=2c938084726fca480172750000000000",
  "auto_recurring": {
    "frequency": 1,
    "frequency_type": "months",
    "transaction_amount": 10,
    "currency_id": "ARS",
    "start_date": "2020-06-02T13:07:14.260Z",
    "end_date": "2022-07-20T15:59:52.581Z"
  },
  "version": 0
}
Errores
400bad_request
Card token was used, please generate newEl card token ya fue usado, se debe crear uno nuevo.
Card token was generated without cvv validationNo se aceptan pagos sin cvv.
Subscriptions are not available for this country yetAplicación de un site distinto a MLA o MLB o MLM.
The payment method account money is not available in your countryNo se pueden crear suscripciones con dinero en cuenta en tu país.
Collector and Application cannot be from different countriesSe esta usando una aplicación que no corresponda al site del collector.
card_token_id is requiredSi la suscripción se crea con un template asociado el card token id es requerido.
payer_email is requiredEl email del pagador es requerido.
Invalid value for payer_email, must be a valid email addressEl email del pagador es inválido.
Invalid value for transaction amount, must be a positive numberEl monto de la suscripción es inválido, debe ser un numero positivo.
Invalid value for transaction amount, only two decimals are allowedEl monto de la suscripción es inválido, se permiten solo 2 decimales.
Cannot pay an amount lower than ${currency_id} ${min amount}El monto de la suscripción es inválido, es menor el limite para el país.
Cannot pay an amount greater than ${currency_id} ${max amount}El monto de la suscripción es inválido, es mayor el limite para el país.
The transaction_amount must be the same as preapproval_planEl monto de la suscripción y el del plan asociados, deben ser los mismos.
You cannot create a new preapproval from a cancelled/inactive templateEl plan o template asociado debe estar activo.
back_url is requiredLa url de retorno es requerida.
Invalid value for back url, must be a valid URLLa url de retorno es inválida, debe ser una url válida.
reason is requiredEl título de la suscripción es requerido.
reason has more than 255 charactersEl título de la suscripción debe contener hasta 255 carácteres.
reason has unsupported charactersEl título de la suscripción tiene carácteres inválidos.
auto_recurring.frequency is requiredLa frecuencia es requerida.
Invalid value for frequency, must be a positive integerLa frecuencia debe ser un valor positivo.
Invalid value for frequency type, valid ones are [days, months]El tipo de la frecuencia debe ser días o meses.
auto_recurring.frequency_type is requiredEl tipo de la frecuencia es requerido.
auto_recurring.transaction_amount is requiredEl monto de la suscripción es requerido.
auto_recurring.currency_id is requiredEl identificador de moneda es requerido.
Invalid field -> auto_recurring.currency_idEl identificador de la moneda es inválido.
Invalid value for auto_recurring.end_date, the date must be after todayLa fecha de fin de la suscripción debe ser mayor a la feha actual.
auto_recurring.end_date must be after auto_recurring.start_dateLa fecha de fin de la suscripción no puede ser menor a la fecha de inicio.
Invalid value for auto_recurring.start_date, the date must be after todayLa fecha de inicio no puede ser mayor a la fecha actual.
Invalid format in auto_recurring.start_date or auto_recurring.end_dateLas fechas deben tener un formato válido.
external_reference has more than 255 charactersLa referencia external debe contener hasta 255 carácteres.
external_reference has unsupported charactersLa referencia externa posee carácteres inválidos.
Already exists a preapproval for user ${payer_email} and application ${application_id}No puede haber más de una suscripción para el mismo pagador, debes cancelar el anterior.
Cannot operate between different countriesEl pagador y el vendedor deben pertenecer al mismo site.
Payer and collector cannot be the same userEl pagador y el vendedor deben ser usuarios diferentes.
Both payer and collector must be real or test usersNo se pueden combinar usuarios reales con usuarios de pruebas.
This preapproval cannot be created: The seller does not accept account_moneyEl medio de pago dinero en cuenta no es soportado por el vendedor.
This preapproval cannot be created only with payment method account_moneyNo se pueden crear una suscripción solo con dinero en cuenta.
You cannot create a preapproval with payment_method in status pendingUna suscripciones que se crea poendiente no puede tener un medio de pago asociado.
Cannot create preapproval pending, the feature with account money is disabled for your country.Momentanemente no se pueden crear suscripciones pendientes en tu país.
Invalid request dataDatos de la suscripción inválidos.
401bad_request
CC_VAL_433Medio de pago rechazado, debe usar otro medio de pago.
Verification of collectors personal data is in process, come back laterSe está analizando el vendedor desde KYC.
Unauthorized access to resourceAccess token no enviado o expirado.
This app cannot create preapprovals without a planEl preapproval debe tener auto recurring.
403bad_request
The collector does not meet the personal data verification requirementsEl vendedor no realizó las validaciones de KYC.
The caller is not authorized to access this resourceSe esta usando un preapproval que no es propio de ese vendedor.
AM_VAL_01 Unauthorized seller for this featureEl collector debe estar en whitelist para usar el medio de pago dinero en cuenta.
404bad_request
The preapproval with id ${preapproval id} does not existLa suscripción con id ${id} no existe.
Card token service not foundSe esta usando un card token que no existe.
¿Te resultó útil esta información?

Copyright © 2021 Mercado Pago Colombia Ltda.

Términos y condicionesCómo cuidamos tu privacidad
Partners Mercado Pago

Al navegar en este sitio aceptas las cookies que utilizamos para mejorar tu experiencia. Más información.