Recursos para IA
Obter order por ID

Este endpoint permite consultar todas as informações de uma order Wallet Connect utilizando o ID obtido na resposta do endpoint POST /v1/orders. Em caso de sucesso, a requisição retornará uma resposta com o status 200.

GET

https://api.mercadopago.com/v1/orders/{id}
Request parameters
Header
Authorization
string

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Path
id
string

OBRIGATÓRIO

ID da order a ser consultada, retornado na resposta do endpoint POST /v1/orders.
Response parameters
id
string
Identificador da order, gerado automaticamente pelo Mercado Pago quando a order é criada por meio do endpoint POST /v1/orders.
type
string
Tipo de order.
online: Valor associado à criação de orders para pagamentos com Wallet Connect.
processing_mode
string
Indica como a order será processada. Para orders Wallet Connect, o único valor permitido é automatic.
automatic: A order é processada automaticamente em uma única etapa.
external_reference
string
É a referência externa da order, atribuída no momento da criação. Este campo deve ter no máximo 64 caracteres e deve conter apenas números, letras, hífens (-) e sublinhados (_). Caracteres especiais como ([ ], (), '', @)
Erros

400Erro de requisição.

invalid_path_param

O order_id fornecido no path não é válido. Verifique e forneça um order_id válido para tentar novamente.

401Erro. Access Token não autorizado.

unauthorized

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

invalid_credentials

Não há suporte para credenciais de teste. Utilize usuários de teste com credenciais de produção para o ambiente de teste (sandbox) e as suas credenciais de produção para o ambiente de produção.

404Recurso não encontrado.

order_not_found

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

500Erro genérico.

internal_error

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

Request
curl -X GET \
    'https://api.mercadopago.com/v1/orders/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
    
Response
{
  "id": "ORDBTA01KHY4WFPYXJ9Z7S5CGED7WCTP",
  "type": "online",
  "processing_mode": "automatic",
  "external_reference": "ext_ref_1234",
  "description": "Smartphone",
  "total_amount": "50.00",
  "total_paid_amount": "50.00",
  "country_code": "CO",
  "user_id": "1090806071",
  "status": "processed",
  "status_detail": "accredited",
  "capture_mode": "automatic",
  "currency": "COP",
  "created_date": "2026-02-20T18:27:08.639Z",
  "last_updated_date": "2026-02-20T18:27:09.797Z",
  "integration_data": {
    "application_id": "8251964915044164",
    "platform_id": "123abc"
  },
  "transactions": {
    "payments": [
      {
        "id": "PAY01KHY4WFPYXJ9Z7S5CGG0SE8KN",
        "amount": "50.00",
        "paid_amount": "47.28",
        "reference_id": "30f45a189ec043c28e6c4b73e0dd65a3",
        "status": "processed",
        "status_detail": "accredited",
        "attempts": [
          {
            "id": "514336a54ba74712a2478d0e79c92b14",
            "status": "processed",
            "status_detail": "accredited",
            "payment_method": {
              "id": "wallet",
              "type": "wallet",
              "installments": 1
            }
          }
        ],
        "payment_method": {
          "id": "wallet",
          "type": "wallet",
          "statement_descriptor": "Descriptor",
          "installments": 1
        },
        "stored_credential": {
          "payment_initiator": "merchant",
          "reason": "recurring"
        }
      }
    ]
  }
}