Datos de industria - Informaciones Adicionales - 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": "COP",
            "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": "653-338-789"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Carrera",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Isabel",
        "last_name": "Mireles",
        "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": "Carrera",
            "city_name": "Bogotá",
            "state_name": "Cundinamarca",
            "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": "COP",
            "title": "Producto",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "653-338-789"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Carrera",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com”,
        "first_name": "Isabel",
        "last_name": "Mireles",
        "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": "Carrera",
            "city_name": "Bogotá",
            "state_name": "Cundinamarca",
            "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": "COP",
            "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": "653-338-789"
        },
        "identification": {
          "identification_type": "CC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Isabel",
        "last_name": "Mireles",
        "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": "Carrera",
            "city_name": "Bogotá",
            "state_name": "Cundinamarca",
            "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": "COP",
            "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": "653-338-789"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Carrera",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Isabel",
        "last_name": "Mireles",
        "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": "Carrera",
            "city_name": "Bogotá",
            "state_name": "Cundinamarca",
            "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": "COP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "653-338-789"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Carrera",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Isabel",
        "surname": "Mireles",
        "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": "COP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "653-338-789"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Carrera",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Isabel",
        "surname": "Mireles",
        "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": "Carrera",
            "city_name": "Bogotá",
            "state_name": "Cundinamarca",
            "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": "COP",
            "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": "653-338-789"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Carrera",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Isabel",
        "surname": "Mireles",
        "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": "Carrera",
            "city_name": "Bogotá",
            "state_name": "Cundinamarca",
            "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": "COP",
            "title": "Servicio",
            "description": "Descripción de servicio",
            "category_id": "Travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "Isabel",
                  "last_name": "Mireles",
                   "type": "CC",
                   "number": 12345678
              },
              "route": {
            	 "departure": "Bogotá",
            	 "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": "653-338-789"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Carrera",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Isabel",
        "surname": "Mireles",
        "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": "COP",
            "title": "Servicio",
            "description": "Descripción de servicio",
            "category_id": "Travels",
            "category_descriptor": {
                "passenger": {
                    "first_name": "Isabel",
                    "last_name": "Mireles",
                    "type": "CC",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "event_date": "2020-06-02T12:58:41.425-04:00",
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "653-338-789"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Carrera",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Isabel",
        "surname": "Mireles",
        "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": "COP",
            "title": "Producto",
            "picture_url": "",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "653-338-789"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Carrera",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Isabel",
        "surname": "Mireles",
        "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": "COP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "653-338-789"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Carrera",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Isabel",
        "surname": "Mireles",
        "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": "Carrera",
            "city_name": "Bogotá",
            "state_name": "Cundinamarca",
            "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": "COP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "653-338-789"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Carrera",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Isabel",
        "surname": "Mireles",
        "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": "Carrera",
            "city_name": "Bogotá",
            "state_name": "Cundinamarca",
            "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": "COP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "653-338-789"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Carrera",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Isabel",
        "surname": "Mireles",
        "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
    }
}'