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.

Criar preferência - Preferências - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Criar preferência

POST

https://api.mercadopago.com/checkout/preferences
Gerar uma preferência com informações sobre um produto ou serviço e obter a URL necessária para iniciar o fluxo de pagamento..
Parâmetros de requisição
BODY
items
array

OBRIGATÓRIO

Informações sobre o item.
payer
object
Informações do comprador, como nome, sobrenome, e-mail, telefone, identificação pessoal, endereço e data de registro.
payment_methods
object
Todas as configurações são relacionadas ao métodos de pagamento, como, por exemplo, métodos de pagamento excluídos, tipos de pagamento excluídos, método de pagamento padrão e taxas.
shipments
object
Informações de envio.
Parâmetros de resposta
collector_id
number
ID exclusivo usado para identificar o coletor. É o mesmo que o Cust ID.
operation_type
String
data_type da operação.
regular_payment: Pagamento normal.
money_transfer: Solicitação de dinheiro.
items
array
Informações sobre o item.
payer
object
Informações do comprador, como nome, sobrenome, e-mail, telefone, identificação pessoal, endereço e data de registro.
Erros

400Erro

collector_does_not_comply_with_current_regulation

identity validation required.

invalid_collector_id

collector_id invalid.

invalid_sponsor_id

sponsor_id is not an active user.

invalid_collector_email

collector is not collector_email owner.

invalid_operation_type

operation_type invalid.

invalid_expiration_date_to

expiration_date_to invalid.

invalid_date

invalid date of expiration.

invalid_expiration_date_from

expiration_date_from invalid.

invalid_items

unit_price invalid.

invalid_back_urls

back_urls invalid. Wrong format.

invalid_payment_methods

installments invalid. Should be a number between 1 and 36.

invalid_marketplace_fee

marketplace_fee must not be greater than total amount.

invalid_id

preference_id not found.

invalid_access_token

access denied.

invalid_shipments

invalid type (<type>) for field shipments.cost.

invalid_binary_mode

binary_mode must be boolean.

sponsor_id site must be the same as collector_id

O campo sponsor_id deve ser o mesmo que o campo collector_id.

Requisição
curl -X POST \
    'https://api.mercadopago.com/checkout/preferences'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    -d '{
  "items": [
    {
      "id": "Sound system",
      "title": "Dummy Title",
      "description": "Dummy description",
      "picture_url": "https://www.myapp.com/myimage.jpg",
      "category_id": "car_electronics",
      "quantity": 1,
      "currency_id": "BRL",
      "unit_price": 10
    }
  ],
  "payer": {
    "name": "John",
    "surname": "Doe",
    "email": "john@doe.com",
    "phone": {
      "area_code": "11",
      "number": 988888888
    },
    "identification": {
      "type": "CPF",
      "number": "19119119100"
    },
    "address": {
      "zip_code": "06233200",
      "street_name": "Example Street",
      "street_number": 123
    },
    "date_created": "2024-04-01T00:00:00Z"
  },
  "payment_methods": {
    "excluded_payment_methods": [
      {
        "id": "master"
      }
    ],
    "excluded_payment_types": [
      {
        "id": "ticket"
      }
    ],
    "default_payment_method_id": "amex",
    "installments": 10,
    "default_installments": 5
  },
  "shipments": {
    "local_pickup": false,
    "dimensions": "32 x 25 x 16",
    "default_shipping_method": null,
    "free_methods": [
      {
        "id": null
      }
    ],
    "cost": 20,
    "free_shipping": false,
    "receiver_address": {
      "zip_code": "72549555",
      "street_name": "Street address test",
      "city_name": "São Paulo",
      "state_name": "São Paulo",
      "street_number": 100,
      "country_name": "Brazil"
    }
  },
  "back_urls": {
    "success": "https://test.com/success",
    "pending": "https://test.com/pending",
    "failure": "https://test.com/failure"
  },
  "notification_url": "https://notificationurl.com",
  "additional_info": "Discount 12.00",
  "auto_return": "approved",
  "external_reference": "1643827245",
  "expires": false,
  "expiration_date_from": "2022-11-17T09:37:52.000-04:00",
  "expiration_date_to": "2022-11-17T10:37:52.000-05:00",
  "marketplace": "NONE",
  "marketplace_fee": 0,
  "differential_pricing": {
    "id": 1
  },
  "tracks": [
    {
      "type": "google_ad",
      "values": {
        "conversion_id": 123,
        "conversion_label": "abc",
        "pixel_id": "abc"
      }
    }
  ],
  "metadata": {}
}'
Resposta de exemplo
{
  "collector_id": 202809963,
  "items": [
    {
      "title": "Dummy Item",
      "description": "Multicolor Item",
      "currency_id": "$",
      "quantity": 1,
      "unit_price": 10
    }
  ],
  "payer": {
    "phone": {},
    "identification": {},
    "address": {}
  },
  "back_urls": {
    "success": "https://test.com/success",
    "pending": "https://test.com/pending",
    "failure": "https://test.com/failure"
  },
  "auto_return": "approved",
  "payment_methods": {
    "excluded_payment_methods": [
      {}
    ],
    "excluded_payment_types": [
      {}
    ]
  },
  "client_id": 6295877106812064,
  "marketplace": "MP-MKT-6295877106812064",
  "marketplace_fee": 0,
  "shipments": {
    "receiver_address": {}
  },
  "notification_url": "https://notificationurl.com",
  "statement_descriptor": "MERCADOPAGO",
  "expiration_date_from": "2022-11-17T09:37:52.000-04:00",
  "expiration_date_to": "2022-11-17T10:37:52.000-05:00",
  "date_created": "2022-11-17T10:37:52.000-05:00",
  "id": "202809963-920c288b-4ebb-40be-966f-700250fa5370",
  "init_point": "https://www.mercadopago.com/mla/checkout/start?pref_id=202809963-920c288b-4ebb-40be-966f-700250fa5370",
  "sandbox_init_point": "https://sandbox.mercadopago.com/mla/checkout/pay?pref_id=202809963-920c288b-4ebb-40be-966f-700250fa5370",
  "metadata": {}
}