Obtener preferenciahttps://api.mercadopago.com/checkout/preferences/{id}
Consulta toda la información de pago de un producto o servicio con el ID de la preferencia que quieras
GET
Request parameters
Header
Authorization
Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.string
REQUERIDO
Path
id
Identificador de preferencia.string
REQUERIDO
Response parameters
additional_info
Información adicional.string
auto_return
En el caso de estar especificado, el comprador será redirigido automáticamente al sitio del vendedor después de que la compra sea aprobada con tarjeta de crédito.String
approved: El redireccionamiento solo ocurre para pagos aprobados con tarjeta de crédito.
all: El redireccionamiento se realiza únicamente para pagos aprobados con tarjeta de crédito, compatibilidad con versiones posteriores solo si cambiamos el comportamiento predeterminado.
back_urls
URLs de retorno al sitio del vendedor, ya sea automáticamente ("auto_return") o a través del botón 'Volver al sitio', según el estado del pago.object
client_id
ID único utilizada para identificar al cliente. Se obtiene a partir de las credenciales utilizadas para crear la preferencia. Es el Application ID.string
Errors
400Error
invalid_collector_id
collector_id invalid.
invalid_sponsor_id
sponsor_id is not an active user.
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
unit_price invalid.
invalid_payer
payer email invalid. Max length 150.
invalid_back_urls
back_urls invalid. Wrong format.
invalid_payment_methods
installments invalid. Should be a number between 1 and 36.
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 total amount, with me2 it cannot be lesser than <limit>.
Request
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
Response
{
"auto_return": "approved",
"back_urls": {},
"client_id": 6295877106812064,
"collector_id": 202809963,
"date_created": "2022-11-17T09:37:52.000-04:00",
"expiration_date_from": "2022-11-17T09:37:52.000-04:00",
"expiration_date_to": "2022-11-17T10:37:52.000-05:00",
"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": "CLP",
"title": "Practical Granite Shirt",
"picture_url": "https://placehold.it/350x150",
"description": "This is my description",
"quantity": 2,
"unit_price": 14
}
],
"marketplace": "MP-MKT-6295877106812064",
"marketplace_fee": 0,
"statement_descriptor": "MERCADOPAGO",
"payer": {
"phone": {
"number": "2234-5678"
},
"address": {
"zip_code": "7550000",
"street_name": "Marjory Stream",
"street_number": 941
},
"identification": {
"number": 12345678,
"type": "RUT"
}
},
"payment_methods": {
"excluded_payment_methods": [
{}
],
"excluded_payment_types": [
{}
]
},
"preference_expired": true,
"sandbox_init_point": "https://sandbox.mercadopago.com/mla/checkout/pay?pref_id=202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
"shipments": {
"receiver_address": {}
}
}