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 order - Pagamentos online - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Criar order

POST

https://api.mercadopago.com/v1/orders
Este endpoint permite criar uma order no modo "automĂĄtico" (processando a transação em uma Ășnica etapa) ou "manual" (processando a transação em etapas que podem ser configuradas e executadas de forma incremental) para transaçÔes de pagamento e cashout. Em caso de sucesso, a requisição retornarĂĄ uma resposta com o status 201.
Parùmetros de requisição
HEADER
X-Idempotency-Key
string

OBRIGATÓRIO

Esta função permite repetir solicitaçÔes de forma segura, sem o risco de realizar a mesma ação mais de uma vez por engano. Isso Ă© Ăștil para evitar erros, como a criação de dois pagamentos idĂȘnticos. Para garantir que cad...Ver mais
BODY
type
string

OBRIGATÓRIO

Tipo de order, associada Ă  solução do Mercado Pago para a qual foi criada. Para pagamentos online com cartĂ”es, o Ășnico valor possĂ­vel Ă© "online".
online: Valor associado à criação de orders para pagamentos online.
external_reference
string

OBRIGATÓRIO

ReferĂȘncia externa da order. Pode ser, por exemplo, um hashcode do Banco Central, funcionando como identificador de origem da transação. Este campo deve ter no mĂĄximo 64 caracteres e deve conter apenas nĂșmeros, letras, h...Ver mais
transactions
object

OBRIGATÓRIO

ContĂ©m informaçÔes sobre as transaçÔes associadas Ă  order. Pode conter atĂ© 2 transaçÔes. Por exemplo, se deseja criar uma order com dois cartĂ”es, vocĂȘ pode adicionar um item ao array "payments", dividindo o valor total d...Ver mais
payer
object
InformaçÔes do pagador
ParĂąmetros de resposta
id
string
Identificador da order criada na requisição, gerado automaticamente pelo Mercado Pago.
processing_mode
string
Modo de processamento da order
manual: O processamento da order será realizado manualmente. É o modo de processamento utilizado para a opção "manual", enquanto configura o processamento para ser feito posteriormente, utilizando o endpoint "Processar order por ID".
automatic: O processamento da order será feito imediatamente. É o modo de processamento utilizado para a opção "automático".
external_reference
string

OBRIGATÓRIO

ReferĂȘncia externa da order. Pode ser, por exemplo, um hashcode do Banco Central, funcionando como identificador de origem da transação. Este campo deve ter no mĂĄximo 64 caracteres e deve conter apenas nĂșmeros, letras, h...Ver mais
total_amount
string
Valor total a ser pago. Deve ser enviado com duas casas decimais.
Erros

400Erro.

empty_required_header

O header 'X-Idempotency-Key' é requerido e não foi enviado. Faça a requisição novamente incluindo-o.

required_properties

Certas propriedades obrigatĂłrias estĂŁo ausentes. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

unsupported_properties

Foi enviada uma propriedade que nĂŁo Ă© suportada. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

minimum_properties

O nĂșmero mĂ­nimo de propriedades necessĂĄrias para executar a solicitação nĂŁo foi enviado. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

property_type

Um tipo de propriedade incorreto foi enviado. Por exemplo, um valor 'integer' para uma propriedade 'string'. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

minimum_items

O nĂșmero mĂ­nimo de itens para alguma propriedade nĂŁo foi enviado. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

maximum_items

Foi enviado um nĂșmero de itens maior do que o permitido para alguma propriedade. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

property_value

Um valor invĂĄlido foi enviado para alguma propriedade. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

json_syntax_error

Um JSON invĂĄlido foi enviado. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

invalid_properties

InformaçÔes incorretas foram enviadas. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

invalid_total_amount

O valor informado em "total_amount" não equivale à soma do campo "transactions.payments.amount" do total de transaçÔes. Verifique se os valores estão corretos.

invalid_email_for_sandbox

O formato do email Ă© invĂĄlido para o ambiente de sandbox, deve conter "@testuser.com".

