Obter preferência - Preferências - Mercado Pago Developers
Obter preferência

GET

/checkout/preferences/{id}
Veja todas as informações de pagamento de um produto ou serviço com a identificação da preferência desejada.
Parâmetros de requisição
id

OBRIGATÓRIO

string
Localização: pathIdentificação de preferência
Parâmetros de resposta
additional_info
string
Localização: bodyInformações adicionais
auto_return
String
Localização: bodyNo caso de estar especificado o comprador será redirecionado para o seu site imediatamente após a compra
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
object
Localização: bodyUrl de retorno ao site do vendedor
client_id
string
Localização: bodyID exclusivo usado para identificar o cliente. Obtido das credenciais usadas para criar a preferência. É o Application ID.
Solicitação
curl
curl -X GET \
    'https://api.mercadopago.com/checkout/preferences/{id}' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' 
Resposta
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": {}
  }
}
Erros
400bad_request
invalid_collector_idinvalid_collector_id--collector_id invalid.
invalid_sponsor_idinvalid_sponsor_id--sponsor_id is not an active user.
invalid_collector_emailinvalid_collector_email--collector is not collector_email owner.
invalid_operation_typeinvalid_operation_type--operation_type invalid.
invalid_expiration_date_toinvalid_expiration_date_to--expiration_date_to invalid.
invalid_expiration_date_frominvalid_expiration_date_from--expiration_date_from invalid.
invalid_itemsinvalid_items--unit_price invalid.
invalid_payerinvalid_payer--payer email invalid. Max length 150.
invalid_back_urlsinvalid_back_urls--back_urls invalid. Wrong format.
invalid_payment_methodsinvalid_payment_methods--installments invalid. Should be a number between 1 and 36.
invalid_marketplace_feeinvalid_marketplace_fee--marketplace_fee must not be greater than total amount.
invalid_idinvalid_id--preference_id not found.
invalid_access_tokeninvalid_access_token--access denied.
invalid_shipmentsinvalid_shipments--Invalid total amount, with me2 it cannot be lesser than <limit>.