Industry data - Mercado Pago Developers

Industry data

Check what fields you can submit according to your industry to improve your approval.

Attention
Use of examplesThis information applies only for the Preferences API.

Apparel

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
typeStringType
descriptionStringDescription
picture_urlStringPicture URL
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea Code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
express_shipmentBooleanTrue if it is, False if it is not.

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": "Product",
            "picture_url": "",
            "description": "Product Description",
            "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

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price
warrantyBooleanTrue if the product has a guarantee, False if it does not.

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea Code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
local_pickupBooleanTrue if you withdraw in branch, False if you do not.
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
express_shipmentBooleanTrue if it is, False if it is not.

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": "Product",
            "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
    }
}'

Entertainment

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price
event_dateDateEvent date

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea Code
numberIntegerPhone number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
express_shipmentBooleanTrue if it is, False if it is not.

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": "Product",
            "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

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price
warrantyBooleanTrue if the product has a guarantee, False if it does not.

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
express_shipmentBooleanTrue if it is, False if it is not.

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": "Product",
            "picture_url": "",
            "description": "Product Description",
            "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
    }
}'

Applications and online platforms

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

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": "Product",
            "picture_url": "",
            "description": "Product Description",
            "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

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
picture_urlStringPicture URL
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
express_shipmentBooleanTrue if it is, False if it is not.

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": "Product",
            "picture_url": "",
            "description": "Product Description",
            "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
    }
}'

Government and public services

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price
event_dateDateEvent date

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number

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": "Service",
            "picture_url": "",
            "description": "Service description",
            "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
        }
    }
}'

Tourism

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price
category_descriptorObjectCategory description.
passengerObjectAdditional passenger information.
first_nameStringName
last_nameStringSurname
identification_typeStringIdentification type
identification_numberStringIdentification number
routeObjectRoute information
departureStringDeparture
destinationStringArrival
departure_date_timeDateDeparture date
arrival_date_timeDateArrival date
companyStringCompany

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

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": "Service",
            "description": "Service description",
            "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": "Company"
            }
},
            "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
    }
}'

Hospitality

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price
event_dateDateEvent date
category_descriptorObjectCategory description.
passengerObjectAdditional passenger information.
first_nameStringName
last_nameStringSurname
identification_typeStringIdentification type
identification_numberStringIdentification number

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

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": "Service",
            "description": "Service description",
            "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

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

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": "Product",
            "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
    }
}'

Direct sale

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
floorStringFloor
apartmentStringApartament
local_pickupBooleanTrue if withdrawn at branch, False if not.

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": "Product",
            "picture_url": "",
            "description": "Product description",
            "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"
        }
    }
}'

Automobiles and nautical

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea Code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
floorStringFloor
apartmentStringApartament
local_pickupBooleanTrue if withdrawn at branch, False if not.

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": "Product",
            "picture_url": "",
            "description": "Product Description",
            "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"
        }
    }
}'

Urban transport

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea Code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

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": "Product",
            "picture_url": "",
            "description": "Product Description",
            "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
    }
}'