/checkout/preferences

BASE URI https://api.mercadopago.com/checkout/preferences

HTTP Request

curl

 curl -X POST \
  'https://api.mercadopago.com/checkout/preferences?access_token=ACCESS_TOKEN_ENV' \
  -H 'content-type:application/json' \
  -d '{
        "items": [
            {
            "title": "Dummy Item",
            "description": "Multicolor Item",
            "quantity": 1,
            "currency_id": "[FAKER][CURRENCY][ACRONYM]",
            "unit_price": 10.0
            }
        ]
    }'






     

Request Params

ParameterTypeDescription
items Array(Object) Información sobre el ítem.
id String(256) Indentificador del ítem.
title String(256) Título del ítem, se mostrará en el flujo de pago.
description String(256) Descripción del item.
picture_url String(600) URL de imagen del ítem.
category_id String(256) Identificador de la categoría del ítem.
quantity Integer Cantidad de ítems.
currency_id String(3) Identificador de moneda en formato ISO_4217.
unit_price Float Precio unitario.
payer Object Información sobre el comprador.
name String(256) Nombre del comprador.
surname String(256) Apellido del comprador.
email String(256) Dirección de e-mail del comprador.
phone Object Teléfono del comprador.
area_code String(256) Código de área.
number String(256) Número.
identification Object Identificación personal.
type String(256) Tipo de identificación.
number String(256) Número.
address Object Dirección del comprador.
zip_code String(256) Código postal.
street_name String(256) Nombre de la calle.
street_number Integer Número de la calle.
date_created Date(ISO_8601) Fecha de registración.
payment_methods Object Métodos de pago a ser excluídos del flujo de pago.
excluded_payment_methods Array(Object) Métodos de pago no permitidos en el flujo de pago (a excepción de account_money).
id String(256) Identificador del método de pago.
excluded_payment_types Array(Object) Tipos de pago no permitidos en el flujo de pago.
id String(256) Identificador de data_type del medio de pago.
default_payment_method_id String(256) Medio de pago preferido.
installments Integer Máximo número de cuotas.
default_installments Integer Preferencia de cuotas.
shipments Object Información de envío.
mode String Modo de envío.
custom Envío personalizado.
me2 Mercado Envíos.
not_specified Modo de envío no especificado.
local_pickup Boolean Preferencia de retiro de paquetes en sucursal(mode:me2 solamente).
dimensions String Tamaño del paquete en cm x cm x cm, gr (mode:me2 solamente)
default_shipping_method Integer Elegir un método de envío predeterminado en el _checkout_(mode:me2 solamente).
free_methods Array(Object) Ofrecer un método de envío gratuito (mode:me2 solamente).
id Integer Identificador de método de envío.
cost Float Costo del envío (mode:custom solamente).
free_shipping Boolean Preferencia de envío gratuito para mode:custom.
receiver_address Object Dirección de envío.
zip_code String(256) Código postal.
street_name String(256) Calle.
street_number Integer Número.
floor String(256) Piso.
apartment String(256) Apartmento.
back_urls Object URLs de retorno al sitio del vendedor.
success String(600) URL de retorno ante pago aprobado.
pending String(600) URL de retorno ante pago pendiente.
failure String(600) URL de retorno ante pago cancelado.
notification_url String(500) URL a la cual te gustaría recibir notificaciones de pagos.
additional_info String(600) Información adicional.
auto_return String En 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.
external_reference String(256) Referencia que puedes sincronizar con tu sistema de pagos.
expires Boolean Preferencia que determina si una preferencia expira.
expiration_date_from Date(ISO_8601) Fecha a partir de la cual la preferencia estará activa.
expiration_date_to Date(ISO_8601) Fecha en la que la preferencia expirará.
marketplace String(256) Origen del pago. Valor por defecto: NONE
marketplace_fee Float Comisión de Marketplace cobrada por el dueño de la aplicación. Valor por defecto: 0 en moneda local
differential_pricing Object Configuración de precio diferencial para esta preferencia.
id Integer Identificador de precio diferenciado.

HTTP Response

