Which documentation are you looking for?
Do not know how to start integrating?
Check the first stepsCreate a subscription
POST
Products that use it:
Request's parameters
BODY
auto_recurring
Configuration data for recurrence.object
back_url
Successful return url. Use this setting to redirect your customers to your site after our checkout. It is only required for subscriptions without a plan.string
REQUIRED
card_token_id
The card_token_id is a token generated from the form submission with the capture of payment data. When submitting the form, a token is generated that securely represents the card data. To get the card_token_id, see the "...Ver másstring
REQUIRED
external_reference
Reference to sync with your system. This is a free text field to help you with your integration to link the entities. It is only required for subscriptions without a plan.string
Response parameters
id
Unique subscription identifier.string
version
How many times the subscription was modified.number
application_id
Unique ID that identifies your application/integration. One of the keys in the pair that make up the credentials that identify an application/integration in your account.number
collector_id
Unique ID that identifies your user as a seller. This ID matches your User ID in our ecosystem.number
Errors
400Error
400
Bad-Request
401Error
401
Unauthorized
403Error
403
Forbidden
500Error
500
Error
Did you find this information useful?
Yes
No
Request
curl -X POST \
'https://api.mercadopago.com/preapproval'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-8971*********918-01191*********5874530a4*********4799fdf-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"
}'Sample answer
{
"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"
}