Fiziksel POS
Ödeme İşlemleri
Ödeme Sorgulama

Ödeme Sorgulama

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.

Ödeme okuma

GET /api/v1/physical-pos/payments/{paymentId}

Ödemeyi kalemleri ve iade kalemleriyle döndürür: { "payment": { … } }. Kök ya da çocuk kimliği kullanılabilir. Bu uç sorgu parametresi almaz. Olmayan, başka organizasyona ait ya da diğer ortamdaki ödeme aynı cevabı alır: 404 physical_pos.payment.not_found.

Bir ödemenin bütün ters işlemlerini ve zaman çizelgesini tek yanıtta almak için: İşlemler › İşlem ayrıntısı.

source lunixi-sign.sh
REQ_PATH="/api/v1/physical-pos/payments/01900000-0000-7000-8000-000000000501"
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"
  • Kararınızı paymentStatus alanına göre verin. → Ödeme durumları
  • Asıl ödemede reversalStatus, reversedMinor ve pendingReversalId ters işlemlerin toplam etkisini gösterir.
  • Bütün alanlar: Ödeme Nesnesi.