Datos de industria - Mercado Pago Developers

Datos sobre industrias

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

Atención
Uso de ejemplosEsta 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": "UYU",
            "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": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "María Eugenia",
        "last_name": "Valentín",
        "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 Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "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": "UYU",
            "title": "Producto",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com”,
        "first_name": "María Eugenia",
        "last_name": "Valentín",
        "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 Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "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
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": "UYU",
            "title": "Producto",
            "category_id": "entertainment",
            "quantity": 1,
            "unit_price": 150,
            "event_date": "2020-06-02T12:58:41.425-04:00",
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "María Eugenia",
        "last_name": "Valentín",
        "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 Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "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": "UYU",
            "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": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "María Eugenia",
        "last_name": "Valentín",
        "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 Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "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": "UYU",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "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": "UYU",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "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 Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "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
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": "UYU",
            "title": "Servicio",
            "picture_url": "",
            "description": "Descripción de servicio",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150,
            "event_date": "2020-06-02T12:58:41.425-04:00"
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "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 Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "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
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": "UYU",
            "title": "Servicio",
            "description": "Descripción de servicio",
            "category_id": "Travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "María Eugenia",
                  "last_name": "Valentín",
                   "type": "CI",
                   "number": 12345678
              },
              "route": {
            	 "departure": "Montevideo",
            	 "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": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "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": "UYU",
            "title": "Servicio",
            "description": "Descripción de servicio",
            "category_id": "Travels",
            "category_descriptor": {
                "passenger": {
                    "first_name": "María Eugenia",
                    "last_name": "Valentín",
                    "type": "CI",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "event_date": "2020-06-02T12:58:41.425-04:00",
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "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": "UYU",
            "title": "Producto",
            "picture_url": "",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "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": "UYU",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "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 Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "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": "UYU",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "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 Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "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": "UYU",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "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
    }
}'