Recursos para IA
Obtener order por ID

Este endpoint permite consultar toda la información de una order Wallet Connect utilizando el ID obtenido en la respuesta del endpoint POST /v1/orders. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.

GET

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

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Path
id
string

REQUERIDO

ID de la order que se desea consultar, devuelto en la respuesta del endpoint POST /v1/orders.
Response parameters
id
string
Identificador de la order, generado automáticamente por Mercado Pago cuando la order se crea a través del endpoint POST /v1/orders.
type
string
Tipo de order.
online: Valor asociado a la creación de orders para pagos con Wallet Connect.
processing_mode
string
Indica cómo será procesada la order. Para orders Wallet Connect, el único valor posible es automatic.
automatic: La order se procesa automáticamente en un solo paso.
external_reference
string
Es una referencia externa de la order, asignada al momento de su creación. Este campo debe tener como máximo 64 caracteres y estos solo pueden ser números, letras, guiones medios (-) y guiones bajos (_). Caracteres espec
Errors

400Error de solicitud.

invalid_path_param

El order_id proporcionado en el path no es válido. Compruébalo y proporciona un order_id válido para volver a intentarlo.

401Error. Access Token no autorizado.

unauthorized

El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la petición enviando el valor correcto.

invalid_credentials

No hay soporte para credenciales de prueba. Utiliza usuarios de prueba con credenciales de producción para el entorno de prueba (sandbox) y tus credenciales de producción para el entorno de producción.

404Recurso no encontrado.

order_not_found

Order no encontrada. Comprueba si enviaste el order_id correcto.

500Error genérico.

internal_error

Error genérico. Intenta enviar la solicitud nuevamente.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/orders/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
    
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": "BR",
  "user_id": "1090806071",
  "status": "processed",
  "status_detail": "accredited",
  "capture_mode": "automatic",
  "currency": "BRL",
  "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"
        }
      }
    ]
  }
}