/preapproval

BASE URI https://api.mercadopago.com/preapproval

HTTP Request

curl

 curl --location --request POST 'https://api.mercadopago.com/preapproval?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
  "auto_recurring": {
    "currency_id": "ARS",
    "transaction_amount": 10,
    "frequency": 1,
    "frequency_type": "months",
    "end_date": "2022-07-20T11:59:52.581-04:00",
   
  },
  "back_url": "https://www.mercadopago.com.ar",
  "collector_id": 555435388,
  "external_reference": "1245AT234562",
  "payer_email": "test_user@testuser.com",
  "reason": "Suscripción particular",
  "status": "pending"
}' 

Request Params

ParameterTypeDescription
payer_email String E-mail del pagador.
back_url String url de retorno.
collector_id String Identificador de vendedor.
status String Estado de suscripción.
reason String Titulo de suscripción.
external_reference String Valor de referencia de suscripción.
auto_recurring Object Datos de recurrencia de suscripción.
frequency Integer Cantidad de dias de la recurrencia.
frequency_type String Tipo de recurrencia (dias o meses).
transaction_amount Number Monto de la suscripción.
currency_id String Identificador de moneda local.
start_date Date(ISO_8601) Fecha de inicio de suscripción.
end_date Date(ISO_8601) Fecha de fin de suscripción.

HTTP Response

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-02T09:07:14.260-04:00",
    "last_modified": "2020-06-02T09:07:14.263-04:00",
    "init_point": "https://www.mercadopago.com/[FAKER][GLOBALIZE][UPPER_SITE_ID]/debits/new?preapproval_id=2c938084726fca480172750000000000",
    "sandbox_init_point": "https://sandbox.mercadopago.com/[FAKER][GLOBALIZE][UPPER_SITE_ID]/debits/new?preapproval_id=2c938084726fca480172750000000000",
    "auto_recurring": {
        "frequency": 1,
        "frequency_type": "months",
        "transaction_amount": 10,
        "currency_id": "ARS",
        "start_date": "2020-06-02T09:07:14.260-04:00",
        "end_date": "2022-07-20T11:59:52.581-04:00"
    },
    "version": 0
} 

Error Codes

CodeDescription
400 BAD_REQUEST
Card token was used, please generate new El card token ya fue usado, se debe crear uno nuevo.
Card token was generated without cvv validation No se aceptan pagos sin cvv.
Subscriptions are not available for this country yet Aplicación de un site distinto a MLA o MLB o MLM.
The payment method account money is not available in your country No se pueden crear suscripciones con dinero en cuenta en tu país.
Collector and Application cannot be from different countries Se esta usando una aplicación que no corresponda al site del collector.
card_token_id is required Si la suscripción se crea con un template asociado el card token id es requerido.
payer_email is required El email del pagador es requerido.
Invalid value for payer_email, must be a valid email address El email del pagador es inválido.
Invalid value for transaction amount, must be a positive number El monto de la suscripción es inválido, debe ser un numero positivo.
Invalid value for transaction amount, only two decimals are allowed El 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_plan El monto de la suscripción y el del plan asociados, deben ser los mismos.
You cannot create a new preapproval from a cancelled/inactive template El plan o template asociado debe estar activo.
back_url is required La url de retorno es requerida.
Invalid value for back url, must be a valid URL La url de retorno es inválida, debe ser una url válida.
reason is required El título de la suscripción es requerido.
reason has more than 255 characters El título de la suscripción debe contener hasta 255 carácteres.
reason has unsupported characters El título de la suscripción tiene carácteres inválidos.
auto_recurring.frequency is required La frecuencia es requerida.
Invalid value for frequency, must be a positive integer La 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 required El tipo de la frecuencia es requerido.
auto_recurring.transaction_amount is required El monto de la suscripción es requerido.
auto_recurring.currency_id is required El identificador de moneda es requerido.
Invalid field -> auto_recurring.currency_id El identificador de la moneda es inválido.
Invalid value for auto_recurring.end_date, the date must be after today La fecha de fin de la suscripción debe ser mayor a la feha actual.
auto_recurring.end_date must be after auto_recurring.start_date La 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 today La fecha de inicio no puede ser mayor a la fecha actual.
Invalid format in auto_recurring.start_date or auto_recurring.end_date Las fechas deben tener un formato válido.
external_reference has more than 255 characters La referencia external debe contener hasta 255 carácteres.
external_reference has unsupported characters La 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 countries El pagador y el vendedor deben pertenecer al mismo site.
Payer and collector cannot be the same user El pagador y el vendedor deben ser usuarios diferentes.
Both payer and collector must be real or test users No se pueden combinar usuarios reales con usuarios de pruebas.
This preapproval cannot be created: The seller does not accept account_money El medio de pago dinero en cuenta no es soportado por el vendedor.
This preapproval cannot be created only with payment method account_money No se pueden crear una suscripción solo con dinero en cuenta.
You cannot create a preapproval with payment_method in status pending Una 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 data Datos de la suscripción inválidos.
401 UNAUTHORIZED
CC_VAL_433 Medio de pago rechazado, debe usar otro medio de pago.
Verification of collectors personal data is in process, come back later Se está analizando el vendedor desde KYC.
Unauthorized access to resource Access token no enviado o expirado.
This app cannot create preapprovals without a plan El preapproval debe tener auto recurring.
403 UNAUTHORIZED
The collector does not meet the personal data verification requirements El vendedor no realizó las validaciones de KYC.
The caller is not authorized to access this resource Se esta usando un preapproval que no es propio de ese vendedor.
AM_VAL_01 Unauthorized seller for this feature El collector debe estar en whitelist para usar el medio de pago dinero en cuenta.
404 NOT_FOUND
The preapproval with id ${preapproval id} does not exist La suscripción con id ${id} no existe.
Card token service not found Se esta usando un card token que no existe.

La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.