Home
Documentation
Resources
Certifications
Community
Industry data - Checkout API - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps

Additional industry data

Depending on the branch of activities or industry of your store, there is a series of data that can be sent when creating a payment that will help improve your approval. You can see them detailed by industry below.

Attention
This information applies only for Payment API integrations. To see information about the standard integration with payments api, click here .

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.

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
pick_up_on_sellerBooleanTrue 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.

Tickets and entertainment

Fields to send

Add all the additional information you want.

About items

Array itemsTypeDescription
idStringCode
titleStringName
descriptionStringPayment reason or item title
picture_urlStringURL of the product’s picture
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/v1/payments' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--data-raw '{
    "transaction_amount": 12.34,
    "installments": 1,
    "statement_descriptor": "LOJA 123",
    "capture": true,
    "binary_mode": false,
    "sponsor_id": null,
    "application_fee": null,
    "payment_method_id": "master",
    "token": "{{card_token_id}}",
    "external_reference": "Pedido 01",
    "notification_url": "{{notification_url}}",
    "metadata": {
        "order_number": "order_01"
    },
    "description": "PEDIDO NOVO - INGRESSO",
    "payer": {
        "first_name": "Nome",
        "last_name": "Sobrenome",
        "email": "test_user_123456789@testuser.com",
        "identification": {
            "type": "CPF",
            "number": "19119119100"
        },
        "address": {
            "zip_code": "06233200",
            "street_name": "Av. das Nações Unidas",
            "street_number": "3003",
            "neighborhood": "Bonfim",
            "city": "Osasco",
            "federal_unit": "SP"
        }
    },
    "additional_info": {
        "items": [
            {
                "id": "1941",
                "title": "25/08/2022 | Pista Inteira5 lote - GREEN VALLEY GRAMADO 2022",
                "description": "25/08/2022 | Pista Inteira5 lote - GREEN VALLEY GRAMADO 2022",
                "picture_url": null,
                "category_id": "Tickets",
                "quantity": 1,
                "unit_price": 100.00,
                "event_date": "2019-12-25T19:30:00.000-03:00"
            }
        ],
        "payer": {
            "first_name": "Nome",
            "last_name": "Sobrenome",
            "is_prime_user": "1",
            "is_first_purchase_online": "1",
            "last_purchase": "2019-10-25T19:30:00.000-03:00",
            "phone": {
                "area_code": "11",
                "number": "987654321"
            },
            "address": {
                "zip_code": "06233-200",
                "street_name": "Av. das Nações Unidas",
                "street_number": "3003"
            },
            "registration_date": "2020-08-06T09:25:04.000-03:00"
        },
        "shipments": {
            "express_shipment": "0",
            "pick_up_on_seller": "1",
            "receiver_address": {
                "zip_code": "06233-200",
                "street_name": "Av. das Nações Unidas",
                "street_number": "3003",
                "floor": "",
                "apartment": ""
            }
        }
    }
}'

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.

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.

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.

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

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
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 'https://api.mercadopago.com/v1/payments' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Cookie: JSESSIONID=node01vge5if1qe3pv1w1y0c6ix92a123941.node0' \
--data-raw '{
    "transaction_amount": 150.00,
    "installments": 1,
    "statement_descriptor": "LOJA 123",
    "capture": true,
    "binary_mode": false,
    "sponsor_id": null,
    "application_fee": null,
    "payment_method_id": "visa",
    "token": "<CARD_TOKEN>",
    "external_reference": "Pedido 01",
    "notification_url": "https://webhook.site/3e2ba8af-41c8-41c4-9a47-bf65877f5e7c",
    "metadata": {
        "order_number": "order_01"
    },
    "description": "PEDIDO NOVO",
    "payer": {
        "first_name": "Nome",
        "last_name": "Sobrenome",
        "email": "test_user_123456789@testuser.com",
        "identification": {
            "type": "CPF",
            "number": "12345678909"
        },
        "address": {
            "zip_code": "06233-200",
            "street_name": "Av. das Nações Unidas",
            "street_number": "3003",
            "neighborhood": "Bonfim",
            "city": "Osasco",
            "federal_unit": "SP"
        }
    },
    "additional_info": {
        "items": [ 
        {
            "id": "1234",
            "title": "Serviço",
            "description": "Descrição de serviço",
            "category_id": "travels",
            "category_descriptor":{
                "passenger": {
                    "first_name": "Nome",
                    "last_name": "Sobrenome"
                },
                "route": {
                    "departure": "Osasco",
                    "destination": "Sao Paulo",
                    "departure_date_time": "2022-03-12T12:58:41.425-04:00",
                    "arrival_date_time": "2022-03-14T12:58:41.425-04:00",
                    "company": "Companhia"
                }
            },
            "quantity": 1,
            "unit_price": 150
            }
        ],
        "payer": {
            "first_name": "Nome",
            "last_name": "Sobrenome",
            "is_prime_user": "1",
            "is_first_purchase_online": "1",
            "last_purchase": "2019-10-25T19:30:00.000-03:00",
            "phone": {
                "area_code": "11",
                "number": "987654321"
            },
            "address": {
                "zip_code": "06233-200",
                "street_name": "Av. das Nações Unidas",
                "street_number": "3003"
            },
            "registration_date": "2020-08-06T09:25:04.000-03:00"
        },
        "shipments": {
            "express_shipment": "0",
            "pick_up_on_seller": "1",
            "receiver_address": {
                "zip_code": "06233-200",
                "street_name": "Av. das Nações Unidas",
                "street_number": "3003",
                "floor": "",
                "apartment": ""
            }
        }
    }
}'

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.

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.

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
pick_up_on_sellerBoolean1 if withdrawn at branch, 0 if not.

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.

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.