Atualizar preferênciahttps://api.mercadopago.com/checkout/preferences/{id}
Atualizar os detalhes de uma preferência de pagamento. Digite o ID da preferência e envie as informações que você deseja atualizar.
PUT
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
The preference's IDstring
OBRIGATÓRIO
Body
items
Informações sobre o item.array
payer
Informações do comprador, como nome, sobrenome, e-mail, telefone, identificação pessoal, endereço e data de registro.object
payment_methods
Todas as configurações são relacionadas ao métodos de pagamento, como, por exemplo, métodos de pagamento excluídos, tipos de pagamento excluídos, método de pagamento padrão e taxas.object
shipments
Informações de envio.object
Response parameters
additional_info
Informações adicionaisstring
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. É obrigatório o uso do protocolo ("https") na URL.object
binary_mode
Quando o pagamento está ativado, só pode ser aprovado ou rejeitado. Caso contrário, o pagamento pode ficar pendente.boolean
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_date
invalid date of expiration.
invalid_expiration_date_from
expiration_date_from invalid.
invalid_items
unit_price invalid.
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 type (<type>) for field shipments.cost.
Request
curl -X PUT \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-d '{
"items": [
{
"id": "202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
"title": "Dummy Title",
"description": "Dummy Description",
"picture_url": "https://www.myapp.com/myimage.jpg",
"category_id": "cat123",
"quantity": 1,
"currency_id": "CLP",
"unit_price": 10
}
],
"payer": {
"email": "test_user_cl@testuser.com"
},
"shipments": {
"local_pickup": false,
"free_shipping": false
},
"auto_return": "approved",
"expires": false,
"expiration_date_from": "2022-11-17T09:37:52.000-04:00",
"expiration_date_to": "2022-11-17T10:37:52.000-05:00",
"marketplace_fee": 0
}'curl -X PUT \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-d '{
"items": [
{
"id": "202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
"title": "Dummy Title",
"description": "Dummy Description",
"picture_url": "https://www.myapp.com/myimage.jpg",
"category_id": "cat123",
"quantity": 1,
"currency_id": "CLP",
"unit_price": 10
}
],
"payer": {
"email": "test_user_cl@testuser.com"
},
"shipments": {
"local_pickup": false,
"free_shipping": false
},
"auto_return": "approved",
"expires": false,
"expiration_date_from": "2022-11-17T09:37:52.000-04:00",
"expiration_date_to": "2022-11-17T10:37:52.000-05:00",
"marketplace_fee": 0
}'curl -X PUT \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-d '{
"items": [
{
"id": "202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
"title": "Dummy Title",
"description": "Dummy Description",
"picture_url": "https://www.myapp.com/myimage.jpg",
"category_id": "cat123",
"quantity": 1,
"currency_id": "CLP",
"unit_price": 10
}
],
"payer": {
"email": "test_user_cl@testuser.com"
},
"shipments": {
"local_pickup": false,
"free_shipping": false
},
"auto_return": "approved",
"expires": false,
"expiration_date_from": "2022-11-17T09:37:52.000-04:00",
"expiration_date_to": "2022-11-17T10:37:52.000-05:00",
"marketplace_fee": 0
}'curl -X PUT \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-d '{
"items": [
{
"id": "202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
"title": "Dummy Title",
"description": "Dummy Description",
"picture_url": "https://www.myapp.com/myimage.jpg",
"category_id": "cat123",
"quantity": 1,
"currency_id": "CLP",
"unit_price": 10
}
],
"payer": {
"email": "test_user_cl@testuser.com"
},
"shipments": {
"local_pickup": false,
"free_shipping": false
},
"auto_return": "approved",
"expires": false,
"expiration_date_from": "2022-11-17T09:37:52.000-04:00",
"expiration_date_to": "2022-11-17T10:37:52.000-05:00",
"marketplace_fee": 0
}'curl -X PUT \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-d '{
"items": [
{
"id": "202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
"title": "Dummy Title",
"description": "Dummy Description",
"picture_url": "https://www.myapp.com/myimage.jpg",
"category_id": "cat123",
"quantity": 1,
"currency_id": "CLP",
"unit_price": 10
}
],
"payer": {
"email": "test_user_cl@testuser.com"
},
"shipments": {
"local_pickup": false,
"free_shipping": false
},
"auto_return": "approved",
"expires": false,
"expiration_date_from": "2022-11-17T09:37:52.000-04:00",
"expiration_date_to": "2022-11-17T10:37:52.000-05:00",
"marketplace_fee": 0
}'curl -X PUT \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-d '{
"items": [
{
"id": "202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
"title": "Dummy Title",
"description": "Dummy Description",
"picture_url": "https://www.myapp.com/myimage.jpg",
"category_id": "cat123",
"quantity": 1,
"currency_id": "CLP",
"unit_price": 10
}
],
"payer": {
"email": "test_user_cl@testuser.com"
},
"shipments": {
"local_pickup": false,
"free_shipping": false
},
"auto_return": "approved",
"expires": false,
"expiration_date_from": "2022-11-17T09:37:52.000-04:00",
"expiration_date_to": "2022-11-17T10:37:52.000-05:00",
"marketplace_fee": 0
}'curl -X PUT \
'https://api.mercadopago.com/checkout/preferences/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-d '{
"items": [
{
"id": "202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
"title": "Dummy Title",
"description": "Dummy Description",
"picture_url": "https://www.myapp.com/myimage.jpg",
"category_id": "cat123",
"quantity": 1,
"currency_id": "CLP",
"unit_price": 10
}
],
"payer": {
"email": "test_user_cl@testuser.com"
},
"shipments": {
"local_pickup": false,
"free_shipping": false
},
"auto_return": "approved",
"expires": false,
"expiration_date_from": "2022-11-17T09:37:52.000-04:00",
"expiration_date_to": "2022-11-17T10:37:52.000-05:00",
"marketplace_fee": 0
}'Response
{
"auto_return": "approved",
"back_urls": {},
"binary_mode": false,
"client_id": 6295877106812064,
"collector_id": 202809963,
"coupon_code": {},
"coupon_labels": {},
"date_created": "2018-02-02T19:22:23.535Z",
"date_of_expiration": {},
"expiration_date_from": "2022-11-17T09:37:52.000-04:00",
"expiration_date_to": "2022-11-17T10:37:52.000-05:00",
"expires": false,
"id": "202809963-920c288b-4ebb-40be-966f-700250fa5370",
"init_point": "https://www.mercadopago.com/mla/checkout/start?pref_id=202809963-920c288b-4ebb-40be-966f-700250fa5370",
"internal_metadata": {},
"items": [
{
"title": "Dummy Item",
"description": "Multicolor Item",
"currency_id": "CLP",
"quantity": 1,
"unit_price": 10
}
],
"marketplace": "MP-MKT-6295877106812064",
"marketplace_fee": 0,
"metadata": {},
"notification_url": "https://url.com.br/notificacao",
"payer": {
"phone": {},
"address": {
"street_name": "Mc Street",
"street_number": "7304"
},
"email": "test_user_cl@testuser.com",
"identification": {},
"last_purchase": {}
},
"payment_methods": {
"default_card_id": {},
"excluded_payment_methods": [
{
"id": ""
}
],
"excluded_payment_types": [
{
"id": ""
}
]
},
"processing_modes": {},
"product_id": {},
"redirect_urls": {},
"sandbox_init_point": "https://sandbox.mercadopago.com/mla/checkout/pay?pref_id=202809963-920c288b-4ebb-40be-966f-700250fa5370",
"site_id": "MLB",
"shipments": {
"default_shipping_method": {},
"receiver_address": {
"city_name": {},
"state_name": {}
}
},
"total_amount": {},
"last_updated": {},
"statement_descriptor": "MERCADOPAGO"
}