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, plusDigeston 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 gets403 PRODUCT_NOT_ENABLED; without the scope403 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 parameter | Type | Description |
|---|---|---|
limit | integer | Records per page, 1–100. Default 25. |
cursor | string | pageInfo.nextCursor from the previous response. |
deviceId | string (UUID) | Device. |
paymentStatus | string | Payment status. → Statuses |
merchantReference | string | Exact match on your reference. Use it to find your payment after a network error. |
createdFrom | string | Lower bound of the creation time, ISO 8601 UTC (ends with Z, at most 3 decimals). Default: last 31 days. |
createdTo | string | Upper bound, same format. Default: now + 5 minutes. |
- The time window is at most 93 days and
createdFrommust be beforecreatedTo; otherwise400 physical_pos.input.filter_invalid(details.reason:range_invalid). paymentStatusis case-insensitive. An invalid filter gets400 physical_pos.input.filter_invalid(details.field), a broken cursor400 physical_pos.cursor.invalid, an out-of-rangelimit400 physical_pos.validation.invalid(details.field:limit). AmerchantReferencethat looks like a card number gets400 physical_pos.payment.card_data_rejected.itemsandrefundItemscome back as empty arrays in the list; read a payment on its own for its items.pageInfo.totalCountis alwaysnull; usehasMoreandnextCursorto 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 } }.