Industry data - Checkout Pro - Mercado Pago Developers

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 `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
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": "BRL",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "type": "test",
            "category_id": "fashion",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Maria",
        "last_name": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "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
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": "BRL",
            "title": "Product",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com”,
        "first_name": "Maria",
        "last_name": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "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
`category_descriptor`	Object	Category description
`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
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": "BRL",
            "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": "987654321"
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Maria",
        "last_name": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "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
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": "BRL",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "home",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Maria",
        "last_name": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "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
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": "BRL",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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
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": "BRL",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "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
`category_descriptor`	Object	Category description
`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
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": "BRL",
            "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": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "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. Example: 2024-06-20T06:20:00.000-04:00.
`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
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": "BRL",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "Maria",
                  "last_name": "Silva",
                   "type": "CPF",
                   "number": 12345678
              },
              "route": {
            	 "departure": "Osasco",
            	 "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": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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
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": "BRL",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor": {
                "event_date": "2020-06-02T12:58:41.425-04:00",
                "passenger": {
                    "first_name": "Maria",
                    "last_name": "Silva",
                    "type": "CPF",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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
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": "BRL",
            "title": "Product",
            "picture_url": "",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
            
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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
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": "BRL",
            "title": "Product",
            "picture_url": "",
            "description": "Product description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150            
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "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
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": "BRL",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150    
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "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
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": "BRL",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150 
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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
    }
}'

Reembolsos e cancelamentos

Conheça as instruções necessárias para realizar um reembolso integral, parcial e cancelar uma compra em seu site.

Métricas de integração

Saiba como identificar suas integrações do Checkout Pro para ter acesso aos benefícios do <dev>program.

Documentation

Starting now?

Resources

Support

Partners

Community

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

Navigation

Resources and Community

Mercado Pago

Country and language