Industry data

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

Use of examples

This information applies only for the Preferences API.

Apparel

Fields to send

Add all the additional information you want.

About items

Array `items`	Type	Description
`id`	String	Code
`title`	String	Name
`type`	String	Type
`description`	String	Description
`picture_url`	String	Picture URL
`category_id`	String	Category
`quantity`	Integer	Quantity
`unit_price`	Float	Unit price

About the buyer

Object `payer`	Type	Description
`first_name`	String	Name
`last_name`	String	Surname
`identification`	Object	Identification data
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`phone`	Object	Phone
`area_code`	Integer	Area Code
`number`	Integer	Phone number
`address`	Object	Adress data
`zip_code`	String	Postal code
`street_name`	String	Street name
`street_number`	Integer	Street number
`authentication_type`	Enum	Authentication type ("Gmail" - "Facebook" - "Native web" - "Other")
`registration_date`	Date	Buyer's registration date on the site.
`is_prime_user`	Boolean	`True` if it is, `False` if it is not.
`is_first_purchase_online`	Boolean	`True` if it is, `False` if it is not.
`last_purchase`	Date	Date of the last purchase on the site.

About shipments

Object `shipment`	Type	Description
`receiver_address`	Object	Address of the buyer.
`zip_code`	String	Postal code
`state_name`	String	Province
`city_name`	String	City
`street_number`	Integer	Street number
`express_shipment`	Boolean	`True` if it is, `False` if it is not.

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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "type": "test",
            "category_id": "fashion",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Berta",
        "last_name": "Parra",
        "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 Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false
    }
}'

Electro

Fields to send

Add all the additional information you want.

About items

Array `items`	Type	Description
`id`	String	Code
`title`	String	Name
`category_id`	String	Category
`quantity`	Integer	Quantity
`unit_price`	Float	Unit price
`warranty`	Boolean	`True` if the product has a guarantee, `False` if it does not.

About the buyer

Object `payer`	Type	Description
`first_name`	String	Name
`last_name`	String	Surname
`identification`	Object	Identification data
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`phone`	Object	Phone
`area_code`	Integer	Area Code
`number`	Integer	Phone number
`address`	Object	Adress data
`zip_code`	String	Postal code
`street_name`	String	Street name
`street_number`	Integer	Street number
`authentication_type`	Enum	Authentication type ("Gmail" - "Facebook" - "Native web" - "Other")
`registration_date`	Date	Buyer's registration date on the site.
`is_prime_user`	Boolean	`True` if it is, `False` if it is not.
`is_first_purchase_online`	Boolean	`True` if it is, `False` if it is not.
`last_purchase`	Date	Date of the last purchase on the site.

About shipments

Object `shipment`	Type	Description
`local_pickup`	Boolean	`True` if you withdraw in branch, `False` if you do not.
`receiver_address`	Object	Address of the buyer.
`zip_code`	String	Postal code
`state_name`	String	Province
`city_name`	String	City
`street_number`	Integer	Street number
`express_shipment`	Boolean	`True` if it is, `False` if it is not.

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": "ARS",
            "title": "Product",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com”,
        "first_name": "Berta",
        "last_name": "Parra",
        "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 Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Entertainment

Fields to send

Add all the additional information you want.

About items

Array `items`	Type	Description
`id`	String	Code
`title`	String	Name
`category_id`	String	Category
`quantity`	Integer	Quantity
`unit_price`	Float	Unit price
`event_date`	Date	Event date

About the buyer

Object `payer`	Type	Description
`first_name`	String	Name
`last_name`	String	Surname
`identification`	Object	Identification data
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`phone`	Object	Phone
`area_code`	Integer	Area Code
`number`	Integer	Phone number
`authentication_type`	Enum	Authentication type ("Gmail" - "Facebook" - "Native web" - "Other")
`registration_date`	Date	Buyer's registration date on the site.
`is_prime_user`	Boolean	`True` if it is, `False` if it is not.
`is_first_purchase_online`	Boolean	`True` if it is, `False` if it is not.
`last_purchase`	Date	Date of the last purchase on the site.

About shipments

Object `shipment`	Type	Description
`receiver_address`	Object	Address of the buyer.
`zip_code`	String	Postal code
`state_name`	String	Province
`city_name`	String	City
`street_number`	Integer	Street number
`express_shipment`	Boolean	`True` if it is, `False` if it is not.

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": "ARS",
            "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": "632 231 354"
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Berta",
        "last_name": "Parra",
        "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 Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Home & deco

Fields to send

Add all the additional information you want.

