Developers
API Reference
Support
Sign in

    Home

    Getting started

    Online Payments

    Checkout Pro

    Checkout API

    Payment Link

    Subscriptions

    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

    Reports

    Get payments

    Improves approval

    Chargeback Management

    Cashback and Cancellations

    Requirements for production environment

    Resources

    Localization

    Changelog

    Status

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 itemsTypeDescription
idStringCode
titleStringName
typeStringType
descriptionStringDescription
picture_urlStringPicture URL
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea Code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
express_shipmentBooleanTrue if it is, False if it is not.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "type": "test",
            "category_id": "fashion",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Berta",
        "last_name": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false
    }
}'

Electro

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price
warrantyBooleanTrue if the product has a guarantee, False if it does not.

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea Code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
local_pickupBooleanTrue if you withdraw in branch, False if you do not.
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
express_shipmentBooleanTrue if it is, False if it is not.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Product",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com”,
        "first_name": "Berta",
        "last_name": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Entertainment

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price
event_dateDateEvent date

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea Code
numberIntegerPhone number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
express_shipmentBooleanTrue if it is, False if it is not.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Product",
            "category_id": "entertainment",
            "quantity": 1,
            "unit_price": 150,
            "event_date": "2020-06-02T12:58:41.425-04:00",
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Berta",
        "last_name": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Home & deco

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price
warrantyBooleanTrue if the product has a guarantee, False if it does not.

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
express_shipmentBooleanTrue if it is, False if it is not.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "home",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Berta",
        "last_name": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Applications and online platforms

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Retail

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
picture_urlStringPicture URL
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
express_shipmentBooleanTrue if it is, False if it is not.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/us/home/failure",
        "pending": "https://www.mercadopago.com/us/home/pending",
        "success": "https://www.mercadopago.com/us/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Government and public services

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price
event_dateDateEvent date

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Service",
            "picture_url": "",
            "description": "Service description",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150,
            "event_date": "2020-06-02T12:58:41.425-04:00"
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        }
    }
}'

Tourism

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price
category_descriptorObjectCategory description.
passengerObjectAdditional passenger information.
first_nameStringName
last_nameStringSurname
identification_typeStringIdentification type
identification_numberStringIdentification number
routeObjectRoute information
departureStringDeparture
destinationStringArrival
departure_date_timeDateDeparture date
arrival_date_timeDateArrival date
companyStringCompany

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "Berta",
                  "last_name": "Parra",
                   "type": "DNI",
                   "number": 12345678
              },
              "route": {
            	 "departure": "Parque Patricios",
            	 "destination": "Londres",
            	 "departure_date_time": "2022-03-12T12:58:41.425-04:00",
            	 "arrival_date_time": "2022-03-14T12:58:41.425-04:00",
            	 "company": "Company"
            }
},
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Hospitality

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price
event_dateDateEvent date
category_descriptorObjectCategory description.
passengerObjectAdditional passenger information.
first_nameStringName
last_nameStringSurname
identification_typeStringIdentification type
identification_numberStringIdentification number

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Service",
            "description": "Service description",
            "category_id": "Travels",
            "category_descriptor": {
                "passenger": {
                    "first_name": "Berta",
                    "last_name": "Parra",
                    "type": "DNI",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "event_date": "2020-06-02T12:58:41.425-04:00",
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Utilities

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Product",
            "picture_url": "",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
            
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Direct sale

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
floorStringFloor
apartmentStringApartament
local_pickupBooleanTrue if withdrawn at branch, False if not.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150            
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "local_pickup": false,
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

Automobiles and nautical

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea Code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

About shipments

Object shipmentTypeDescription
receiver_addressObjectAddress of the buyer.
zip_codeStringPostal code
state_nameStringProvince
city_nameStringCity
street_numberIntegerStreet number
floorStringFloor
apartmentStringApartament
local_pickupBooleanTrue if withdrawn at branch, False if not.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150    
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "local_pickup": false,
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

Urban transport

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringDescription
category_idStringCategory
quantityIntegerQuantity
unit_priceFloatUnit price

About the buyer

Object payerTypeDescription
first_nameStringName
last_nameStringSurname
identificationObjectIdentification data
identification_typeStringIdentification type
identification_numberStringIdentification number
phoneObjectPhone
area_codeIntegerArea Code
numberIntegerPhone number
addressObjectAdress data
zip_codeStringPostal code
street_nameStringStreet name
street_numberIntegerStreet number
authentication_typeEnumAuthentication type ("Gmail" - "Facebook" - "Native web" - "Other")
registration_dateDateBuyer's registration date on the site.
is_prime_userBooleanTrue if it is, False if it is not.
is_first_purchase_onlineBooleanTrue if it is, False if it is not.
last_purchaseDateDate of the last purchase on the site.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Product",
            "picture_url": "",
            "description": "Product Description",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150 
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_first_purchase_online": false,
        "is_prime_user": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'
Was this information helpful?

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 © 2021 MercadoLibre S.R.L.

Terms and conditionsHow we take care of your privacy
Partners Mercado Pago

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