Developers
API Reference
Support
Sign in

    Home

    Online Payments

    Checkout Pro

    Checkout API

    Payment Link

    Marketplace

    Mobile Checkout

    Web Tokenize Checkout

    In person payments

    QR Code

    Mercado Pago Point

    Plugins and platforms

    WooCommerce

    Prestashop

    Magento 2

    Shopify

    Tiendanube

    VTEX

    SDKs

    Notifications

    Webhooks

    IPN

    Account Management

    Requirements for production environment

    Get payments

    Reports

    Cashback and Cancellations

    Chargeback Management

    Improves approval

    Resources

    Localization

    Changelog

    Status

Industry data - Mercado Pago Developers

In this page

Suggest edit
Help us improve the documentation
Did you see wrong information and would you like us to explain something else or improve our manuals? Please leave your suggestions on GitHub.

Industry data

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

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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "type": "test",
            "category_id": "fashion",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "(785) 367-1240"
        },
        "address": {
            "zip_code": "60374",
            "street_name": "Demetris Groves",
            "street_number": 1085
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "shannon@gmail.com",
        "first_name": "Arlo",
        "last_name": "Rosenbaum",
        "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": "60374",
            "street_name": "Demetris Groves",
            "city_name": "Rickeyport",
            "state_name": "Colorado",
            "street_number": 1085
        },
        "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": "ARS",
            "title": "Product",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "(785) 367-1240"
        },
        "address": {
            "zip_code": "60374",
            "street_name": "Demetris Groves",
            "street_number": 1085
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "shannon@gmail.com”,
        "first_name": "Arlo",
        "last_name": "Rosenbaum",
        "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": "60374",
            "street_name": "Demetris Groves",
            "city_name": "Rickeyport",
            "state_name": "Colorado",
            "street_number": 1085
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Entertainment

Fields to send

Add all the additional information you want.

About items

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

About the buyer

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

About shipments

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

Curl 

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Product",
            "category_id": "entertainment",
            "quantity": 1,
            "unit_price": 150,
            "event_date": "2020-06-02T12:58:41.425-04:00",
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "(785) 367-1240"
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "shannon@gmail.com",
        "first_name": "Arlo",
        "last_name": "Rosenbaum",
        "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": "60374",
            "street_name": "Demetris Groves",
            "city_name": "Rickeyport",
            "state_name": "Colorado",
            "street_number": 1085
        },
        "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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "home",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "(785) 367-1240"
        },
        "address": {
            "zip_code": "60374",
            "street_name": "Demetris Groves",
            "street_number": 1085
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "shannon@gmail.com",
        "first_name": "Arlo",
        "last_name": "Rosenbaum",
        "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": "60374",
            "street_name": "Demetris Groves",
            "city_name": "Rickeyport",
            "state_name": "Colorado",
            "street_number": 1085
        },
        "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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "(785) 367-1240"
        },
        "address": {
            "zip_code": "60374",
            "street_name": "Demetris Groves",
            "street_number": 1085
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "shannon@gmail.com",
        "name": "Arlo",
        "surname": "Rosenbaum",
        "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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "(785) 367-1240"
        },
        "address": {
            "zip_code": "60374",
            "street_name": "Demetris Groves",
            "street_number": 1085
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "shannon@gmail.com",
        "name": "Arlo",
        "surname": "Rosenbaum",
        "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": "60374",
            "street_name": "Demetris Groves",
            "city_name": "Rickeyport",
            "state_name": "Colorado",
            "street_number": 1085
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Government and public services

Fields to send

Add all the additional information you want.

About items

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

About the buyer

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

About shipments

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

Curl 

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Service",
            "picture_url": "",
            "description": "Service description",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150,
            "event_date": "2020-06-02T12:58:41.425-04:00"
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "(785) 367-1240"
        },
        "address": {
            "zip_code": "60374",
            "street_name": "Demetris Groves",
            "street_number": 1085
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "shannon@gmail.com",
        "name": "Arlo",
        "surname": "Rosenbaum",
        "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": "60374",
            "street_name": "Demetris Groves",
            "city_name": "Rickeyport",
            "state_name": "Colorado",
            "street_number": 1085
        }
    }
}'

Tourism

Fields to send

Add all the additional information you want.

About items

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

About the buyer

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

Curl 

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "Arlo",
                  "last_name": "Rosenbaum",
                   "type": "DNI",
                   "number": 12345678
              },
              "route": {
                 "departure": "Rickeyport",
                 "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": "(785) 367-1240"
        },
        "address": {
            "zip_code": "60374",
            "street_name": "Demetris Groves",
            "street_number": 1085
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "shannon@gmail.com",
        "name": "Arlo",
        "surname": "Rosenbaum",
        "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": "ARS",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor": {
                "passenger": {
                    "first_name": "Arlo",
                    "last_name": "Rosenbaum",
                    "type": "DNI",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "event_date": "2020-06-02T12:58:41.425-04:00",
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "(785) 367-1240"
        },
        "address": {
            "zip_code": "60374",
            "street_name": "Demetris Groves",
            "street_number": 1085
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "shannon@gmail.com",
        "name": "Arlo",
        "surname": "Rosenbaum",
        "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": "ARS",
            "title": "Product",
            "picture_url": "",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150

        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "(785) 367-1240"
        },
        "address": {
            "zip_code": "60374",
            "street_name": "Demetris Groves",
            "street_number": 1085
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "shannon@gmail.com",
        "name": "Arlo",
        "surname": "Rosenbaum",
        "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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150            
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "(785) 367-1240"
        },
        "address": {
            "zip_code": "60374",
            "street_name": "Demetris Groves",
            "street_number": 1085
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "shannon@gmail.com",
        "name": "Arlo",
        "surname": "Rosenbaum",
        "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": "60374",
            "street_name": "Demetris Groves",
            "city_name": "Rickeyport",
            "state_name": "Colorado",
            "street_number": 1085
            "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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150    
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "(785) 367-1240"
        },
        "address": {
            "zip_code": "60374",
            "street_name": "Demetris Groves",
            "street_number": 1085
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "shannon@gmail.com",
        "name": "Arlo",
        "surname": "Rosenbaum",
        "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": "60374",
            "street_name": "Demetris Groves",
            "city_name": "Rickeyport",
            "state_name": "Colorado",
            "street_number": 1085
            "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": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150 
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "(785) 367-1240"
        },
        "address": {
            "zip_code": "60374",
            "street_name": "Demetris Groves",
            "street_number": 1085
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "shannon@gmail.com",
        "name": "Arlo",
        "surname": "Rosenbaum",
        "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
    }
}'

Was this information helpful?

Yes
No

Thank you for helping us improve. We’re sorry you didn’t find what you were looking for. Could you give us more details? It will only take a few minutes. Go to the form.

For help, you can review the frequently asked questions or speak with us through the support

Thank you for helping us improve! Can you tell us about your experience?
It will only take a few minutes. Go to the form.

There was an error processing your answer. Please try again.
Try again Close

Mercado Pago ofrece servicios de pago y no está autorizado por el Banco Central a operar como entidad financiera. Los fondos acreditados en cuentas de pago no constituyen depósitos en una entidad financiera ni están garantizados conforme legislación aplicable a depósitos en entidades financieras.

Copyright © 2020 MercadoLibre S.R.L.

Terms and conditions How we take care of your privacy
Partners Mercado Pago
Argentina Brazil Peru Colombia Uruguay Chile Mexico
Spanish English Portuguese

Al navegar en este sitio aceptás las cookies que utilizamos para mejorar tu experiencia. Más información.