Inicio
Documentación
Recursos
Partners
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integración y vendedores que quieren contratarlos.

Comunidad

Recibe las últimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Datos de industria - Checkout Pro - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Datos sobre industrias

Revisa que campos puedes enviar según tu industria para mejorar tu aprobación.

Atención
Esta información solo funciona para la API de Preferencias.

Apparel

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
typeStringTipo
descriptionStringDescripción
picture_urlStringURL de imagen
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
express_shipmentBooleanTrue si lo es, False si no lo es.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "type": "test",
            "category_id": "fashion",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Berta",
        "last_name": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false
    }
}'

Electro

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario
warrantyBooleanTrue si el producto tiene garantía, False si no la tiene.

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
local_pickupBooleanTrue si retira en sucursal, False si no lo hace
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
express_shipmentBooleanTrue si lo es, False si no lo es.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com”,
        "first_name": "Berta",
        "last_name": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Entretenimiento

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario
category_descriptorObjectDescripción de la categoría
event_dateDateFecha del evento

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
express_shipmentBooleanTrue si lo es, False si no lo es.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "category_id": "entertainment",
            "quantity": 1,
            "unit_price": 150,
            "category_descriptor":{
                "event_date": "2022-03-12T12:58:41.425-04:00"
            },
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Berta",
        "last_name": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Home & deco

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario
warrantyBooleanTrue si el producto tiene garantía, False si no la tiene.

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
express_shipmentBooleanTrue si lo es, False si no lo es.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "home",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Berta",
        "last_name": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Aplicaciones y plataformas online

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Retail

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
picture_urlStringURL de imagen
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
express_shipmentBooleanTrue si lo es, False si no lo es.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/us/home/failure",
        "pending": "https://www.mercadopago.com/us/home/pending",
        "success": "https://www.mercadopago.com/us/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Gobierno y servicios públicos

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario
category_descriptorObjectDescripción de la categoría
event_dateDateFecha del evento

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Servicio",
            "picture_url": "",
            "description": "Descripción de servicio",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150,
            "category_descriptor":{
                "event_date": "2022-03-12T12:58:41.425-04:00"
            },
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        }
    }
}'

Turismo

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario
category_descriptorObjectDescripción de la categoría.
passengerObjectInformación adicional del pasajero.
first_nameStringNombre
last_nameStringApellido
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
routeObjectInformación de la ruta
departureStringSalida
destinationStringLlegada
departure_date_timeDateFecha de salida. Ejemplo: 2024-06-20T06:20:00.000-04:00.
arrival_date_timeDateFecha de llegada
companyStringCompañía

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Servicio",
            "description": "Descripción de servicio",
            "category_id": "Travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "Berta",
                  "last_name": "Parra",
                   "type": "DNI",
                   "number": 12345678
              },
              "route": {
            	 "departure": "Parque Patricios",
            	 "destination": "Londres",
            	 "departure_date_time": "2022-03-12T12:58:41.425-04:00",
            	 "arrival_date_time": "2022-03-14T12:58:41.425-04:00",
            	 "company": "Compañía"
            }
},
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Hotelería

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario
event_dateDateFecha del evento
category_descriptorObjectDescripción de la categoría.
passengerObjectInformación adicional del pasajero.
first_nameStringNombre
last_nameStringApellido
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Servicio",
            "description": "Descripción de servicio",
            "category_id": "Travels",
            "category_descriptor": {
                "event_date": "2020-06-02T12:58:41.425-04:00",
                "passenger": {
                    "first_name": "Berta",
                    "last_name": "Parra",
                    "type": "DNI",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Utilities

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Venta directa

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
floorStringPiso
apartmentStringApartamento
local_pickupBooleanTrue si se retira en sucursal, False si no lo hace.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "local_pickup": false,
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

Automóviles y náuticas

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
floorStringPiso
apartmentStringApartamento
local_pickupBooleanTrue si se retira en sucursal, False si no lo hace.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "local_pickup": false,
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

Transporte urbano

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_first_purchase_online": false,
        "is_prime_user": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'