📦 Órdenes

Consulta de órdenes de pago existentes.

Las órdenes se identifican por:

• order_uuid: Reference de EPN.

• bookingId: identificador de reserva del sistema cliente.

El campo order_refunded se devuelve en unidades monetarias (no céntimos).

Listar órdenes recientes del usuario

get

Lista las órdenes más recientes para los comercios del usuario autenticado. Si es admin, devuelve todas las órdenes.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Query parameters

limitintegerOptionalDefault: 100

offsetintegerOptionalDefault: 0

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

get

/admin/orders

HTTPcURLJavaScriptPython

GET /admin/orders HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Consultar una orden por UUID o bookingId

post

Consulta una orden de pago por su order_uuid o por bookingId.

No requiere autenticación JWT (endpoint público para consultas de estado).

Body:

{"order_uuid": "A1B2C3D4-5678-..."}

o

{"bookingId": "BOOK-123"}

Si se proporciona bookingId, devuelve la última orden (más reciente) asociada.

Respuesta:

Campo	Tipo	Descripción
order_uuid	string	UUID de la orden (Paylands) o Reference (EPN)
booking_id	string	ID de la reserva en el sistema cliente
order_paid	bool	Si el pago fue aceptado
order_status	string	Estado: SUCCESS, REFUSED, PENDING, ACCEPTED, etc.
order_refunded	float	Importe reembolsado en unidades monetarias (no céntimos)
cof_txnid	string	ID de transacción CoF / código de autorización
card_uuid	string	UUID de la tarjeta tokenizada asociada

Body

application/json

Other propertiesanyOptional

Responses

200

Orden encontrada.

application/json

anyOptional

400

Ni order_uuid ni bookingId proporcionados.

404

Orden no encontrada.

422

Validation Error

application/json

post

/orders

HTTPcURLJavaScriptPython

POST /orders HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

{
  "order_uuid": "A1B2C3D4-...",
  "booking_id": "BOOK-123",
  "order_paid": true,
  "order_status": "SUCCESS",
  "order_refunded": 0,
  "cof_txnid": "123456",
  "card_uuid": "FCE5AB1B-..."
}

Obtener la última orden de un bookingId (opcionalmente filtrada por order_uuid)

post

Devuelve la última (más reciente) orden asociada al bookingId indicado.

Si se proporciona order_uuid, se filtra además por ese UUID concreto, permitiendo obtener una orden específica dentro de las asociadas al booking.

No requiere autenticación JWT.

Body:

{"bookingId": "BOOK-123"}

o, para una búsqueda más específica:

{"bookingId": "BOOK-123", "order_uuid": "A1B2C3D4-5678-..."}

Respuesta: Misma estructura que POST /orders.

Body

application/json

Other propertiesanyOptional

Responses

200

Última orden encontrada.

application/json

anyOptional

400

bookingId no proporcionado.

404

No existen órdenes para el bookingId.

422

Validation Error

application/json

post

/lastOrder

HTTPcURLJavaScriptPython

POST /lastOrder HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

No content