Atualizar uma preferência - Preferências - Mercado Pago Developers
Developers
Referência API
Suporte
Entrar

    Introdução

    LISTA DE API

    Preferências

    Criar uma preferência

    POST

    Pesquisar preferências

    GET

    Obter uma preferência

    GET

    Atualizar uma preferência

    PUT

    Tipos de documento

    Obter tipos de documentos

    GET

    Meios de pagamento

    Obter meios de pagamento

    GET

    Pagamentos

    Criar um pagamento

    POST

    Pesquisar pagamentos

    GET

    Obter um pagamento

    GET

    Atualizar um pagamento

    PUT

    Estornos

    Obter um estorno

    GET

    Clientes

    Criar um cliente

    POST

    Pesquisar clientes

    GET

    Obter um cliente

    GET

    Atualizar um cliente

    PUT

    Cartões

    Salvar um cartão

    POST

    Obter cartões de um cliente

    GET

    Obter um cartão

    GET

    Atualizar um cartão

    PUT

    Excluir um cartão

    DELETE

    Lojas

    Obter uma Loja

    GET

    Criar uma Loja

    POST

    Pesquisar lojas

    GET

    Atualizar uma Loja

    PUT

    Excluir uma Loja

    DELETE

    Caixa

    Criar um Caixa

    POST

    Pesquisar caixas

    GET

    Obter um Caixa

    GET

    Atualizar um Caixa

    PUT

    Excluir um Caixa

    DELETE

    Ordens presenciais

    Criar uma ordem

    POST

    Excluir uma ordem

    DELETE

    Ordens presenciais v2

    Criar uma ordem

    PUT

    Obter uma ordem

    GET

    Excluir uma ordem

    DELETE

    Ordens

    Criar uma ordem

    POST

    Pesquisar ordens

    GET

    Obter uma ordem

    GET

    Atualizar uma ordem

    PUT

    Preferência de assinatura

    Criar uma assinatura

    POST

Atualizar uma preferência

PUT

/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.
Produtos relacionados:
Checkout Pro
Marketplace
Mobile Checkout
Parâmetros de requisição
id

OBRIGATÓRIO

string
Localização: pathThe preference's ID
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
Parâmetros de resposta
additional_info
string
Localização: bodyadditional_info
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: bodyback_urls
binary_mode
boolean
Localização: body
Solicitação
curl
curl -X PUT \
    'https://api.mercadopago.com/checkout/preferences/{id}' \
    -H 'Authorization: Bearer ACCESS_TOKEN_ENV' \ 
    -d '{
  "items": [
    {
      "id": "202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
      "title": "Dummy Title",
      "description": "Dummy Description",
      "picture_url": "http://www.myapp.com/myimage.jpg",
      "category_id": "cat123",
      "quantity": 1,
      "currency_id": "U$",
      "unit_price": 10
    }
  ],
  "payer": {
    "phone": {},
    "identification": {},
    "address": {}
  },
  "payment_methods": {
    "excluded_payment_methods": [
      {}
    ],
    "excluded_payment_types": [
      {}
    ]
  },
  "shipments": {
    "free_methods": [
      {}
    ],
    "receiver_address": {}
  },
  "back_urls": {},
  "differential_pricing": {}
}'
Resposta
json
{
  "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": {},
  "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": "$",
      "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"
    },
    "identification": {},
    "last_purchase": {}
  },
  "payment_methods": {
    "default_card_id": {},
    "excluded_payment_methods": [
      {
        "id": ""
      }
    ],
    "excluded_payment_types": [
      {
        "id": ""
      }
    ]
  },
  "processing_modes": {},
  "product_id": {},
  "redirect_urls": {
    "failure": "",
    "pending": "",
    "success": ""
  },
  "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": {},
      "country_name": {}
    }
  },
  "total_amount": {},
  "last_updated": {},
  "statement_descriptor": "MERCADOPAGO"
}
Erros
400bad_request
invalid_collector_idcollector_id invalid.
invalid_sponsor_idsponsor_id is not an active user.
invalid_collector_emailcollector is not collector_email owner
invalid_operation_typeoperation_type invalid.
invalid_expiration_date_toexpiration_date_to invalid.
invalid_dateinvalid date of expiration.
invalid_expiration_date_fromexpiration_date_from invalid.
invalid_itemsunit_price invalid.
invalid_back_urlsback_urls invalid. Wrong format
invalid_payment_methodsinstallments invalid. Should be a number between 1 and 36.
invalid_marketplace_feemarketplace_fee must not be greater than total amount.
invalid_idpreference_id not found.
invalid_access_tokenaccess denied
invalid_shipmentsinvalid type (<type>) for field shipments.cost.
Essas informações foram úteis?

Copyright © 1999-2021 MercadoLibre Perú S.R.L.

Termos e condiçõesComo cuidamos da sua privacidade
Partners Mercado Pago

Al navegar en este sitio aceptas las cookies que utilizamos para mejorar tu experiencia. Más información.