Crear una suscripción - Preferencia de Subscripción

Crear una suscripción - Preferencia de Subscripción - Mercado Pago Developers

Crear una suscripción

POST

/preapproval

Genera una suscripción con todas las configuraciones que necesites.

Localización: bodyDatos de recurrencia de suscripción

Localización: bodyurl de retorno

Localización: bodyIdentificador de vendedor

Localización: bodyValor de referencia de suscripción

Localización: bodyid

Localización: bodypayer_id

Localización: bodypayer_email

Localización: bodyback_url

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"
}'

{
  "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
}

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?