About items

Array `items`	Type	Description
`id`	String	Code
`title`	String	Name
`description`	String	Description
`category_id`	String	Category
`quantity`	Integer	Quantity
`unit_price`	Float	Unit price
`warranty`	Boolean	`True` if the product has a guarantee, `False` if it does not.

About the buyer

Object `payer`	Type	Description
`first_name`	String	Name
`last_name`	String	Surname
`identification`	Object	Identification data
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`phone`	Object	Phone
`area_code`	Integer	Area code
`number`	Integer	Phone number
`address`	Object	Adress data
`zip_code`	String	Postal code
`street_name`	String	Street name
`street_number`	Integer	Street number
`authentication_type`	Enum	Authentication type ("Gmail" - "Facebook" - "Native web" - "Other")
`registration_date`	Date	Buyer's registration date on the site.
`is_prime_user`	Boolean	`True` if it is, `False` if it is not.
`is_first_purchase_online`	Boolean	`True` if it is, `False` if it is not.
`last_purchase`	Date	Date of the last purchase on the site.

About shipments

Object `shipment`	Type	Description
`receiver_address`	Object	Address of the buyer.
`zip_code`	String	Postal code
`state_name`	String	Province
`city_name`	String	City
`street_number`	Integer	Street number
`express_shipment`	Boolean	`True` if it is, `False` if it is not.

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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "home",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Berta",
        "last_name": "Parra",
        "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 Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "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 `items`	Type	Description
`id`	String	Code
`title`	String	Name
`category_id`	String	Category
`quantity`	Integer	Quantity
`unit_price`	Float	Unit price

About the buyer

Object `payer`	Type	Description
`first_name`	String	Name
`last_name`	String	Surname
`identification`	Object	Identification data
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`phone`	Object	Phone
`area_code`	Integer	Area code
`number`	Integer	Phone number
`address`	Object	Adress data
`zip_code`	String	Postal code
`street_name`	String	Street name
`street_number`	Integer	Street number
`authentication_type`	Enum	Authentication type ("Gmail" - "Facebook" - "Native web" - "Other")
`registration_date`	Date	Buyer's registration date on the site.
`is_prime_user`	Boolean	`True` if it is, `False` if it is not.
`is_first_purchase_online`	Boolean	`True` if it is, `False` if it is not.
`last_purchase`	Date	Date of the last purchase on the site.

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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "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 `items`	Type	Description
`id`	String	Code
`title`	String	Name
`description`	String	Description
`picture_url`	String	Picture URL
`category_id`	String	Category
`quantity`	Integer	Quantity
`unit_price`	Float	Unit price

About the buyer

Object `payer`	Type	Description
`first_name`	String	Name
`last_name`	String	Surname
`identification`	Object	Identification data
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`phone`	Object	Phone
`area_code`	Integer	Area code
`number`	Integer	Phone number
`address`	Object	Adress data
`zip_code`	String	Postal code
`street_name`	String	Street name
`street_number`	Integer	Street number
`authentication_type`	Enum	Authentication type ("Gmail" - "Facebook" - "Native web" - "Other")
`registration_date`	Date	Buyer's registration date on the site.
`is_prime_user`	Boolean	`True` if it is, `False` if it is not.
`is_first_purchase_online`	Boolean	`True` if it is, `False` if it is not.
`last_purchase`	Date	Date of the last purchase on the site.

About shipments

Object `shipment`	Type	Description
`receiver_address`	Object	Address of the buyer.
`zip_code`	String	Postal code
`state_name`	String	Province
`city_name`	String	City
`street_number`	Integer	Street number
`express_shipment`	Boolean	`True` if it is, `False` if it is not.

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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "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 Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "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 `items`	Type	Description
`id`	String	Code
`title`	String	Name
`description`	String	Description
`category_id`	String	Category
`quantity`	Integer	Quantity
`unit_price`	Float	Unit price
`event_date`	Date	Event date

About the buyer

Object `payer`	Type	Description
`first_name`	String	Name
`last_name`	String	Surname
`identification`	Object	Identification data
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`phone`	Object	Phone
`area_code`	Integer	Area code
`number`	Integer	Phone number
`address`	Object	Adress data
`zip_code`	String	Postal code
`street_name`	String	Street name
`street_number`	Integer	Street number
`authentication_type`	Enum	Authentication type ("Gmail" - "Facebook" - "Native web" - "Other")
`registration_date`	Date	Buyer's registration date on the site.
`is_prime_user`	Boolean	`True` if it is, `False` if it is not.
`is_first_purchase_online`	Boolean	`True` if it is, `False` if it is not.
`last_purchase`	Date	Date of the last purchase on the site.

