Create a subscription - Subscription Preferences

Create a subscription - Subscription Preferences - Mercado Pago Developers

Create a subscription

POST

/preapproval

Generate a subscription with all the settings you need.

Localization: bodyRecurring data

Localization: bodyReturn URL

Localization: bodySeller ID

Localization: bodyPreapproval reference value

Localization: bodyid

Localization: bodypayer_id

Localization: bodypayer_email

Localization: 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 newCard token was used, please generate new.

Card token was generated without cvv validationCard token was generated without cvv validation.

Subscriptions are not available for this country yetSubscriptions are not available for this country yet.

The payment method account money is not available in your countryThe payment method account money is not available in your country.

Collector and Application cannot be from different countriesCollector and Application cannot be from different countries.

card_token_id is requiredcard_token_id is required.

payer_email is requiredpayer_email is required.

Invalid value for payer_email, must be a valid email addressInvalid value for payer_email, must be a valid email address.

Invalid value for transaction amount, must be a positive numberInvalid value for transaction amount, must be a positive number.

Invalid value for transaction amount, only two decimals are allowedInvalid value for transaction amount, only two decimals are allowed.

Cannot pay an amount lower than ${currency_id} ${min amount}Cannot pay an amount lower than ${currency_id} ${min amount}.

Cannot pay an amount greater than ${currency_id} ${max amount}Cannot pay an amount greater than ${currency_id} ${max amount}.

The transaction_amount must be the same as preapproval_planThe transaction_amount must be the same as preapproval_plan.

You cannot create a new preapproval from a cancelled/inactive templateYou cannot create a new preapproval from a cancelled/inactive template.

back_url is requiredback_url is required.

Invalid value for back url, must be a valid URLInvalid value for back url, must be a valid URL.

reason is requiredreason is required.

reason has more than 255 charactersreason has more than 255 characters.

reason has unsupported charactersreason has unsupported characters.

auto_recurring.frequency is requiredauto_recurring.frequency is required.

Invalid value for frequency, must be a positive integerInvalid value for frequency, must be a positive integer.

Invalid value for frequency type, valid ones are [days, months]Invalid value for frequency type, valid ones are [days, months].

auto_recurring.frequency_type is requiredauto_recurring.frequency_type is required.

auto_recurring.transaction_amount is requiredauto_recurring.transaction_amount is required.

auto_recurring.currency_id is requiredauto_recurring.currency_id is required.

Invalid field -> auto_recurring.currency_idInvalid field -> auto_recurring.currency_id.

Invalid value for auto_recurring.end_date, the date must be after todayInvalid value for auto_recurring.end_date, the date must be after today.

auto_recurring.end_date must be after auto_recurring.start_dateauto_recurring.end_date must be after auto_recurring.start_date.

Invalid value for auto_recurring.start_date, the date must be after todayInvalid value for auto_recurring.start_date, the date must be after today.

Invalid format in auto_recurring.start_date or auto_recurring.end_dateInvalid format in auto_recurring.start_date or auto_recurring.end_date.

external_reference has more than 255 charactersexternal_reference has more than 255 characters.

external_reference has unsupported charactersexternal_reference has unsupported characters.

Already exists a preapproval for user ${payer_email} and application ${application_id}Already exists a preapproval for user ${payer_email} and application ${application_id}.

Cannot operate between different countriesCannot operate between different countries.

Payer and collector cannot be the same userPayer and collector cannot be the same user.

Both payer and collector must be real or test usersBoth payer and collector must be real or test users.

This preapproval cannot be created: The seller does not accept account_moneyThis preapproval cannott be created. The seller does not accept account_money.

This preapproval cannot be created only with payment method account_moneyThis preapproval can't be created only with payment method account_money.

You cannot create a preapproval with payment_method in status pendingYou cannot create a preapproval with payment_method in status pending.

Cannot create preapproval pending, the feature with account money is disabled for your country.Cannot create preapproval pending, the feature with account money is disabled for your country.

Invalid request dataInvalid request data.

401bad_request

CC_VAL_433CC_VAL_433 Credit card validation has failed.

Verification of collectors personal data is in process, come back laterVerification of collector's personal data is in process, come back later.

Unauthorized access to resourceUnauthorized access to resource.

This app cannot create preapprovals without a planThis app can't create preapprovals without a plan.

403bad_request

The collector does not meet the personal data verification requirementsThe collector does not meet the personal data verification requirements.

The caller is not authorized to access this resourceThe caller is not authorized to access this resource.

AM_VAL_01 Unauthorized seller for this featureAM_VAL_01 Unauthorized seller for this feature (account money) .

404bad_request

The preapproval with id ${preapproval id} does not existThe preapproval with id ${preapproval id} does not exist.

Card token service not foundCard token service not found.

Was this information helpful?