Estamos evoluindo nossa forma de integrar. Descubra a nova API Orders

Venda direta - Dados de indĂșstria - Mercado Pago Developers

Venda direta

Estes sĂŁo os dados especĂ­ficos para a indĂșstria de venda direta que podem ser adicionados Ă  sua integração para melhorar a aprovação dos pagamentos.

Campos para enviar

Adicione qualquer informação extra que considerar necessåria.

Sobre itens

Array itemsTipoDescrição
idStringCódigo de identificação do item.
titleStringNome do item.
typeStringTipo de item.
descriptionStringDescrição do item.
category_idStringCategoria do item.
quantityIntegerQuantidade de unidades do item.
unit_priceFloatPreço unitårio atribuído ao item. Pode ser um valor inteiro ou em casas decimais.

Sobre o comprador

Object payerTipoDescrição
first_nameStringNome do comprador.
last_nameStringSobrenome do comprador.
identificationObjectDados de identificação do comprador.
typeStringTipo de identificação. Estå dentro do objeto identification.
numberStringNĂșmero de identificação. EstĂĄ dentro do objeto identification.
phoneObjectTelefone do comprador.
area_codeIntegerCĂłdigo de ĂĄrea do comprador. EstĂĄ dentro do objeto phone.
numberIntegerNĂșmero de telefone do comprador. EstĂĄ dentro do objeto phone.
addressObjectDados do endereço do comprador.
zip_codeStringCĂłdigo postal do comprador. EstĂĄ dentro do objeto address.
street_nameStringNome da rua do endereço do comprador. Estå dentro do objeto address.
street_numberIntegerNĂșmero da rua do endereço do comprador. EstĂĄ dentro do objeto address.
authentication_typeEnumTipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro".
registration_dateDateData de registro do comprador no site.
is_prime_userBooleanIndica se o usuĂĄrio Ă© premium. Caso seja, use true e, caso nĂŁo seja, use false.
is_first_purchase_onlineBooleanIndica se Ă© a primeira compra do cliente. Caso seja, use true e, caso nĂŁo seja, use false.
last_purchaseDateData da Ășltima compra no site.

Sobre envios

Object shipmentTipoDescrição
receiver_addressObjectDados do endereço da entrega.
zip_codeStringCĂłdigo postal para a entrega.
state_nameStringEstado para onde o pedido Ă© enviado.
city_nameStringCidade para onde o pedido Ă© enviado.
street_numberIntegerNĂșmero da rua da entrega.
floorStringInformaçÔes do andar do apartamento para a entrega.
apartmentStringInformaçÔes do apartamento para a entrega.
local_pickupBooleanCaso seja retirada na loja, use 1 e, caso nĂŁo seja, use 0.

curl

curl --location 'https://api.mercadopago.com/v1/payments' \
--header 'Content-Type: application/json' \
--header 'X-Idempotency-Key: {{uuid}}' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'X-Meli-Session-Id: {{device_id}} \
--data-raw '{
    "transaction_amount": 1500.00,
    "installments": 1,
    "statement_descriptor": "LOJA 123",
    "capture": true,
    "binary_mode": false,
    "sponsor_id": null,
    "application_fee": null,
    "payment_method_id": "debvisa",
    "token": "{{card_token_id}}",
    "external_reference": "Pedido01",
    "description": "PEDIDO NOVO",
    "notification_url": "{{notification_url}}",
    "metadata": {
        "order_number": "order_01"
    },
    "payer": {
        "email": "test_user_123456789@testuser.com",
        "identification": {
            "type": "CPF",
            "number": "12345678909"
        }
    },
    "additional_info": {
        "items": [
            {
                "id": "1234",
                "title": "Direct sale",
                "description": "Gold ring",
                "category_id": "jewelry",
                "quantity": 1,
                "unit_price": 1500
            }
        ],
        "payer": {
            "first_name": "Nome",
            "last_name": "Sobrenome",
            "is_prime_user": true,
            "is_first_purchase_online": true,
            "last_purchase": "2019-10-25T19:30:00.000-03:00",
            "phone": {
                "area_code": "11",
                "number": "987654321"
            },
            "address": {
                "zip_code": "206233-2002",
                "street_name": "Av. das NaçÔes Unidas",
                "street_number": "230032"
            },
            "authentication_type": "Facebook",
            "registration_date": "2020-08-06T09:25:04.000-03:00"
        },
        "shipments": {
            "local_pickup": "1",
            "receiver_address": {
                "zip_code": "306233-2003",
                "street_name": "Av. das NaçÔes Unidas",
                "street_number": "3003",
                "floor": "5",
                "apartment": "502",
                "state_name": "DF",
                "city_name": "Bogota"
            }
        }
    }
}'