Saltar al contenido
docs
Guías
EN
Pedidos

Obtener un pedido UCP

GET/ucp/orders/{id}

Obtener un pedido UCP. Una solicitud exitosa devuelve HTTP 200 con el cuerpo de respuesta documentado.

Autorización

AutorizaciónBearer <token>

Token de acceso OAuth 2.0 emitido por Ecomiq Auth.

Ubicación: header

Parámetros de ruta

id*string

Identificador único del recurso.

Parámetros de cabecera

Authorization*string

Token bearer OAuth 2.0.

x-Store-Domain*string

Slug o dominio configurado que selecciona el contexto de tienda para UCP.

Longitud1 <= length <= 253
UCP-Agent*string

Perfil del agente en el formato profile="https://agent.example/.well-known/ucp".

Longitud1 <= length
Idempotency-Key?string

Clave de idempotencia opcional para reintentar solicitudes UCP de forma segura.

Longitud1 <= length <= 300

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

curl -X GET "https://example.com/ucp/orders/7204558912004325301" \  -H "Authorization: Bearer <token>" \  -H "x-Store-Domain: my-store" \  -H "UCP-Agent: profile="https://agent.example/.well-known/ucp"" \  -H "Idempotency-Key: checkout-2026-0001"
{  "ucp": {    "version": "example",    "status": "example",    "capabilities": {      "key": [        {          "version": "example"        }      ]    },    "payment_handlers": {      "key": [        {          "id": "7204558912004325301",          "version": "example",          "spec": "example",          "schema": "example",          "available_instruments": [            {              "type": "example",              "constraints": {}            }          ],          "config": {}        }      ]    }  },  "id": "7204558912004325301",  "checkout_id": "7204558912004325301",  "permalink_url": "https://example.com/resource",  "fulfillment": {    "expectations": [      {        "id": "7204558912004325301",        "method_type": "example",        "destination": {          "extended_address": "example",          "street_address": "example",          "address_locality": "example",          "address_region": "example",          "address_country": "example",          "postal_code": "example_code",          "first_name": "Example resource",          "last_name": "Example resource"        },        "line_items": [          {            "id": "7204558912004325301",            "quantity": 1          }        ],        "description": "Example description.",        "fulfillable_on": "example"      }    ],    "events": [      {        "id": "7204558912004325301",        "occurred_at": "2026-08-01T15:30:00Z",        "type": "example",        "line_items": [          {            "id": "7204558912004325301",            "quantity": 1          }        ],        "tracking_number": "example",        "tracking_url": "https://example.com/resource",        "carrier": "example",        "description": "Example description."      }    ]  },  "currency": "PEN",  "label": "example",  "line_items": [    {      "id": "7204558912004325301",      "item": {        "id": "7204558912004325301",        "title": "Example title",        "price": 1,        "quantity_unit": {          "unit": "example",          "display_text": "example",          "scale": 1,          "increment": 1        },        "unit_price": {          "amount": 1,          "currency": "PEN",          "measure": {            "value": 1,            "unit": "example",            "display_text": "example",            "scale": 1          },          "reference": {            "value": 1,            "unit": "example",            "display_text": "example",            "scale": 1          }        },        "image_url": "https://example.com/resource"      },      "quantity": {        "total": 1,        "fulfilled": 1,        "original": 1      },      "status": "example",      "totals": [        {          "type": "example",          "amount": 1,          "display_text": "example",          "lines": [            {              "display_text": "example",              "amount": 1            }          ]        }      ],      "parent_id": "7204558912004325301"    }  ]}