Actualizar una preferencia - Preferencias - Mercado Pago Developers
Developers
Referencia de API
Soporte
Ingresar

    Introducción

    LISTA DE API

    Preferencias

    Crear una preferencia

    POST

    Buscar preferencias

    GET

    Obtener una preferencia

    GET

    Actualizar una preferencia

    PUT

    Tipos de documento

    Obtener tipos de documentos

    GET

    Medios de pago

    Obtener los medios de pago

    GET

    Pagos

    Crear un pago

    POST

    Buscar pagos

    GET

    Obtener un pago

    GET

    Actualizar un pago

    PUT

    Contracargos

    Obtener un contracargo

    GET

    Clientes

    Crear un cliente

    POST

    Buscar clientes

    GET

    Obtener un cliente

    GET

    Actualizar un cliente

    PUT

    Tarjetas

    Guardar una tarjeta

    POST

    Obtener tarjetas de un cliente

    GET

    Obtener una tarjeta

    GET

    Actualizar una tarjeta

    PUT

    Eliminar una tarjeta

    DELETE

    Sucursales

    Obtener una Sucursal

    GET

    Crear una Sucursal

    POST

    Buscar sucursales

    GET

    Actualizar una Sucursal

    PUT

    Eliminar una Sucursal

    DELETE

    Cajas

    Crear una Caja

    POST

    Buscar cajas

    GET

    Obtener una Caja

    GET

    Actualizar una Caja

    PUT

    Eliminar una Caja

    DELETE

    Órdenes presenciales

    Crear una orden

    POST

    Eliminar una orden

    DELETE

    Órdenes presenciales v2

    Crear una orden

    PUT

    Obtener una orden

    GET

    Eliminar una orden

    DELETE

    Órdenes

    Crear una orden

    POST

    Buscar órdenes

    GET

    Obtener una orden

    GET

    Actualizar una orden

    PUT

    Preferencia de Subscripción

    Crear una suscripción

    POST

Actualizar una preferencia

PUT

/checkout/preferences/{id}
Renueva los datos de una preferencia de pago. Indica el ID de la preferencia y envía los parámetros con la información que quieras actualizar.
Productos que lo utilizan:
Checkout Pro
Marketplace
Mobile Checkout
Parámetros para la solicitud
id

REQUERIDO

string
Localización: pathThe preference's ID
additional_info
string
Localización: bodyInformación adicional
auto_return
String
Localización: bodyEn el caso de estar especificado tu comprador sera redirigido a tu sitio inmediatamente después de la compra
approved: La redirección solo se realiza si el pago fue aprobado.
all: La redirección solo se realiza si el pago fue aprobado, brindando compatibilidad solamente si se cambia el comportamiento por defecto.
back_urls
object
Localización: bodyURLs de retorno al sitio del vendedor
Parámetros de respuesta
additional_info
string
Localización: bodyadditional_info
auto_return
String
Localización: bodyEn el caso de estar especificado tu comprador sera redirigido a tu sitio inmediatamente después de la compra
approved: La redirección solo se realiza si el pago fue aprobado.
all: La redirección solo se realiza si el pago fue aprobado, brindando compatibilidad solamente si se cambia el comportamiento por defecto.
back_urls
object
Localización: bodyback_urls
binary_mode
boolean
Localización: body
Solicitud
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": {}
}'
Respuesta
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"
}
Errores
400bad_request
invalid_collector_idcollector_id inválido.
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.
¿Te resultó útil esta información?

Copyright © 2021 Mercado Pago Colombia Ltda.

Términos y condicionesCómo cuidamos tu privacidad
Partners Mercado Pago

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