Home
Documentation
Resources
Certifications
Community

Resources

Check for updates on our solutions and system performance, or request technical support.

Community

Get the latest news, ask others for help and share your knowledge.

Industry data - Checkout Pro - Mercado Pago Developers

Intelligent search powered by OpenAI 

Industry data

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

Attention
This 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": "PEN",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "type": "test",
            "category_id": "fashion",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "643863703"
        },
        "address": {
            "zip_code": "52",
            "street_name": "German Schreiber Gulsmanco",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Pilar",
        "last_name": "Palomo",
        "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": "German Schreiber Gulsmanco",
            "city_name": "San Isidro",
            "state_name": "Lima",
            "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": "PEN",
            "title": "Product",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "643863703"
        },
        "address": {
            "zip_code": "52",
            "street_name": "German Schreiber Gulsmanco",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com”,
        "first_name": "Pilar",
        "last_name": "Palomo",
        "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": "German Schreiber Gulsmanco",
            "city_name": "San Isidro",
            "state_name": "Lima",
            "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
category_descriptorObjectCategory description
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": "PEN",
            "title": "Product",
            "category_id": "entertainment",
            "quantity": 1,
            "unit_price": 150,
            "category_descriptor":{
                "event_date": "2022-03-12T12:58:41.425-04:00"
            },
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "643863703"
        },
        "identification": {
          "identification_type": "RUC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Pilar",
        "last_name": "Palomo",
        "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": "German Schreiber Gulsmanco",
            "city_name": "San Isidro",
            "state_name": "Lima",
            "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": "PEN",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "home",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "643863703"
        },
        "address": {
            "zip_code": "52",
            "street_name": "German Schreiber Gulsmanco",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Pilar",
        "last_name": "Palomo",
        "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": "German Schreiber Gulsmanco",
            "city_name": "San Isidro",
            "state_name": "Lima",
            "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": "PEN",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "643863703"
        },
        "address": {
            "zip_code": "52",
            "street_name": "German Schreiber Gulsmanco",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Pilar",
        "surname": "Palomo",
        "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": "PEN",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "643863703"
        },
        "address": {
            "zip_code": "52",
            "street_name": "German Schreiber Gulsmanco",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Pilar",
        "surname": "Palomo",
        "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": "German Schreiber Gulsmanco",
            "city_name": "San Isidro",
            "state_name": "Lima",
            "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
category_descriptorObjectCategory description
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": "PEN",
            "title": "Service",
            "picture_url": "",
            "description": "Service description",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150,
            "category_descriptor":{
                "event_date": "2022-03-12T12:58:41.425-04:00"
            },
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "643863703"
        },
        "address": {
            "zip_code": "52",
            "street_name": "German Schreiber Gulsmanco",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Pilar",
        "surname": "Palomo",
        "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": "German Schreiber Gulsmanco",
            "city_name": "San Isidro",
            "state_name": "Lima",
            "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. Example: 2024-06-20T06:20:00.000-04:00.
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": "PEN",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "Pilar",
                  "last_name": "Palomo",
                   "type": "RUC",
                   "number": 12345678
              },
              "route": {
            	 "departure": "San Isidro",
            	 "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": "643863703"
        },
        "address": {
            "zip_code": "52",
            "street_name": "German Schreiber Gulsmanco",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Pilar",
        "surname": "Palomo",
        "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": "PEN",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor": {
                "event_date": "2020-06-02T12:58:41.425-04:00",
                "passenger": {
                    "first_name": "Pilar",
                    "last_name": "Palomo",
                    "type": "RUC",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "643863703"
        },
        "address": {
            "zip_code": "52",
            "street_name": "German Schreiber Gulsmanco",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Pilar",
        "surname": "Palomo",
        "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": "PEN",
            "title": "Product",
            "picture_url": "",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
            
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "643863703"
        },
        "address": {
            "zip_code": "52",
            "street_name": "German Schreiber Gulsmanco",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Pilar",
        "surname": "Palomo",
        "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": "PEN",
            "title": "Product",
            "picture_url": "",
            "description": "Product description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150            
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "643863703"
        },
        "address": {
            "zip_code": "52",
            "street_name": "German Schreiber Gulsmanco",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Pilar",
        "surname": "Palomo",
        "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": "German Schreiber Gulsmanco",
            "city_name": "San Isidro",
            "state_name": "Lima",
            "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": "PEN",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150    
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "643863703"
        },
        "address": {
            "zip_code": "52",
            "street_name": "German Schreiber Gulsmanco",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Pilar",
        "surname": "Palomo",
        "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": "German Schreiber Gulsmanco",
            "city_name": "San Isidro",
            "state_name": "Lima",
            "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": "PEN",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150 
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "643863703"
        },
        "address": {
            "zip_code": "52",
            "street_name": "German Schreiber Gulsmanco",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUC",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Pilar",
        "surname": "Palomo",
        "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
    }
}'