Inicio
Documentação
Recursos
Certificações
Comunidade

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Dados de indústria - Checkout Transparente - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos

Dados adicionais de indústria

Dependendo do ramo de atividades ou setor de sua loja, existe uma série de dados que podem ser enviados na hora de gerar um pagamento que vão ajudar a melhorar sua aprovação. Você pode vê-los detalhados por setor abaixo.

Atenção
Esta informação só funciona para integrações com Payment API. Para informações sobre integrações padrão, clique aqui.

Apparel

Campos para enviar

Adicione todas as informações adicionais que você deseja.

Sobre itens

Array itemsTipoDescrição
idStringCódigo
titleStringNome
typeStringTipo
descriptionStringDescrição
picture_urlStringImagem URL
category_idStringCategoria
quantityIntegerQuantidade
unit_priceFloatPreço unitário

Sobre o comprador

Object payerTipodescrição
first_nameStringNome
last_nameStringSobrenome
identificationObjectDados de identificação
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
phoneObjectTelefone
area_codeIntegerCódigo de área
numberIntegerNúmero de telefone
addressObjectDados do endereço
zip_codeStringCódigo postal
street_nameStringNome da rua
street_numberIntegerNúmero da rua
authentication_typeEnumTipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro")
registration_dateDateData de registro do comprador no site.
is_prime_userBooleanTrue se é, False se nao é.
is_first_purchase_onlineBooleanTrue se é, False se não é.
last_purchaseDateData da última compra no site.

Sobre remessa

Object shipmentTipoDescrição
receiver_addressObjectDados do endereço do comprador.
zip_codeStringCódigo postal
state_nameStringProvíncia
city_nameStringCidade
street_numberIntegerNúmero da rua
express_shipmentBooleanTrue se é, False se não é.

Eletro

Campos para enviar

Adicione todas as informações adicionais que você deseja.

Sobre itens

Array itemsTipoDescrição
idStringCódigo
titleStringNome
category_idStringCategoria
quantityIntegerQuantidade
unit_priceFloatPreço unitário
warrantyBooleanTrue se o produto tiver garantia, False se não tiver.

Sobre o comprador

Object payerTipoDescrição
first_nameStringNome
last_nameStringSobrenome
identificationObjectDados de identificação
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
phoneObjectTelefone
area_codeIntegerCódigo de área
numberIntegerNúmero de telefone
addressObjectDados do endereço
zip_codeStringCódigo postal
street_nameStringNome da rua
street_numberIntegerNúmero da rua
authentication_typeEnumTipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro")
registration_dateDateData de registro do comprador no site.
is_prime_userBooleanTrue se é, False se não é.
is_first_purchase_onlineBooleanTrue se é, False se não é.
last_purchaseDateData da última compra no site.

Sobre envios

Object shipmentTipoDescrição
pick_up_on_sellerBooleanTrue se retira na agência ou na loja, False se não retira.
receiver_addressObjectDados do endereço do comprador.
zip_codeStringCódigo postal
state_nameStringProvíncia
city_nameStringCidade
street_numberIntegerNúmero da rua
express_shipmentBooleanTrue se é, False se não é.

Tickets e entretenimento

Campos para enviar

Adicione todas as informações adicionais que você deseja.

Sobre itens

Array itemsTipoDescrição
idStringCodigo
titleStringNome
descriptionStringMotivo do pagamento ou nome do item
picture_urlStringURL da foto do produto
category_idStringCategoria
quantityIntegerQuantidade
unit_priceFloatPreço unitário
event_dateDateData

Sobre o comprador

Object payerTipoDescrição
first_nameStringNome
last_nameStringSobrenome
identificationObjectDados de identificação
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
phoneObjectTelefone
area_codeIntegerCódigo de área
numberIntegerNúmero de telefone
authentication_typeEnumTipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro")
registration_dateDateData de registro do comprador no site.
is_prime_userBooleanTrue se é, False se não é.
is_first_purchase_onlineBooleanTrue se é, False se não é.
last_purchaseDateData da última compra no site.

