Industry data - Checkout Pro - Mercado Pago Developers

Intelligent search powered by OpenAI

Industry data

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

Attention

This information applies only for the Preferences API.

Apparel

Fields to send

Add all the additional information you want.

About items

Array `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": "UYU",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "type": "test",
            "category_id": "fashion",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "María Eugenia",
        "last_name": "Valentín",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "street_number": 1000
        },
        "express_shipment": false
    }
}'

Electro

Fields to send

Add all the additional information you want.

About items

Array `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": "UYU",
            "title": "Product",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com”,
        "first_name": "María Eugenia",
        "last_name": "Valentín",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Entertainment

Fields to send

Add all the additional information you want.

About items

Array `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 --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "UYU",
            "title": "Product",
            "category_id": "entertainment",
            "quantity": 1,
            "unit_price": 150,
            "category_descriptor":{
                "event_date": "2022-03-12T12:58:41.425-04:00"
            },
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "María Eugenia",
        "last_name": "Valentín",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Home & deco

Fields to send

Add all the additional information you want.

About items

Array `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": "UYU",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "home",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "María Eugenia",
        "last_name": "Valentín",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Applications and online platforms

Fields to send

Add all the additional information you want.

About items

Array `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": "UYU",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Retail

Fields to send

Add all the additional information you want.

About items

Array `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": "UYU",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Government and public services

Fields to send

Add all the additional information you want.

About items

Array `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 --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "UYU",
            "title": "Service",
            "picture_url": "",
            "description": "Service description",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150,
            "category_descriptor":{
                "event_date": "2022-03-12T12:58:41.425-04:00"
            },
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "street_number": 1000
        }
    }
}'

Tourism

Fields to send

Add all the additional information you want.

About items

Array `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 --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "UYU",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "María Eugenia",
                  "last_name": "Valentín",
                   "type": "CI",
                   "number": 12345678
              },
              "route": {
            	 "departure": "Montevideo",
            	 "destination": "Londres",
            	 "departure_date_time": "2022-03-12T12:58:41.425-04:00",
            	 "arrival_date_time": "2022-03-14T12:58:41.425-04:00",
            	 "company": "Company"
            }
},
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Hospitality

Fields to send

Add all the additional information you want.

About items

Array `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": "UYU",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor": {
                "event_date": "2020-06-02T12:58:41.425-04:00",
                "passenger": {
                    "first_name": "María Eugenia",
                    "last_name": "Valentín",
                    "type": "CI",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

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

Direct sale

Fields to send

Add all the additional information you want.

About items

Array `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": "UYU",
            "title": "Product",
            "picture_url": "",
            "description": "Product description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150            
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "local_pickup": false,
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

Automobiles and nautical

Fields to send

Add all the additional information you want.

About items

Array `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": "UYU",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150    
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "local_pickup": false,
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "city_name": "Montevideo",
            "state_name": "Montevideo",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

Urban transport

Fields to send

Add all the additional information you want.

About items

Array `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": "UYU",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150 
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "656971212"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Libertador Lavalleja",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "María Eugenia",
        "surname": "Valentín",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_first_purchase_online": false,
        "is_prime_user": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Reembolsos e cancelamentos

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

Considerações sobre IVA da Colômbia

Veja algumas considerações sobre IVA da Colômbia.

Documentation

Starting now?

Resources

Support

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