/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)
Identificador de preferencia.
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 debe ser un número.
invalid_collector_id
collector_id inválido.
invalid_sponsor_id
No se ha encontrado el sponsor_id.
invalid_sponsor_id
sponsor_id debe ser un número.
invalid_sponsor_id
El parámetro sponsor_id debe ser distinto del parámetro collector_id.
invalid_sponsor_id
El site del parámetro sponsor_id debe ser el mismo que el parámetro collector_id.
invalid_sponsor_id
El sponsor_id no aceptó los términos y condiciones de Mercado Pago.
invalid_sponsor_id
El sponsor_id no es un usuario activo.
invalid_collector_email
collector is not collector_email(secure) owner.
invalid_collector_email
El collector no es dueño del collector_email.
invalid_operation_type
operation_type inválido.
invalid_expiration_date_to
expiration_date_to inválido.
invalid_expiration_date_from
expiration_date_from inválido.
invalid_items
El monto no puede ser pagado con Mercado Pago.
invalid_items
ítems requeridos.
invalid_items
ítems inválidos, error de formato.
invalid_items
currency_id es requerido.
invalid_items
currency_id inválido.
invalid_items
El parámetro quantity es requerido.
invalid_items
El parámetro quantity debe ser un número.
invalid_items
El parámetro unit_price es requerido.
invalid_items
unit_price debe ser un número.
invalid_items
unit_price inválido.
invalid_payer
payer inválido, error de formato.
invalid_payer
Nombre del comprador inválido, la longitud máxima es 100 caracteres.
invalid_payer
Apellido del comprador inválido, la longitud máxima es 100 caracteres.
invalid_payer
Email del comprador inválido, la longitud máxima es 150 caracteres.
invalid_back_urls
back_urls inválido, error de formato.
invalid_payment_methods
payment_methods inválido, error de formato.
invalid_payment_methods
El monto no puede ser pagado con Mercado Pago.
invalid_payment_methods
excluded_payment_methods inválido, error de formato.
invalid_payment_methods
Identificador de pago requerido.
invalid_payment_methods
account_money no puede ser excluído.
invalid_payment_methods
No es posible excluir todos los payments methods.
invalid_payment_methods
excluded_payment_types inválido, error de formato.
invalid_payment_methods
No es posible excluir todos los payments types.
invalid_payment_methods
client_id inválido.
invalid_payment_methods
client_id debe ser un número.
invalid_payment_methods
installments no válidas. Debe ser un número entre 1 y 36.
invalid_marketplace_fee
marketplace_fee debe ser un número.
invalid_marketplace_fee
marketplace_fee debe ser un número positivo.
invalid_marketplace_fee
marketplace_fee no puede ser mayor al monto total.
invalid_id
preference_id no encontrado.
invalid_access_token
Acceso denegado.
invalid_shipments
Método de envío inválido.
invalid_shipments
El collector no tiene Mercado Envíos activo.
invalid_shipments
shipments.dimensions inválido.
invalid_shipments
shipments.free_methods inválido.
invalid_shipments
shipments.free_methods ID debe ser un número.
invalid_shipments
free_methods inválidos.
invalid_shipments
shipments.local_pickup inválido.
invalid_shipments
shipments.default_shipping_method debe ser un número.
invalid_shipments
shipments.default_shipping_method inválido.
invalid_shipments
shipments.free_shipping inválido.
invalid_shipments
shipments.cost debe ser un número.
invalid_shipments
shipments.cost inválido.
invalid_shipments
Formato de dimensiones inválido.
invalid_shipments
Dimensión inválida.
invalid_shipments
Monto total inválido, con Mercado Envíos no puede ser menor a .