Sobre envios

Object shipmentTipoDescrição
receiver_addressObjectDados do endereço do comprador.
zip_codeStringCódigo postal
state_nameStringProvíncia
city_nameStringCidade
street_numberIntegerNúmero da rua
express_shipmentBooleanTrue se é, False se não é.

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": ""
            }
        }
    }
}'

Casa e decoração

Campos para enviar

Adicione todas as informações adicionais que você deseja.

Sobre itens

Array itemsTipoDescrição
idStringCódigo
titleStringNome
descriptionStringDescrição
category_idStringCategoria
quantityIntegerQuantidade
unit_priceFloatPreço unitário
warrantyBooleanTrue se o produto tiver garantia, False se não tiver.

Sobre o comprador

Object payerTipoDescrição
first_nameStringNome
last_nameStringSobrenome
identificationObjectDados de identificação
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
phoneObjecttelefone
area_codeIntegerCódigo de área
numberIntegerNúmero de telefone
addressObjectDados do endereço
zip_codeStringCódigo postal
street_nameStringNome da rua
street_numberIntegerNúmero da rua
authentication_typeEnumTipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro")
registration_dateDateData de registro do comprador no site.
is_prime_userBooleanTrue se é, False se não é.
is_first_purchase_onlineBooleanTrue se é, False se não é.
last_purchaseDateData da última compra no site.

Sobre envios

Object shipmentTipoDescrição
receiver_addressObjectDados do endereço do comprador.
zip_codeStringCódigo postal
state_nameStringProvíncia
city_nameStringCidade
street_numberIntegerNúmero da rua
express_shipmentBooleanTrue se é, False se não é.

Aplicativos e plataformas online

Campos para enviar

Adicione todas as informações adicionais que você deseja.

Sobre itens

Array itemsTipoDescrição
idStringCódigo
titleStringNome
category_idStringCategoria
quantityIntegerQuantidade
unit_priceFloatPreço unitário

Sobre o comprador

Object payerTipoDescrição
first_nameStringNome
last_nameStringSobrenome
identificationObjectDados de identificação
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
phoneObjecttelefone
area_codeIntegerCódigo de área
numberIntegerNúmero de telefone
addressObjectDados do endereço
zip_codeStringCódigo postal
street_nameStringNome da rua
street_numberIntegerNúmero da rua
authentication_typeEnumTipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro")
registration_dateDateData de registro do comprador no site.
is_prime_userBooleanTrue se é, False se não é.
is_first_purchase_onlineBooleanTrue se é, False se não é.
last_purchaseDateData da última compra no site.

Retail

Campos para enviar

Adicione todas as informações adicionais que você deseja.

Sobre itens

Array itemsTipoDescrição
idStringCódigo
titleStringNome
descriptionStringDescrição
picture_urlStringImagem URL
category_idStringCategoria
quantityIntegerQuantidade
unit_priceFloatPreço unitário

Sobre o comprador

Object payerTipoDescrição
first_nameStringNome
last_nameStringSobrenome
identificationObjectDados de identificação
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
phoneObjecttelefone
area_codeIntegerCódigo de área
numberIntegerNúmero de telefone
addressObjectDados do endereço
zip_codeStringCódigo postal
street_nameStringNome da rua
street_numberIntegerNúmero da rua
authentication_typeEnumTipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro")
registration_dateDateData de registro do comprador no site.
is_prime_userBooleanTrue se é, False se não é.
is_first_purchase_onlineBooleanTrue se é, False se não é.
last_purchaseDateData da última compra no site.

Sobre envios

Object shipmentTipoDescrição
receiver_addressObjectDados do endereço do comprador.
zip_codeStringCódigo postal
state_nameStringProvíncia
city_nameStringCidade
street_numberIntegerNúmero da rua
express_shipmentBooleanTrue se é, False se não é.

Serviços governamentais e públicos

Campos para enviar

Adicione todas as informações adicionais que você deseja.

