Inicio
Documentação
Recursos
Certificações
Comunidade

Recursos

Confira as atualizações das nossas soluções e do funcionamento do sistema ou peça suporte técnico.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Obter order por ID - Pagamentos presenciais - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Obter order por ID

GET

https://api.mercadopago.com/v1/orders/{id}
Consulta todas as informações de uma order utilizando o ID obtido na resposta à sua criação. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
Parâmetros de requisição
PATH
id
string

OBRIGATÓRIO

ID da order, retornado na resposta à requisição para sua criação.
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.

invalid_path_param

O order_id fornecido no path da requisição não está correto. Verifique e forneça um ID válido para tentar novamente.

401Erro.

unauthorized

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

404Erro.

order_not_found

Order não encontrada. Verifique se o ID enviado está correto.

500Erro.

500

Erro interno. Tente enviar a solicitação novamente.

Requisição
curl -X GET \
    'https://api.mercadopago.com/v1/orders/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    
Resposta de exemplo
{
  "id": "123",
  "type": "point",
  "external_reference": "ext_ref_1234",
  "description": "Point Mini",
  "site_id": "MLB",
  "integration_data": {
    "application_id": 1234567890,
    "platform_id": "1234567890",
    "integrator_id": "1234567890",
    "sponsor": {
      "id": "446566691"
    }
  },
  "status": "created",
  "created_date": "2024-09-10T14:26:42.109320977Z",
  "last_updated_date": "2024-09-10T14:26:42.109320977Z",
  "type_config": {
    "terminal_id": "PAX_A910__SMARTPOS1423",
    "ticket_number": "S0392JED",
    "flow_process": "credit_card"
  },
  "transactions": {
    "payments": [
      {
        "id": "pay_01J67CQQH5904WDBVZEM4JMEP3",
        "amount": "24.90",
        "status": "created",
        "status_detail": "cancelled_by_api",
        "reference_id": "12345678",
        "payment_method": {
          "type": "credit_card",
          "installments": 1
        }
      }
    ]
  }
}