Recursos para IA

Criar pagamento com envio

Através da preferência, é possível criar um pagamento com um envio associado. Dessa forma, você poderá oferecer aos clientes entregas em domicílio dos produtos adquiridos, aproveitando a logística do Mercado Livre sem esforços extras por parte do seu negócio.

A criação de pagamentos com envios está disponível apenas para integradores que tenham autorização do Mercado Pago. Se você não possui essa funcionalidade, pode solicitá-la ao seu Assessor Comercial.

Para criar um pagamento com um envio associado, crie uma preferência enviando uma requisição POST ao endpoint /checkout/preferences, incluindo seu Access TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração > Testes > Credenciais de teste. e os nós items e shipments, conforme indicado na tabela abaixo.

curl
curl --location 'https://api.mercadopago.com/checkout/preferences' \
--header 'Authorization: Bearer [Access Token]' \
--header 'Content-Type: application/json' \
--data '{
"external_reference": "Referencia externa 123",
  "items": [
    {
      "title": "Producto 1",
      "description": "Descripción del producto 1",
      "picture_url": "image.jpg",
      "quantity": 1,
      "currency_id": "MXN",
      "unit_price": 100,
      "fiscal_data": {
        "sat": "23241500",
        "sat_measurement_id": "H87",
        "measurement_unit": "Pieza",
        "package_id": "4G",
        "dangerous_material_id": "M2340"
      },
      "dimensions": {
        "unit": "G",
        "height": 3,
        "width": 11,
        "length": 18,
        "weight": 100
      }
    }, 
    {  
      "title": "Producto 2",
      "description": "Descripción del producto 2",
      "picture_url": "image.jpg",
      "quantity": 1,
      "currency_id": "MXN",
      "unit_price": 110,
      "fiscal_data": {
        "sat": "23241500",
        "sat_measurement_id": "H87",
        "measurement_unit": "Pieza",
        "package_id": "4G",
        "dangerous_material_id": "M2340"
      },
      "dimensions": {
        "unit": "G",
        "height": 3,
        "width": 10,
        "length": 18,
        "weight": 90
      }
    },

  ],
   "shipments": {
    "dimensions": "21x15x6.5,360",
    "free_methods_types": [
            {
                "id": "standard"
            }
        ],
    "local_pickup": false,
    "mode": "me2",
    "stock_origin_id": "id",
    "receiver_address": {
         "zip_code": "06250",
         "street_name": "Ex-Hipódromo de Peralvillo",
         "street_number": null,
         "floor": "",
         "apartment": "",
         "neighborhood": Colonia,
         "city_name": Cuauhtémoc,
         "state_name": Ciudad de México,
         "country_name": México
        }
    }
}'
CampoDescriçãoTipoObrigatoriedade
external_referenceReferência que você pode sincronizar com seu sistema de pagamentos para identificar o envio. Este campo deve ter no máximo 64 caracteres e conter apenas números, letras, hífens (-) e sublinhados (_). Caracteres especiais como ([ ], (), '', @) não são permitidos.StringOpcional
itemsInformações sobre os itens vendidos que serão enviados.ArrayObrigatório
items.titleTítulo do item que será exibido durante o processo de pagamento, no checkout, atividades e e-mails.StringObrigatório
items.descriptionDescrição do item.StringOpcional
items.picture_urlURL da imagem do item.StringOpcional
items.quantityQuantidade de itens. Esta propriedade é utilizada para calcular o custo total da compra.NumberObrigatório
items.currency_idIdentificador único da moeda envolvida na transação. O único valor possível é o peso mexicano (MXN).StringOpcional
items.unit_pricePreço unitário do item. Esta propriedade é usada junto com a propriedade quantity para determinar o custo da compra.NumberObrigatório
items.fiscal_dataObjeto que contém os dados fiscais do produto.ObjectObrigatório para criar envios. Se você enviá-lo, deve incluir também o atributo shipments.
items.fiscal_data.satCategoria SAT do item. Consulte os valores possíveis acessando o seguinte link.StringObrigatório
items.fiscal_data.sat_measurement_idIdentificador único da unidade de medida do produto.StringObrigatório
items.fiscal_data.measurement_unitUnidade de medida do produto de acordo com as SAT UnitsStringObrigatório
items.fiscal_data.package_idIdentificador do tipo de embalagem do produto.StringObrigatório
items.fiscal_data.dangerous_material_idIdentificador para produtos perigosos.StringOpcional
items.dimensionsObjeto que contém as informações sobre o tamanho do item.ObjectOpcional
items.dimensions.unitUnidade de medida para o item. Deve ser cm (centímetros).StringObrigatório
items.dimensions.heightAltura do item em centímetros.NumberObrigatório
items.dimensions.widthLargura do item em centímetros.NumberObrigatório
items.dimensions.lengthComprimento do item em centímetros.NumberObrigatório
items.dimensions.weightPeso do item em gramas.NumberObrigatório
shipmentsInformações do envio.ObjectObrigatório
shipments.dimensionsTamanho do pacote, que será utilizado para definir o custo do envio. O formato deve ser cm x cm x cm, g. Se houver mais de um item, seu tamanho deve ser calculado considerando a soma das dimensões de todos os artigos, garantindo sempre que as dimensões máximas permitidas por pacote não sejam excedidas.
Consulte as boas práticas para dimensionamento acessando a documentação.		StringObrigatório
shipments.free_methods_typeIdentificador do método de envio. Deve ser enviado apenas ao oferecer envio gratuito, com o valor standard. O envio gratuito só é possível quando o valor da venda é maior que o custo do envio. Caso o custo do envio esteja a cargo do comprador, o campo não deve ser enviado.StringOpcional
shipments.local_pickupIndica se deseja oferecer coleta de pacotes em uma agencia. Para esta solução, insira false.BooleanObrigatório
shipments.modeModo de envio. Para esta solução, insira me2.StringObrigatório
shipments.stock_origin_idIdentificador do endereço de origem do pacote, que deve ser solicitado à equipe do Mercado Pago. Caso haja mais de um endereço de coleta, o stock_origin_id deve ser informado para o endereço de origem.StringOpcional
shipments.receiver_addressDetalhes do endereço de destino. Seu envio é recomendado para oferecer a melhor experiência de compra e, se necessário, os dados podem ser reutilizados.ObjectOpcional
shipments.receiver_address.zip_codeCódigo postal do endereço de destino.StringOpcional
shipments.receiver_address.street_nameNome da rua de destino.StringOpcional
shipments.receiver_address.street_numberNúmero do endereço de destino.StringOpcional
shipments.receiver_address.floorAndar do apartamento de destino.StringOpcional
shipments.receiver_address.apartmentNúmero do apartamento de destino.StringOpcional
shipments.receiver_address.neighborhoodBairro do endereço de destino.StringOpcional
shipments.receiver_address.city_nameCidade do endereço de destino.StringOpcional
shipments.receiver_address.state_nameEstado do endereço de destino.StringOpcional
shipments.receiver_address.country_namePaís do endereço de destino.StringOpcional