Sobre itens

Array itemsTipoDescrição
idStringCódigo
titleStringNome
descriptionStringDescrição
category_idStringCategoria
quantityIntegerQuantidade
unit_priceFloatPreço unitário
event_dateDateData do evento

Sobre o comprador

Object payerTipoDescrição
first_nameStringNome
last_nameStringSobrenome
identificationObjectDados de identificação
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
phoneObjecttelefone
area_codeIntegerCódigo de área
numberIntegerNúmero de telefone
addressObjectDados do endereço
zip_codeStringCódigo postal
street_nameStringNome da rua
street_numberIntegerNúmero da rua
authentication_typeEnumTipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro")
registration_dateDateData de registro do comprador no site.
is_prime_userBooleanTrue se é, False se não é.
is_first_purchase_onlineBooleanTrue se é, False se não é.
last_purchaseDateData da última compra no site.

Sobre envios

Object shipmentTipoDescrição
receiver_addressObjectDados do endereço do comprador.
zip_codeStringCódigo postal
state_nameStringProvíncia
city_nameStringCidade
street_numberIntegerNúmero da rua

Turismo

Campos para enviar

Adicione todas as informações adicionais que você deseja.

Sobre itens

Array itemsTipoDescrição
idStringCódigo
titleStringNome
descriptionStringDescrição
category_idStringCategoria
quantityIntegerQuantidade
unit_priceFloatPreço unitário
category_descriptorObjectDescrição de la categoría.
passengerObjectInformações adicionais sobre passageiros.
first_nameStringNome
last_nameStringSobrenome
routeObjectInformações da rota
departureStringSaída
destinationStringChegada
departure_date_timeDateData de saída
arrival_date_timeDateData de chegada
companyStringCompanhia

Sobre o comprador

Object payerTipoDescrição
first_nameStringNome
last_nameStringSobrenome
identificationObjectDados de identificação
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
phoneObjecttelefone
area_codeIntegerCódigo de área
numberIntegerNúmero de telefone
addressObjectDados do endereço
zip_codeStringCódigo postal
street_nameStringNome da rua
street_numberIntegerNúmero da rua
authentication_typeEnumTipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro")
registration_dateDateData de registro do comprador no site.
is_prime_userBooleanTrue se é, False se não é.
is_first_purchase_onlineBooleanTrue se é, False se não é.
last_purchaseDateData da última compra no 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": ""
            }
        }
    }
}'

Hospitalidade

Campos para enviar

Adicione todas as informações adicionais que você deseja.

Sobre itens

Array itemsTipoDescrição
idStringCódigo
titleStringNome
category_idStringCategoria
quantityIntegerQuantidade
unit_priceFloatPreço unitário
event_dateDateData do evento
category_descriptorObjectDescrição de la categoría.
passengerObjectInformações adicionais sobre passageiros.
first_nameStringNome
last_nameStringSobrenome
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação

Sobre o comprador

Object payerTipoDescrição
first_nameStringNome
last_nameStringSobrenome
identificationObjectDados de identificação
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
phoneObjecttelefone
area_codeIntegerCódigo de área
numberIntegerNúmero de telefone
addressObjectDados do endereço
zip_codeStringCódigo postal
street_nameStringNome da rua
street_numberIntegerNúmero da rua
authentication_typeEnumTipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro")
registration_dateDateData de registro do comprador no site.
is_prime_userBooleanTrue se é, False se não é.
is_first_purchase_onlineBooleanTrue se é, False se não é.
last_purchaseDateData da última compra no site.

Utilities

Campos para enviar

Adicione todas as informações adicionais que você deseja.

Sobre itens

Array itemsTipoDescrição
idStringCódigo
titleStringNome
category_idStringCategoria
quantityIntegerQuantidade
unit_priceFloatPreço unitário

Sobre o comprador

