Obter preferênciahttps://api.mercadopago.com/checkout/preferences/{id}
Veja todas as informações de pagamento de um produto ou serviço com a identificação da preferência desejada
GET
Request parameters
Header
Authorization
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.string
OBRIGATÓRIO
Path
id
Identificação de preferência.string
OBRIGATÓRIO
Response parameters
additional_info
Informações adicionais.string
auto_return
No caso de estar especificado, o comprador será redirecionado para o site do vendedor automaticamente após a compra aprovada com cartão de crédito.String
approved: O redirecionamento ocorre apenas para pagamentos aprovados com cartão de crédito.
all: O redirecionamento ocorre apenas para pagamentos aprovados com cartão de crédito, compatibilidade futura somente se alterarmos o comportamento padrão.
back_urls
URLs de retorno ao site do vendedor, automaticamente ("auto_return") ou através do botão 'Voltar ao site', segundo o status do pagamento.object
client_id
ID exclusivo usado para identificar o cliente. Obtido das credenciais usadas para criar a preferência. É o Application ID.string
Erros
400Erro
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": {}
}
}