Se a requisição for enviada com sucesso, o pagamento com envio terá sido criado e a resposta será exibida como no exemplo a seguir.

json
{
    "additional_info": "",
    "auto_return": "",
    "back_urls": {
        "failure": "",
        "pending": "",
        "success": ""
    },
    "binary_mode": false,
    "client_id": "6607075136335166",
    "collector_id": 2681149695,
    "coupon_code": null,
    "coupon_labels": null,
    "date_created": "2025-10-15T15:30:39.775-04:00",
    "date_of_expiration": null,
    "expiration_date_from": null,
    "expiration_date_to": null,
    "expires": false,
    "external_reference": "Referencia externa 123",
    "id": "2681149695-c464c4e0-1834-4e81-9956-25a3cc1e8db8",
    "init_point": "https://www.mercadopago.com.mx/checkout/v1/redirect?pref_id=2681149695-c464c4e0-1834-4e81-9956-25a3cc1e8db8",
    "internal_metadata": null,
    "items": [
        {
            "id": "",
            "category_id": "",
            "currency_id": "MXN",
            "description": "Descripción del producto 1",
            "title": "Producto 1",
            "quantity": 1,
            "unit_price": 100,
            "fiscal_data": {
                "sat": "23241500",
                "sat_measurement_id": "H87",
                "measurement_unit": "Pieza",
                "package_id": "4G",
                "dangerous_material_id": "M2340"
            },
            "dimensions": {
                "unit": "G",
                "height": 3,
                "width": 11,
                "length": 18,
                "weight": 100
            }
        },
        {
            "id": "",
            "category_id": "",
            "currency_id": "MXN",
            "description": "Descripción del producto 2",
            "title": "Producto 2",
            "quantity": 1,
            "unit_price": 110,
            "fiscal_data": {
                "sat": "23241500",
                "sat_measurement_id": "H87",
                "measurement_unit": "Pieza",
                "package_id": "4G",
                "dangerous_material_id": "M2340"
            },
            "dimensions": {
                "unit": "G",
                "height": 3,
                "width": 10,
                "length": 18,
                "weight": 90
            }
        },
            ],
    "marketplace": "NONE",
    "marketplace_fee": 0,
    "metadata": {},
    "notification_url": null,
    "operation_type": "regular_payment",
    "payer": {
        "phone": {
            "area_code": "",
            "number": ""
        },
        "address": {
            "zip_code": "",
            "street_name": "",
            "street_number": null
        },
        "email": "",
        "identification": {
            "number": "",
            "type": ""
        },
        "name": "",
        "surname": "",
        "date_created": null,
        "last_purchase": null
    },
    "payment_methods": {
        "default_card_id": null,
        "default_payment_method_id": null,
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null,
        "default_installments": null
    },
    "processing_modes": null,
    "product_id": null,
    "preference_expired": false,
    "redirect_urls": {
        "failure": "",
        "pending": "",
        "success": ""
    },
    "sandbox_init_point": "https://sandbox.mercadopago.com.mx/checkout/v1/redirect?pref_id=2681149695-c464c4e0-1834-4e81-9956-25a3cc1e8db8",
    "site_id": "MLM",
    "shipments": {
        "mode": "me2",
        "local_pickup": false,
        "dimensions": "21x15x6.5,360",
        "free_methods": [],
        "free_methods_types": [
            {
                "id": "standard"
            }
        ],
        "default_shipping_method": null,
        "receiver_address": {
            "zip_code": "06250",
            "street_name": "Ex-Hipódromo de Peralvillo",
            "street_number": null,
            "floor": "",
            "apartment": "",
            "city_name": "Cuauhtémoc",
            "state_name": "Ciudad",
            "country_name": "México",
            "neighborhood": "Colonia"
        },
        "stock_origin_id": "id"
    },
    "total_amount": null,
    "last_updated": null,
    "financing_group": ""
}