About shipments

Object `shipment`	Type	Description
`receiver_address`	Object	Address of the buyer.
`zip_code`	String	Postal code
`state_name`	String	Province
`city_name`	String	City
`street_number`	Integer	Street number

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": "ARS",
            "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": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "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 Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        }
    }
}'

Tourism

Fields to send

Add all the additional information you want.

About items

Array `items`	Type	Description
`id`	String	Code
`title`	String	Name
`description`	String	Description
`category_id`	String	Category
`quantity`	Integer	Quantity
`unit_price`	Float	Unit price
`category_descriptor`	Object	Category description.
`passenger`	Object	Additional passenger information.
`first_name`	String	Name
`last_name`	String	Surname
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`route`	Object	Route information
`departure`	String	Departure
`destination`	String	Arrival
`departure_date_time`	Date	Departure date
`arrival_date_time`	Date	Arrival date
`company`	String	Company

About the buyer

Object `payer`	Type	Description
`first_name`	String	Name
`last_name`	String	Surname
`identification`	Object	Identification data
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`phone`	Object	Phone
`area_code`	Integer	Area code
`number`	Integer	Phone number
`address`	Object	Adress data
`zip_code`	String	Postal code
`street_name`	String	Street name
`street_number`	Integer	Street number
`authentication_type`	Enum	Authentication type ("Gmail" - "Facebook" - "Native web" - "Other")
`registration_date`	Date	Buyer's registration date on the site.
`is_prime_user`	Boolean	`True` if it is, `False` if it is not.
`is_first_purchase_online`	Boolean	`True` if it is, `False` if it is not.
`last_purchase`	Date	Date of the last purchase on the site.

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": "ARS",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "Berta",
                  "last_name": "Parra",
                   "type": "DNI",
                   "number": 12345678
              },
              "route": {
            	 "departure": "Parque Patricios",
            	 "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": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "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 `items`	Type	Description
`id`	String	Code
`title`	String	Name
`category_id`	String	Category
`quantity`	Integer	Quantity
`unit_price`	Float	Unit price
`event_date`	Date	Event date
`category_descriptor`	Object	Category description.
`passenger`	Object	Additional passenger information.
`first_name`	String	Name
`last_name`	String	Surname
`identification_type`	String	Identification type
`identification_number`	String	Identification number

About the buyer

Object `payer`	Type	Description
`first_name`	String	Name
`last_name`	String	Surname
`identification`	Object	Identification data
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`phone`	Object	Phone
`area_code`	Integer	Area code
`number`	Integer	Phone number
`address`	Object	Adress data
`zip_code`	String	Postal code
`street_name`	String	Street name
`street_number`	Integer	Street number
`authentication_type`	Enum	Authentication type ("Gmail" - "Facebook" - "Native web" - "Other")
`registration_date`	Date	Buyer's registration date on the site.
`is_prime_user`	Boolean	`True` if it is, `False` if it is not.
`is_first_purchase_online`	Boolean	`True` if it is, `False` if it is not.
`last_purchase`	Date	Date of the last purchase on the site.

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": "ARS",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor": {
                "passenger": {
                    "first_name": "Berta",
                    "last_name": "Parra",
                    "type": "DNI",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "event_date": "2020-06-02T12:58:41.425-04:00",
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "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 `items`	Type	Description
`id`	String	Code
`title`	String	Name
`category_id`	String	Category
`quantity`	Integer	Quantity
`unit_price`	Float	Unit price

About the buyer

Object `payer`	Type	Description
`first_name`	String	Name
`last_name`	String	Surname
`identification`	Object	Identification data
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`phone`	Object	Phone
`area_code`	Integer	Area code
`number`	Integer	Phone number
`address`	Object	Adress data
`zip_code`	String	Postal code
`street_name`	String	Street name
`street_number`	Integer	Street number
`authentication_type`	Enum	Authentication type ("Gmail" - "Facebook" - "Native web" - "Other")
`registration_date`	Date	Buyer's registration date on the site.
`is_prime_user`	Boolean	`True` if it is, `False` if it is not.
`is_first_purchase_online`	Boolean	`True` if it is, `False` if it is not.
`last_purchase`	Date	Date of the last purchase on the site.

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": "ARS",
            "title": "Product",
            "picture_url": "",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
            
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "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 `items`	Type	Description
`id`	String	Code
`title`	String	Name
`description`	String	Description
`category_id`	String	Category
`quantity`	Integer	Quantity
`unit_price`	Float	Unit price

About the buyer

Object `payer`	Type	Description
`first_name`	String	Name
`last_name`	String	Surname
`identification`	Object	Identification data
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`phone`	Object	Phone
`area_code`	Integer	Area code
`number`	Integer	Phone number
`address`	Object	Adress data
`zip_code`	String	Postal code
`street_name`	String	Street name
`street_number`	Integer	Street number
`authentication_type`	Enum	Authentication type ("Gmail" - "Facebook" - "Native web" - "Other")
`registration_date`	Date	Buyer's registration date on the site.
`is_prime_user`	Boolean	`True` if it is, `False` if it is not.
`is_first_purchase_online`	Boolean	`True` if it is, `False` if it is not.
`last_purchase`	Date	Date of the last purchase on the site.

About shipments

Object `shipment`	Type	Description
`receiver_address`	Object	Address of the buyer.
`zip_code`	String	Postal code
`state_name`	String	Province
`city_name`	String	City
`street_number`	Integer	Street number
`floor`	String	Floor
`apartment`	String	Apartament
`local_pickup`	Boolean	`True` if withdrawn at branch, `False` if not.

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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150            
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "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 Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

Automobiles and nautical

Fields to send

Add all the additional information you want.

About items

Array `items`	Type	Description
`id`	String	Code
`title`	String	Name
`description`	String	Description
`category_id`	String	Category
`quantity`	Integer	Quantity
`unit_price`	Float	Unit price

About the buyer

Object `payer`	Type	Description
`first_name`	String	Name
`last_name`	String	Surname
`identification`	Object	Identification data
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`phone`	Object	Phone
`area_code`	Integer	Area Code
`number`	Integer	Phone number
`address`	Object	Adress data
`zip_code`	String	Postal code
`street_name`	String	Street name
`street_number`	Integer	Street number
`authentication_type`	Enum	Authentication type ("Gmail" - "Facebook" - "Native web" - "Other")
`registration_date`	Date	Buyer's registration date on the site.
`is_first_purchase_online`	Boolean	`True` if it is, `False` if it is not.
`last_purchase`	Date	Date of the last purchase on the site.

About shipments

Object `shipment`	Type	Description
`receiver_address`	Object	Address of the buyer.
`zip_code`	String	Postal code
`state_name`	String	Province
`city_name`	String	City
`street_number`	Integer	Street number
`floor`	String	Floor
`apartment`	String	Apartament
`local_pickup`	Boolean	`True` if withdrawn at branch, `False` if not.

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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150    
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "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 Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

Urban transport

Fields to send

Add all the additional information you want.

About items

Array `items`	Type	Description
`id`	String	Code
`title`	String	Name
`description`	String	Description
`category_id`	String	Category
`quantity`	Integer	Quantity
`unit_price`	Float	Unit price

About the buyer

Object `payer`	Type	Description
`first_name`	String	Name
`last_name`	String	Surname
`identification`	Object	Identification data
`identification_type`	String	Identification type
`identification_number`	String	Identification number
`phone`	Object	Phone
`area_code`	Integer	Area Code
`number`	Integer	Phone number
`address`	Object	Adress data
`zip_code`	String	Postal code
`street_name`	String	Street name
`street_number`	Integer	Street number
`authentication_type`	Enum	Authentication type ("Gmail" - "Facebook" - "Native web" - "Other")
`registration_date`	Date	Buyer's registration date on the site.
`is_prime_user`	Boolean	`True` if it is, `False` if it is not.
`is_first_purchase_online`	Boolean	`True` if it is, `False` if it is not.
`last_purchase`	Date	Date of the last purchase on the site.

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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150 
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "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
    }
}'

Help us improve the documentation

Industry data

Apparel

Fields to send

About items

About the buyer

About shipments

Electro

Fields to send

About items

About the buyer

About shipments

Entertainment

Fields to send

About items

About the buyer

About shipments

Home & deco

Fields to send

About items

About the buyer

About shipments

Applications and online platforms

Fields to send

About items

About the buyer

Retail

Fields to send

About items

About the buyer

About shipments

Government and public services

Fields to send

About items

About the buyer

About shipments

Tourism

Fields to send

About items

About the buyer

Hospitality

Fields to send

About items

About the buyer

Utilities

Fields to send

About items

About the buyer

Direct sale

Fields to send

About items

About the buyer

About shipments

Automobiles and nautical

Fields to send

About items

About the buyer

About shipments

Urban transport

Fields to send

About items

About the buyer