Inicio
Documentación
Recursos
Certificaciones
Comunidad
Datos de industria - Checkout Pro - Mercado Pago Developers
¿Qué estás buscando?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos

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": "CLP",
            "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": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Carolina",
        "last_name": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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": "CLP",
            "title": "Producto",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com”,
        "first_name": "Carolina",
        "last_name": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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": "CLP",
            "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": "679 789 318"
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Carolina",
        "last_name": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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": "CLP",
            "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": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Carolina",
        "last_name": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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": "CLP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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": "CLP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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": "CLP",
            "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": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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": "CLP",
            "title": "Servicio",
            "description": "Descripción de servicio",
            "category_id": "Travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "Carolina",
                  "last_name": "Ponce",
                   "type": "RUT",
                   "number": 12345678
              },
              "route": {
            	 "departure": "Las Condes",
            	 "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": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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": "CLP",
            "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": "Carolina",
                    "last_name": "Ponce",
                    "type": "RUT",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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": "CLP",
            "title": "Producto",
            "picture_url": "",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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": "CLP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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": "CLP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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": "CLP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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
    }
}'