json

 {
    "collector_id": 202809963,
    "operation_type": "regular_payment",
    "items": [
        {
            "id": "",
            "picture_url": "",
            "title": "Dummy Item",
            "description": "Multicolor Item",
            "category_id": "",
            "currency_id": "[FAKER][CURRENCY][ACRONYM]",
            "quantity": 1,
            "unit_price": 10
        }
    ],
    "payer": {
        "name": "",
        "surname": "",
        "email": "",
        "date_created": "",
        "phone": {
            "area_code": "",
            "number": ""
        },
        "identification": {
            "type": "",
            "number": ""
        },
        "address": {
            "street_name": "",
            "street_number": null,
            "zip_code": ""
        }
    },
    "back_urls": {
        "success": "",
        "pending": "",
        "failure": ""
    },
    "auto_return": "",
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null,
        "default_payment_method_id": null,
        "default_installments": null
    },
    "client_id": "6295877106812064",
    "marketplace": "MP-MKT-6295877106812064",
    "marketplace_fee": 0,
    "shipments": {
        "receiver_address": {
            "zip_code": "",
            "street_number": null,
            "street_name": "",
            "floor": "",
            "apartment": ""
        }
    },
    "notification_url": null,
    "external_reference": "",
    "additional_info": "",
    "expires": false,
    "expiration_date_from": null,
    "expiration_date_to": null,
    "date_created": "2018-02-02T15:22:23.535-04:00",
    "id": "202809963-920c288b-4ebb-40be-966f-700250fa5370",
    "init_point": "https://www.mercadopago.com/mla/checkout/start?pref_id=202809963-920c288b-4ebb-40be-966f-700250fa5370",
    "sandbox_init_point": "https://sandbox.mercadopago.com/mla/checkout/pay?pref_id=202809963-920c288b-4ebb-40be-966f-700250fa5370"
} 

Error Codes

CodeDescription
400 bad_request
invalid_collector_id collector_id debe ser un número.
invalid_collector_id collector_id inválido.
invalid_sponsor_id No se ha encontrado el sponsor_id.
invalid_sponsor_id sponsor_id debe ser un número.
invalid_sponsor_id El parámetro sponsor_id debe ser distinto del parámetro collector_id.
invalid_sponsor_id El site del parámetro sponsor_id debe ser el mismo que el parámetro collector_id.
invalid_sponsor_id El sponsor_id no aceptó los términos y condiciones de Mercado Pago.
invalid_sponsor_id El sponsor_id no es un usuario activo.
invalid_collector_email collector is not collector_email(secure) owner
invalid_collector_email El collector no es dueño del collector_email.
invalid_operation_type operation_type inválido.
invalid_expiration_date_to expiration_date_to inválido.
invalid_expiration_date_from expiration_date_from inválido.
invalid_items El monto no puede ser pagado con Mercado Pago.
invalid_items ítems requeridos.
invalid_items ítems inválidos, error de formato.
invalid_items currency_id es requerido.
invalid_items currency_id inválido.
invalid_items El parámetro quantity es requerido.
invalid_items El parámetro quantity debe ser un número.
invalid_items El parámetro unit_price es requerido.
invalid_items unit_price debe ser un número.
invalid_items unit_price inválido.
invalid_payer payer inválido, error de formato.
invalid_payer Nombre del comprador inválido, la longitud máxima es 100 caracteres.
invalid_payer Apellido del comprador inválido, la longitud máxima es 100 caracteres.
invalid_payer Email del comprador inválido, la longitud máxima es 150 caractere
invalid_back_urls back_urls inválido, error de formato.
invalid_payment_methods payment_methods inválido, error de formato.
invalid_payment_methods La combinación de payment methods y payment types no puede excluir todos los payment methods.
invalid_payment_methods El monto no puede ser pagado con Mercado Pago.
invalid_payment_methods excluded_payment_methods inválido, error de formato.
invalid_payment_methods Identificador de pago requerido.
invalid_payment_methods account_money no puede ser excluído.
invalid_payment_methods No es posible excluir todos los payments methods.
invalid_payment_methods excluded_payment_types inválido, error de formato.
invalid_payment_methods No es posible excluir todos los payments types.
invalid_payment_methods client_id inválido.
invalid_payment_methods client_id debe ser un número.
invalid_installments installments inválido. Sólo puede tomar los valores 1, 3, 6, 9, 12, 15, 18, 21 o 24.
invalid_installments installments debe ser un número.
invalid_marketplace_fee marketplace_fee debe ser un número.
invalid_marketplace_fee marketplace_fee debe ser un número positivo.
invalid_marketplace_fee marketplace_fee no puede ser mayor al monto total.
invalid_id preference_id no encontrado.
invalid_access_token Acceso denegado.
invalid_shipments Método de envío inválido.
invalid_shipments El collector no tiene Mercado Envíos activo.
invalid_shipments shipments.dimensions inválido.
invalid_shipments shipments.free_methods inválido.
invalid_shipments shipments.free_methods ID debe ser un número.
invalid_shipments free_methods inválidos.
invalid_shipments shipments.local_pickup inválido.
invalid_shipments shipments.default_shipping_method debe ser un número.
invalid_shipments shipments.default_shipping_method inválido.
invalid_shipments shipments.free_shipping inválido.
invalid_shipments shipments.cost debe ser un número.
invalid_shipments shipments.cost inválido.
invalid_shipments Formato de dimensiones inválido.
invalid_shipments Dimensión inválida.
invalid_shipments Monto total inválido, con Mercado Envíos no puede ser menor a .
invalid_binary_mode binary_mode debe ser booleano.

La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.