Qual documentação você quer buscar?
Não sabe como começar a integrar?
Acesse os primeiros passosObter preferência
GET
Produtos relacionados:
Parâmetros de requisição
PATH
id
Identificação de preferênciastring
OBRIGATÓRIO
Parâmetros de resposta
additional_info
Informações adicionaisstring
auto_return
No caso de estar especificado o comprador será redirecionado para o seu site imediatamente após a compraString
approved: O redirecionamento ocorre apenas para pagamentos aprovados.
all: O redirecionamento ocorre apenas para pagamentos aprovados, compatibilidade futura somente se alterarmos o comportamento padrão.
back_urls
Url de retorno ao site do vendedorobject
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>.
Essa informação foi útil?
Sim
Não
Requisição
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-5599*********291-02171*********139a4791e*********f7f5835-1*********' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-5599*********291-02171*********139a4791e*********f7f5835-1*********' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-5599*********291-02171*********139a4791e*********f7f5835-1*********' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-5599*********291-02171*********139a4791e*********f7f5835-1*********' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-5599*********291-02171*********139a4791e*********f7f5835-1*********' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-5599*********291-02171*********139a4791e*********f7f5835-1*********' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-5599*********291-02171*********139a4791e*********f7f5835-1*********' \
Resposta de exemplo
{
"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": {}
}
}