401Erro. Access Token nĂŁo autorizado.

401

O Access Token enviado estå incorreto. Revise o valor e tente enviar a requisição novamente com a informação correta.

409Alguma regra específica do sistema não permite a realização da ação devido a restriçÔes definidas.

idempotency_key_already_used

O valor enviado como header de idempotĂȘncia jĂĄ foi utilizado. Por favor, tente a solicitação novamente enviando um novo valor.

500Erro.

idempotency_validation_failed

Falha na validação. Tente enviar a solicitação novamente.

500

Erro genérico. Tente enviar a solicitação novamente.

Requisição
curl -X POST \
    'https://api.mercadopago.com/v1/orders'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    -d '{
  "type": "online",
  "external_reference": "ext_ref_1234",
  "transactions": {
    "payments": [
      {
        "amount": "24.90",
        "payment_method": {
          "id": "visa",
          "type": "credit_card",
          "token": "12345",
          "installments": 1,
          "statement_descriptor": "approved"
        }
      }
    ]
  },
  "payer": {
    "email": "test@test.com",
    "first_name": "John",
    "last_name": "Doe",
    "identification": {
      "type": "CPF",
      "number": "99999999999"
    },
    "phone": {
      "area_code": "11",
      "number": "987654321"
    },
    "address": {
      "zip_code": "12345678",
      "street_name": "Rua Teste",
      "street_number": "123"
    }
  },
  "total_amount": "24.90",
  "capture_mode": "manual",
  "processing_mode": "automatic",
  "description": "Point Mini",
  "marketplace": "MERCADOLIVRE",
  "integration_data": {
    "integrator_id": "dev_123",
    "platform_id": "1234567890",
    "sponsor": {
      "id": "446566691"
    }
  },
  "items": [
    {
      "title": "Point Mini",
      "unit_price": "12.90",
      "quantity": 4,
      "description": "Point product for card payments via Bluetooth.",
      "id": "1234",
      "picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
      "category_id": "MLB1055"
    }
  ],
  "expiration_time": "P3Y6M4DT12H30M5S"
}'
Resposta de exemplo
{
  "id": "123",
  "processing_mode": "automatic",
  "external_reference": "ext_ref_1234",
  "total_amount": "24.90",
  "integration_data": {
    "application_id": "1234",
    "integrator_id": "dev_123",
    "platform_id": "1234567890",
    "sponsor": {
      "id": "446566691"
    }
  },
  "created_date": "2024-08-26T13:06:51.045317772Z",
  "last_updated_date": "2024-08-26T13:06:51.045317772Z",
  "country_code": "BRA",
  "type": "online",
  "status": "processed",
  "status_detail": "accredited",
  "capture_mode": "manual",
  "payer": {
    "email": "test@test.com",
    "first_name": "John",
    "last_name": "Doe",
    "identification": {
      "type": "CPF",
      "number": "99999999999"
    },
    "phone": {
      "area_code": "11",
      "number": "987654321"
    },
    "address": {
      "zip_code": "12345678",
      "street_name": "Rua Teste",
      "street_number": "123"
    }
  },
  "transactions": {
    "payments": [
      {
        "id": "pay_01J67CQQH5904WDBVZEM4JMEP3",
        "amount": "24.90",
        "status": "processed",
        "status_detail": "accredited",
        "payment_method": {
          "id": "visa",
          "type": "credit_card",
          "token": "12345",
          "installments": 1,
          "statement_descriptor": "approved"
        }
      }
    ]
  },
  "description": "Point Mini",
  "marketplace": "MERCADOLIVRE",
  "items": [
    {
      "title": "Point Mini",
      "unit_price": "12.90",
      "quantity": 4,
      "description": "Point product for card payments via Bluetooth.",
      "id": "1234",
      "picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
      "category_id": "MLB1055"
    }
  ],
  "expiration_time": "P3Y6M4DT12H30M5S"
}