Detalle de pedido
Obtenga los detalles completos de un pedido (order) específico o consulte su estado actual.
Obtener detalles del pedido
GET /orders/:id
Parámetros de ruta
| Nombre | Tipo | Requerido | Descripción |
|---|
id | string | Sí | El ID del pedido (p. ej., ord-a1b2c3d4-e5f6-7890-abcd-ef1234567890) |
Respuesta
{
"id": "ord-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "COMPLETED",
"products": [
{
"productId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"productTypeId": 1,
"productName": "Austria 10-Day Vignette",
"quantity": 1,
"status": "COMPLETED",
"vehiclePlate": "AB123CD",
"vehicleCountryIsocode": "AT",
"startAt": "2026-04-01T00:00:00.000Z",
"endAt": "2026-04-10T23:59:59.000Z"
}
],
"payment": {
"type": "CARD",
"status": "CAPTURED",
"paidAt": "2026-03-20T14:31:10.000Z"
},
"customer": {
"email": "john.doe@example.com",
"firstName": "John",
"lastName": "Doe"
},
"total": {
"amount": 11.5,
"currency": "EUR"
},
"externalReference": "YOUR-ORDER-REF-001",
"idempotencyKey": "unique-order-key-12345",
"createdAt": "2026-03-20T14:30:00.000Z",
"completedAt": "2026-03-20T14:31:15.000Z"
}
Obtener estado del pedido
Un endpoint ligero que devuelve únicamente el estado actual del pedido, útil para consultas periódicas (polling).
GET /orders/:id/status
Parámetros de ruta
| Nombre | Tipo | Requerido | Descripción |
|---|
id | string | Sí | El ID del pedido |
Respuesta
{
"id": "ord-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "COMPLETED",
"updatedAt": "2026-03-20T14:31:15.000Z"
}
Estados de pedido
| Estado | Descripción |
|---|
PENDING | Pedido creado, esperando confirmación de pago |
PROCESSING | Pago confirmado, productos en proceso de aprovisionamiento |
COMPLETED | Todos los productos entregados exitosamente |
FAILED | Fallo en el pago o error en el aprovisionamiento del producto |
CANCELLED | El pedido fue cancelado |
REFUNDED | El pedido fue reembolsado |