Fiziksel POS
Ödeme İşlemleri
Ödemeleri Listeleme

Ö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ıca Digest. 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 anahtar 403 PRODUCT_NOT_ENABLED, kapsamı olmayan anahtar 403 API_INSUFFICIENT_SCOPE alı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 parametresiTipAçıklama
limitintegerSayfa başına kayıt, 1–100. Varsayılan 25.
cursorstringÖnceki yanıttaki pageInfo.nextCursor.
deviceIdstring (UUID)Cihaz.
paymentStatusstringÖdeme durumu. → Durumlar
merchantReferencestringKendi referansınızla tam eşleşme. Ağ hatasından sonra ödemenizi bulmak için kullanın.
createdFromstringOluşturulma zamanı alt sınırı, ISO 8601 UTC (Z ile biter, en çok 3 ondalık). Varsayılan: son 31 gün.
createdTostringÜst sınır, aynı biçim. Varsayılan: şimdi + 5 dakika.
  • Zaman penceresi en çok 93 gündür ve createdFrom createdTo'dan önce olmalıdır; aksi 400 physical_pos.input.filter_invalid (details.reason: range_invalid).
  • paymentStatus bü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ışı limit 400 physical_pos.validation.invalid (details.field: limit) alır. Kart numarasına benzeyen merchantReference 400 physical_pos.payment.card_data_rejected alır.
  • items ve refundItems listede boş dizi döner; kalemler için ödemeyi tek tek okuyun.
  • pageInfo.totalCount her zaman null'dır; ilerlemek için hasMore ve nextCursor kullanı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 } }.