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 presenciais - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Criar order

POST

https://api.mercadopago.com/v1/orders
Este endpoint permite criar uma order para Mercado Pago Point para transaçÔes de pagamento. 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 com Mercado Pago Point, o Ășnico valor possĂ­vel Ă© "point".
point: Valor associado à criação de orders para pagamentos com Mercado Pago Point.
external_reference
string

OBRIGATÓRIO

É a referĂȘncia externa da order, atribuĂ­da no momento da criação. O limite mĂĄximo permitido Ă© de 64 caracteres e os permitidos sĂŁo: letras maiĂșsculas e minĂșsculas, nĂșmeros e os sĂ­mbolos de hĂ­fen (-) e sublinhado (_).
transactions
object

OBRIGATÓRIO

Contém informaçÔes sobre a transação associada à order. Quando o "type" é "point", Só é possível incluir 1 transação por order.
config
object

OBRIGATÓRIO

Configuração do tipo de order.
ParĂąmetros de resposta
id
string
Identificador da order criada na requisição, gerado automaticamente pelo Mercado Pago.
type
string
Tipo de order.
point: Order criada para pagamentos com o Mercado Pago Point.
external_reference
string
É a referĂȘncia externa da order, atribuĂ­da no momento da criação. O limite mĂĄximo permitido Ă© de 64 caracteres e os permitidos sĂŁo: letras maiĂșsculas e minĂșsculas, nĂșmeros e os sĂ­mbolos de hĂ­fen (-) e sublinhado (_).
description
string
Descrição do produto ou serviço comprado, a razão da order de pagamento.
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.

401Erro.

unauthorized

O valor enviado como Access Token estå incorreto. Verifique e tente a enviar requisição novamente com o valor correto.

403Erro.

forbidden_checking_terminal_owner

O terminal Point não pertence ao usuårio que enviou a solicitação. Verifique se o valor enviado para "terminal_id" estå correto ou se o terminal estå vinculado à sua conta.

409Erro.

idempotency_key_already_used

O valor enviado como header de idempotĂȘncia jĂĄ foi utilizado em uma solicitação diferente em um perĂ­odo menor que 24 horas. Por favor, tente a solicitação novamente enviando um novo valor.

already_queued_order_for_terminal

O terminal já tem uma order em espera. É necessário finalizar ou cancelar para enviar novas orders.

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": "point",
  "external_reference": "ext_ref_1234",
  "transactions": {
    "payments": [
      {
        "amount": "24.90"
      }
    ]
  },
  "config": {
    "point": {
      "terminal_id": "PAX_A910__SMARTPOS1423",
      "print_on_terminal": "no_ticket",
      "ticket_number": "S0392JED"
    },
    "payment_method": {
      "default_type": "credit_card",
      "default_installments": "6",
      "installments_cost": "seller"
    }
  },
  "description": "Point Mini",
  "integration_data": {
    "platform_id": "1234567890",
    "integrator_id": "1234567890",
    "sponsor": {
      "id": "446566691"
    }
  }
}'
Resposta de exemplo
{
  "id": "ORD00001111222233334444555566",
  "type": "point",
  "external_reference": "ext_ref_1234",
  "description": "Point Mini",
  "processing_mode": "automatic",
  "country_code": "BRA",
  "integration_data": {
    "application_id": 1234567890,
    "platform_id": "1234567890",
    "integrator_id": "1234567890",
    "sponsor": {
      "id": "446566691"
    }
  },
  "status": "created",
  "status_detail": "created",
  "created_date": "2024-09-10T14:26:42.109320977Z",
  "last_updated_date": "2024-09-10T14:26:42.109320977Z",
  "config": {
    "point": {
      "terminal_id": "PAX_A910__SMARTPOS1423",
      "print_on_terminal": "no_ticket",
      "ticket_number": "S0392JED"
    },
    "payment_method": {
      "default_type": "credit_card",
      "default_installments": "6",
      "installments_cost": "seller"
    }
  },
  "transactions": {
    "payments": [
      {
        "id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
        "amount": "24.90",
        "status": "created"
      }
    ]
  }
}