Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizações das nossas soluções e do funcionamento do sistema ou peça suporte técnico.

Parcerias

Conheça nosso programa para agências ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratá-los.

Comunidade

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

Dados de indústria - Checkout Pro - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Dados de indústria

Verifique quais campos você pode enviar de acordo com o seu setor para melhorar sua aprovação.

Atenção
Uso de exemplosEssas informações funcionam apenas para a API de Preferências.

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

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": "BRL",
            "title": "Produto",
            "picture_url": "",
            "description": "Descrição de produto",
            "type": "test",
            "category_id": "fashion",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Maria",
        "last_name": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "street_number": 1000
        },
        "express_shipment": false
    }
}'

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
local_pickupBooleanTrue 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 é.

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": "BRL",
            "title": "Produto",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com”,
        "first_name": "Maria",
        "last_name": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Entretenimento

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
category_descriptorObjectDescrição da categoria
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
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/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": "BRL",
            "title": "Produto",
            "category_id": "entertainment",
            "quantity": 1,
            "unit_price": 150,
            "category_descriptor":{
                "event_date": "2022-03-12T12:58:41.425-04:00"
            },
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Maria",
        "last_name": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

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

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": "BRL",
            "title": "Produto",
            "picture_url": "",
            "description": "Descrição de produto",
            "category_id": "home",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Maria",
        "last_name": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

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.

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": "BRL",
            "title": "Produto",
            "picture_url": "",
            "description": "Descrição de produto",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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

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

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": "BRL",
            "title": "Produto",
            "picture_url": "",
            "description": "Descrição de produto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

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
category_descriptorObjectDescrição da categoria
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

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": "BRL",
            "title": "Serviço",
            "picture_url": "",
            "description": "Descrição de serviço",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150,
            "category_descriptor":{
                "event_date": "2022-03-12T12:58:41.425-04:00"
            },
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "street_number": 1000
        }
    }
}'

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
identification_typeStringTipo de identificação
identification_numberStringNúmero de identificação
routeObjectInformações da rota
departureStringSaída
destinationStringChegada
departure_date_timeDateData de saída. Exemplo: 2024-06-20T06:20:00.000-04:00.
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 --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": "BRL",
            "title": "Serviço",
            "description": "Descrição de serviço",
            "category_id": "travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "Maria",
                  "last_name": "Silva",
                   "type": "CPF",
                   "number": 12345678
              },
              "route": {
            	 "departure": "Osasco",
            	 "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": "Compañía"
            }
},
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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
    }
}'

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 da categoria
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.

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": "BRL",
            "title": "Serviço",
            "description": "Descrição de serviço",
            "category_id": "travels",
            "category_descriptor": {
                "event_date": "2022-03-12T12:58:41.425-04:00"
                "passenger": {
                    "first_name": "Maria",
                    "last_name": "Silva",
                    "type": "CPF",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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

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.

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": "BRL",
            "title": "Produto",
            "picture_url": "",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
            
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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
    }
}'

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
local_pickupBooleanTrue se retira na agência ou na loja, False se não retira.

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": "BRL",
            "title": "Produto",
            "picture_url": "",
            "description": "Descrição de produto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

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.

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": "BRL",
            "title": "Produto",
            "picture_url": "",
            "description": "Descrição de produto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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. das Nações Unidas",
            "city_name": "Osasco",
            "state_name": "São Paulo",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

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.

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": "BRL",
            "title": "Produto",
            "picture_url": "",
            "description": "Descrição de produto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150 
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "987654321"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. das Nações Unidas",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "CPF",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Maria",
        "surname": "Silva",
        "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
    }
}'