Ödemeleri Listeleme
Bu uçları kim çağırır?Dış API (s2s)
- Taban yol
/api/v1/physical-pos- Kimlik
- Her istekte Ed25519 istek imzası —
X-Key-Id,X-Date,X-Nonce,X-Signature; gövdeli isteklerde ayrıcaDigest. Zaman penceresi ±5 dk, nonce tek kullanımlık. Bearer jetonu ya da panel oturumu bu uçlarda kabul edilmez. - Yetki
- Anahtarınız Fiziksel POS ürününü (
PHYSICAL_POS) ve bu sayfadaki uçların kapsamını taşımalıdır:physical_pos:view·physical_pos:payments. Ürünü olmayan anahtar403 PRODUCT_NOT_ENABLED, kapsamı olmayan anahtar403 API_INSUFFICIENT_SCOPEalır. Bkz. Kimlik Doğrulama ve Kapsamlar. - Çapraz yüzey
- Bu uçlar s2s yüzeyindedir; kendi sunucunuzdan imzalı istekle çağırırsınız. Aynı kayıtların panelde ekranları var, ama panel uçları API anahtarıyla çağrılamaz; bu uçlar da panel oturumuyla çağrılamaz.
Ödemeleri listeleme
GET /api/v1/physical-pos/payments
Kökler ve çocuklar aynı listede, en yeni önce döner; ayırmak için operation ve rootPaymentId alanlarını kullanın. Bir kökü ters işlemleriyle birlikte listelemek için İşlemler ucu daha uygundur.
| Sorgu parametresi | Tip | Açıklama |
|---|---|---|
limit | integer | Sayfa başına kayıt, 1–100. Varsayılan 25. |
cursor | string | Önceki yanıttaki pageInfo.nextCursor. |
deviceId | string (UUID) | Cihaz. |
paymentStatus | string | Ödeme durumu. → Durumlar |
merchantReference | string | Kendi referansınızla tam eşleşme. Ağ hatasından sonra ödemenizi bulmak için kullanın. |
createdFrom | string | Oluşturulma zamanı alt sınırı, ISO 8601 UTC (Z ile biter, en çok 3 ondalık). Varsayılan: son 31 gün. |
createdTo | string | Üst sınır, aynı biçim. Varsayılan: şimdi + 5 dakika. |
- Zaman penceresi en çok 93 gündür ve
createdFromcreatedTo'dan önce olmalıdır; aksi400 physical_pos.input.filter_invalid(details.reason:range_invalid). paymentStatusbüyük/küçük harfe duyarlı değildir. Geçersiz süzgeç400 physical_pos.input.filter_invalid(details.field), bozuk imleç400 physical_pos.cursor.invalid, aralık dışılimit400 physical_pos.validation.invalid(details.field:limit) alır. Kart numarasına benzeyenmerchantReference400 physical_pos.payment.card_data_rejectedalır.itemsverefundItemslistede boş dizi döner; kalemler için ödemeyi tek tek okuyun.pageInfo.totalCounther zamannull'dır; ilerlemek içinhasMorevenextCursorkullanın. → Sayfalama
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 } }.