Get preference/checkout/preferences/{id}Check all the payment information for a product or service with the ID of the preference of your choice.
GET
Products that use it:
Request's parameters
idstring
Localization: pathPreference ID.REQUIRED
Response parameters
additional_info
Localization: bodyAdditional information.string
auto_return
Localization: bodyIf specified, your buyers will be redirected back to your site immediately after completing the purchase.String
approved: The redirection takes place only for approved payments.
all: The redirection takes place only for approved payments, forward compatibility only if we change the default behavior
back_urls
Localization: bodyURLs to return to the sellers website.object
client_id
Localization: bodyUnique ID used to identify the client. It is obtained from the credentials used to create the preference. It´s the application ID.string
Request
curl
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
Answer
json
{
"back_urls": {},
"client_id": 6295877106812064,
"collector_id": 202809963,
"date_created": "2018-02-02T19:18:51.150Z",
"id": "202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
"init_point": "https://www.mercadopago.com/mla/checkout/start?pref_id=202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
"items": [
{
"id": "item-ID-1234",
"currency_id": "$",
"title": "Practical Granite Shirt",
"picture_url": "http://placehold.it/350x150",
"description": "This is my description",
"quantity": 2,
"unit_price": 14.5
}
],
"marketplace": "MP-MKT-6295877106812064",
"marketplace_fee": 0,
"statement_descriptor": "MERCADOPAGO",
"payer": {
"phone": {
"number": "631.586.0213"
},
"address": {
"zip_code": 76336,
"street_name": "Marjory Stream",
"street_number": 941
},
"identification": {
"number": 12345678,
"type": "DNI"
}
},
"payment_methods": {
"excluded_payment_methods": [
{}
],
"excluded_payment_types": [
{}
]
},
"sandbox_init_point": "https://sandbox.mercadopago.com/mla/checkout/pay?pref_id=202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
"shipments": {
"receiver_address": {}
}
}
Errors
400bad_request
invalid_collector_id
invalid_sponsor_idsponsor_id is not an active user.
invalid_collector_emailcollector is not collector_email owner.
invalid_operation_typeoperation_type invalid.
invalid_expiration_date_toexpiration_date_to invalid.
invalid_expiration_date_fromexpiration_date_from invalid.
invalid_itemsunit_price invalid.
invalid_payerpayer email invalid. Max length 150.
invalid_back_urlsback_urls invalid. Wrong format.
invalid_payment_methodsinstallments invalid. Should be a number between 1 and 36.
invalid_marketplace_feemarketplace_fee must not be greater than total amount.
invalid_idpreference_id not found.
invalid_access_tokenaccess denied.
invalid_shipmentsInvalid total amount, with me2 it cannot be lesser than <limit>.