Industry data - Additional Info - 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": "CLP",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "type": "test",
            "category_id": "fashion",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Carolina",
        "last_name": "Ponce",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "street_number": 1000
        },
        "express_shipment": false
    }
}'

Electro

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": "CLP",
            "title": "Product",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com”,
        "first_name": "Carolina",
        "last_name": "Ponce",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

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": "CLP",
            "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": "679 789 318"
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Carolina",
        "last_name": "Ponce",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Home & deco

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": "CLP",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "home",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Carolina",
        "last_name": "Ponce",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

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": "CLP",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Retail

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": "CLP",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

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": "CLP",
            "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": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "street_number": 1000
        }
    }
}'

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": "CLP",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "Carolina",
                  "last_name": "Ponce",
                   "type": "RUT",
                   "number": 12345678
              },
              "route": {
            	 "departure": "Las Condes",
            	 "destination": "Londres",
            	 "departure_date_time": "2022-03-12T12:58:41.425-04:00",
            	 "arrival_date_time": "2022-03-14T12:58:41.425-04:00",
            	 "company": "Company"
            }
},
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

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": "CLP",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor": {
                "passenger": {
                    "first_name": "Carolina",
                    "last_name": "Ponce",
                    "type": "RUT",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "event_date": "2020-06-02T12:58:41.425-04:00",
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Utilities

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": "CLP",
            "title": "Product",
            "picture_url": "",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
            
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

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": "CLP",
            "title": "Product",
            "picture_url": "",
            "description": "Product description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150            
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "local_pickup": false,
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

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": "CLP",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150    
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "local_pickup": false,
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

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": "CLP",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150 
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_first_purchase_online": false,
        "is_prime_user": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'