Physical POS
Payment Operations
List Payments

List Payments

Who calls these endpoints?External API (s2s)
Base path
/api/v1/physical-pos
Identity
Ed25519 request signature on every request — X-Key-Id, X-Date, X-Nonce, X-Signature, plus Digest on requests with a body. ±5 min clock window, single-use nonce. A Bearer token or a panel session is not accepted here.
Authorization
The key must carry the Physical POS product (PHYSICAL_POS) and the scope for the endpoints on this page: physical_pos:view · physical_pos:payments. Without the product the call gets 403 PRODUCT_NOT_ENABLED; without the scope 403 API_INSUFFICIENT_SCOPE. See Authentication and Scopes.
Cross-surface
These endpoints are the s2s surface — call them from your own server with a signed request. The same records have screens in the panel, but panel endpoints cannot be called with an API key, and these endpoints cannot be called with a panel session.

List payments

GET /api/v1/physical-pos/payments

Roots and children come back in one list, newest first; tell them apart with operation and rootPaymentId. To list a root together with its reversals, the Transactions endpoint is a better fit.

Query parameterTypeDescription
limitintegerRecords per page, 1–100. Default 25.
cursorstringpageInfo.nextCursor from the previous response.
deviceIdstring (UUID)Device.
paymentStatusstringPayment status. → Statuses
merchantReferencestringExact match on your reference. Use it to find your payment after a network error.
createdFromstringLower bound of the creation time, ISO 8601 UTC (ends with Z, at most 3 decimals). Default: last 31 days.
createdTostringUpper bound, same format. Default: now + 5 minutes.
  • The time window is at most 93 days and createdFrom must be before createdTo; otherwise 400 physical_pos.input.filter_invalid (details.reason: range_invalid).
  • paymentStatus is case-insensitive. An invalid filter gets 400 physical_pos.input.filter_invalid (details.field), a broken cursor 400 physical_pos.cursor.invalid, an out-of-range limit 400 physical_pos.validation.invalid (details.field: limit). A merchantReference that looks like a card number gets 400 physical_pos.payment.card_data_rejected.
  • items and refundItems come back as empty arrays in the list; read a payment on its own for its items.
  • pageInfo.totalCount is always null; use hasMore and nextCursor to move on. → Pagination
source lunixi-sign.sh
REQ_PATH="/api/v1/physical-pos/payments?merchantReference=ORD-2026-000123"
lunixi_sign GET "$REQ_PATH"
 
curl "https://api-gateway.lunixi.com$REQ_PATH" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" \
  -H "X-Date: $DATE" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"

data: { "items": [ { … } ], "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": null } }.