Criar order - Orders - Mercado Pago Developers
Criar order

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

POST

https://api.mercadopago.com/v1/orders
Request parameters
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 (_). Dev...Ver mais
expiration_time
string
Indica o período de validade da ordem de pagamento a partir de sua criação. Durante esse tempo, a ordem estará disponível para ser processada pelo cliente; caso não seja processada dentro do prazo especificado, expirará ...Ver mais
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.
Response parameters
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.
user_id
string
ID do usuário do Mercado Pago que criou a order.
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 (_).
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

Algumas propriedades obrigatórias estão ausentes. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente enviando as informações faltantes.

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.

Request
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 APP_USR-7*********635832-03*********2ffa6c013*********0a90fa2cd*********120' \
    -d '{
  "type": "point",
  "external_reference": "ext_ref_1234",
  "expiration_time": "PT16M",
  "transactions": {
    "payments": [
      {
        "amount": "25"
      }
    ]
  },
  "config": {
    "point": {
      "terminal_id": "NEWLAND_N950__N950NCB801293324",
      "print_on_terminal": "no_ticket",
      "ticket_number": "S0392JED"
    },
    "payment_method": {
      "default_type": "credit_card",
      "default_installments": 6
    }
  },
  "description": "Smartphone",
  "integration_data": {
    "platform_id": "dev_1234567890",
    "integrator_id": "dev_123456",
    "sponsor": {
      "id": "446566691"
    }
  },
  "taxes": [
    {
      "payer_condition": "payment_taxable_iva"
    }
  ]
}'
Response
{
  "id": "ORD00001111222233334444555566",
  "type": "point",
  "user_id": "5238400195",
  "external_reference": "ext_ref_1234",
  "description": "Smartphone",
  "expiration_time": "PT16M",
  "processing_mode": "automatic",
  "country_code": "CHL",
  "integration_data": {
    "application_id": "1234567890",
    "platform_id": "dev_1234567890",
    "integrator_id": "dev_123456",
    "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": "NEWLAND_N950__N950NCB801293324",
      "print_on_terminal": "no_ticket",
      "ticket_number": "S0392JED"
    },
    "payment_method": {
      "default_type": "credit_card",
      "default_installments": "6"
    }
  },
  "transactions": {
    "payments": [
      {
        "id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
        "amount": "24",
        "status": "created"
      }
    ]
  },
  "taxes": [
    {
      "payer_condition": "payment_taxable_iva"
    }
  ]
}