/checkout/preferences/:id
BASE URI https://api.mercadopago.com/checkout/preferences/{id}
HTTP Request
curl
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/:id' \
-H 'Authorization: Bearer ACCESS_TOKEN_ENV'
Request Params
ParameterTypeDescription
id
String(UUID)
Preference ID.
HTTP Response
json
{
"additional_info": "",
"auto_return": "",
"back_urls": {
"failure": "",
"pending": "",
"success": ""
},
"client_id": "6295877106812064",
"collector_id": 202809963,
"date_created": "2018-02-02T15:18:51.150-04:00",
"expiration_date_from": null,
"expiration_date_to": null,
"expires": false,
"external_reference": "",
"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": "[FAKER][CURRENCY][ACRONYM]",
"title": "Practical Granite Shirt",
"picture_url": "http://placehold.it/350x150",
"description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ultricies est sed elit interdum, quis consectetur libero mollis. Phasellus posuere sed eros vel volutpat.",
"category_id": "",
"quantity": 2,
"unit_price": 14.5
}
],
"marketplace": "MP-MKT-6295877106812064",
"marketplace_fee": 0,
"notification_url": null,
"statement_descriptor": "MERCADOPAGO",
"operation_type": "regular_payment",
"payer": {
"phone": {
"area_code": "",
"number": "631.586.0213"
},
"address": {
"zip_code": "76336",
"street_name": "Marjory Stream",
"street_number": "941"
},
"email": "",
"identification": {
"number": "12345678",
"type": "DNI"
},
"name": "",
"surname": "",
"date_created": ""
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
},
"sandbox_init_point": "https://sandbox.mercadopago.com/mla/checkout/pay?pref_id=202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
"shipments": {
"receiver_address": {
"floor": "",
"zip_code": "",
"street_name": "",
"apartment": "",
"street_number": null
}
}
}
Error Codes
CodeDescription
400 bad_request
invalid_collector_id
collector_id must be a number.
invalid_collector_id
collector_id invalid.
invalid_sponsor_id
sponsor_id not found.
invalid_sponsor_id
sponsor_id must be a number.
invalid_sponsor_id
sponsor_id should be different than collector_id.
invalid_sponsor_id
sponsor_id site must be the same as collector_id.
invalid_sponsor_id
sponsor_id didn't accept Mercado Pago's Terms and Conditions.
invalid_sponsor_id
sponsor_id is not an active user.
invalid_collector_email
collector is not collector_email(secure) owner.
invalid_collector_email
collector is not collector_email owner.
invalid_operation_type
operation_type invalid.
invalid_expiration_date_to
expiration_date_to invalid.
invalid_expiration_date_from
expiration_date_from invalid.
invalid_items
amount cannot be paid with Mercado Pago.
invalid_items
items needed.
invalid_items
items invalid. Wrong format.
invalid_items
currency_id needed.
invalid_items
currency_id invalid.
invalid_items
quantity needed.
invalid_items
quantity must be a number.
invalid_items
unit_price needed.
invalid_items
unit_price must be a number.
invalid_items
unit_price invalid.
invalid_payer
payer invalid. Wrong format.
invalid_payer
payer name invalid. Max length 100.
invalid_payer
payer surname invalid. Max length 100.
invalid_payer
payer email invalid. Max length 150.
invalid_back_urls
back_urls invalid. Wrong format.
invalid_payment_methods
payment_methods invalid. Wrong format.
invalid_payment_methods
amount cannot be paid with Mercado Pago.
invalid_payment_methods
excluded_payment_methods invalid. Wrong format.
invalid_payment_methods
id needed.
invalid_payment_methods
account_money cannot be excluded.
invalid_payment_methods
cannot exclude all payments methods.
invalid_payment_methods
excluded_payment_types invalid. Wrong format.
invalid_payment_methods
cannot exclude all payments types.
invalid_payment_methods
client_id invalid.
invalid_payment_methods
client_id must be a number.
invalid_payment_methods
installments invalid. Should be a number between 1 and 36.
invalid_marketplace_fee
marketplace_fee must be a number.
invalid_marketplace_fee
marketplace_fee must be a positive number.
invalid_marketplace_fee
marketplace_fee must not be greater than total amount.
invalid_id
preference_id not found.
invalid_access_token
access denied.
invalid_shipments
invalid shipment mode.
invalid_shipments
collector doesn't have me2 active.
invalid_shipments
shipments.dimensions invalid.
invalid_shipments
shipments.free_methods invalid.
invalid_shipments
shipments.free_methods ID must be a number.
invalid_shipments
invalid free_methods.
invalid_shipments
shipments.local_pickup invalid.
invalid_shipments
shipments.default_shipping_method must be a number.
invalid_shipments
invalid shipments.default_shipping_method.
invalid_shipments
shipments.free_shipping invalid.
invalid_shipments
shipments.cost must be a number.
invalid_shipments
shipments.cost invalid.
invalid_shipments
Invalid dimensions format.
invalid_shipments
Invalid dimension values.
invalid_shipments
Invalid total amount, with me2 it cannot be lesser than .