Object payerTipoDescrição
first_nameStringNome
last_nameStringSobrenome
identificationObjectDados de identificação
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
phoneObjecttelefone
area_codeIntegerCódigo de área
numberIntegerNúmero de telefone
addressObjectDados do endereço
zip_codeStringCódigo postal
street_nameStringNome da rua
street_numberIntegerNúmero da rua
authentication_typeEnumTipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro")
registration_dateDateData de registro do comprador no site.
is_prime_userBooleanTrue se é, False se não é.
is_first_purchase_onlineBooleanTrue se é, False se não é.
last_purchaseDateData da última compra no site.

Venda direta

Campos para enviar

Adicione todas as informações adicionais que você deseja.

Sobre itens

Array itemsTipoDescrição
idStringCódigo
titleStringNome
descriptionStringDescrição
category_idStringCategoria
quantityIntegerQuantidade
unit_priceFloatPreço unitário

Sobre o comprador

Object payerTipoDescrição
first_nameStringNome
last_nameStringSobrenome
identificationObjectDados de identificação
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
phoneObjecttelefone
area_codeIntegerCódigo de área
numberIntegerNúmero de telefone
addressObjectDados do endereço
zip_codeStringCódigo postal
street_nameStringNome da rua
street_numberIntegerNúmero da rua
authentication_typeEnumTipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro")
registration_dateDateData de registro do comprador no site.
is_prime_userBooleanTrue se é, False se não é.
is_first_purchase_onlineBooleanTrue se é, False se não é.
last_purchaseDateData da última compra no site.

Sobre envios

Object shipmentTipoDescrição
receiver_addressObjectDados do endereço do comprador.
zip_codeStringCódigo postal
state_nameStringProvíncia
city_nameStringCidade
street_numberIntegerNúmero da rua
floorStringPiso
apartmentStringApartamento
pick_up_on_sellerBoolean1 se retira na agência ou na loja, 0 se não retira.

Automóveis e náutica

Campos para enviar

Adicione todas as informações adicionais que você deseja.

Sobre itens

Array itemsTipoDescrição
idStringCódigo
titleStringNome
descriptionStringDescrição
category_idStringCategoria
quantityIntegerQuantidade
unit_priceFloatPreço unitário

Sobre o comprador

Object payerTipoDescrição
first_nameStringNome
last_nameStringSobrenome
identificationObjectDados de identificação
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
phoneObjecttelefone
area_codeIntegerCódigo de área
numberIntegerNúmero de telefone
addressObjectDados do endereço
zip_codeStringCódigo postal
street_nameStringNome da rua
street_numberIntegerNúmero da rua
authentication_typeEnumTipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro")
registration_dateDateData de registro do comprador no site.
is_first_purchase_onlineBooleanTrue se é, False se não é.
last_purchaseDateData da última compra no site.

Sobre envios

Object shipmentTipoDescrição
receiver_addressObjectDados do endereço do comprador.
zip_codeStringCódigo postal
state_nameStringProvíncia
city_nameStringCidade
street_numberIntegerNúmero da rua
floorStringPiso
apartmentStringApartamento
local_pickupBooleanTrue se retira na agência ou na loja, False se não retira.

Transporte urbano

Campos para enviar

Adicione todas as informações adicionais que você deseja.

Sobre itens

Array itemsTipoDescrição
idStringCódigo
titleStringNome
descriptionStringDescrição
category_idStringCategoria
quantityIntegerQuantidade
unit_priceFloatPreço unitário

Sobre o comprador

Object payerTipoDescrição
first_nameStringNome
last_nameStringSobrenome
identificationObjectDados de identificação
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
phoneObjecttelefone
area_codeIntegerCódigo de área
numberIntegerNúmero de telefone
addressObjectDados do endereço
zip_codeStringCódigo postal
street_nameStringNome da rua
street_numberIntegerNúmero da rua
authentication_typeEnumTipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro")
registration_dateDateData de registro do comprador no site.
is_prime_userBooleanTrue se é, False se não é.
is_first_purchase_onlineBooleanTrue se é, False se não é.
last_purchaseDateData da última compra no site.