Em caso de necessidade, é possível cancelar o envio criado. Para isso, você deverá cancelar o pagamento ao qual está associado na sua totalidade.

Gerenciar Envios

Se você optar por criar pagamentos com envio, poderá usar nossas APIs de gerenciamento de envios, que permitirão otimizar sua experiência pré e pós-venda.



Configurar notificações de envios

É possível configurar notificações Webhooks para receber alertas sobre envios e suas mudanças de status.

Para isso, é necessário indicar as URLs para as quais as mesmas serão enviadas seguindo o passo a passo abaixo:

  1. Acesse Suas integrações e selecione a aplicação integrada com o Checkout Pro para a qual você deseja ativar as notificações.

Application

  1. No menu à esquerda, selecione Webhooks > Configurar notificações e configure a URL que será utilizada para recebê-las.

Webhooks

  1. Selecione a aba Modo produtivo e forneça uma URL HTTPS para receber notificações com sua integração produtiva.

URL

  1. Selecione o evento Envios (Mercado Pago) para receber notificações, que serão enviadas no formato JSON através de um HTTPS POST para a URL especificada anteriormente.

Envios

  1. Por fim, clique em Salvar configuração. Isso gerará uma chave secreta exclusiva para a aplicação, utilizada para validar a autenticidade das notificações recebidas, assegurando que elas sejam provenientes do Mercado Pago. Vale ressaltar que essa chave não possui prazo de validade, mas recomenda-se sua renovação periódica como medida de segurança. Para renovar a chave, basta clicar no botão Restabelecer.
Próximo
Adobe Commerce
Mercado Pago in your store

Navegação

IntegraçõesDocumentaçãoReferência APIBiblioteca SDK

Recursos e Comunidade

ChangelogStatus Mercado PagoRelatório de errosSuporteNotíciasNewsletterPrograma de parcerias

Mercado Pago

Sua contaTermos de usoPolíticas de privacidade

País e idioma

México
Argentina
Brasil
México
Uruguay
Colombia
Chile
Perú
Português
Español
English
Português
Copyright © 2026 MercadoLibre S. de R.L. de C.V

Usamos cookies para mejorar tu experiencia en Mercado Pago. Consultar más en nuestro Centro de Privacidad.

¡Listo! Guardamos tus preferencias.
Algo salió mal. Por favor, vuelve a intentarlo.