Obtener 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

Obtener una preferencia

GET

/checkout/preferences/{id}
Consulta toda la información de pago de un producto o servicio con el ID de la preferencia que quieras.
Productos que lo utilizan:
Checkout Pro
Marketplace
Mobile Checkout
Parámetros para la solicitud
id

REQUERIDO

string
Localización: pathThe preference's ID
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
client_id
string
Localización: bodyclient_id
Solicitud
curl
curl -X GET \
    'https://api.mercadopago.com/checkout/preferences/{id}' \
    -H 'Authorization: Bearer ACCESS_TOKEN_ENV' 
Respuesta
json
{
  "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": {}
  }
}
Errores
400bad_request
invalid_collector_idcollector_id inválido.
invalid_sponsor_idsponsor_id is not an active user.
invalid_collector_emailEl collector no es dueño del collector_email.
invalid_operation_typeoperation_type invalid.
invalid_expiration_date_toexpiration_date_to invalid.
invalid_expiration_date_fromexpiration_date_from invalid.
invalid_itemsunit_price invalid.
invalid_payerEmail del comprador inválido, la longitud máxima es 150 caracteres.
invalid_back_urlsback_urls inválido, error de formato.
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_tokenAcceso denegado.
invalid_shipmentsInvalid total amount, with me2 it cannot be lesser than <limit>.
¿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.