Fiziksel POS
Ödeme İşlemleri
Sonucu Belirsiz Ödeme

Sonucu Belirsiz Ödeme

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.

Ödemenin sonucunu bilmediğiniz iki durum vardır: başlatma isteğinize yanıt alamamışsınızdır, ya da ödeme UNKNOWN durumuna geçmiştir. İkisinde de para çekilmiş olabilir.

🚫

Aynı satış için yeni bir Idempotency-Key ile ASLA yeni ödeme başlatmayın. Sonuç belirsizken para çekilmiş olabilir; yeni anahtar müşterinizden iki kez tahsilat yapabilir. Lunixi belirsiz ödemeyi hiçbir zaman otomatik olarak yeniden tahsil etmez.

Sonucu belirsiz ödemeyi kurtarmaYanıt alınamazsa istek aynı Idempotency-Key ve gövdeyle tekrarlanır; ödeme UNKNOWN olursa beklenir ve yeniden başlatılmaz, kanıt gelirse son duruma geçer, gelmezse MANUAL_REVIEW olur ve panelde kanıtla çözülür.KANIT GELDİNETLEŞMEDİPANELDE ÇÖZÜMYanıt yokzaman aşımı · 5xxAynı anahtar vegövdeyle tekrarIdempotency-KeyGüncel hâl döner200 replayed · 202ya da ?merchantReferenceUNKNOWNpayment.unknownBekleyin, yenidenbaşlatmayıncihaz ~10 dk kilitliSon durumwebhookMANUAL_REVIEWkanıtla çözün · RRNLEJANTDURUMYAPACAĞINIZSONUÇPANEL
Yeni bir Idempotency-Key ile yeni ödeme başlatmak müşteriden iki kez tahsilat yapabilir.

Yanıt alamadıysanız

Zaman aşımı, bağlantı kopması ya da 5xx aldıysanız:

  1. İsteği aynı Idempotency-Key ve aynı gövdeyle tekrarlayın. Ödeme açıldıysa 200, replayed: true ile güncel hâli döner; açılmadıysa şimdi açılır.
  2. Ya da ödemeyi kendi referansınızla bulun:
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"

Ödeme UNKNOWN olduysa

Sonuç resultDeadlineAt anına kadar gelmezse ödeme DECLINED değil UNKNOWN olur ve physical_pos.payment.unknown webhook'u gönderilir.

AşamaNe olurSiz ne yaparsınız
UNKNOWNLunixi sonucu otomatik doğrular. Bu sürede (varsayılan 10 dakika) cihaz yeni ödeme almaz: 409 physical_pos.payment.device_busy (unknown_outcome_hold, details.retryAfterSeconds).Bekleyin. Sonuç kesinleşirse ödeme son durumuna geçer ve ilgili webhook gelir.
MANUAL_REVIEWSonuç otomatik doğrulanamadı; physical_pos.payment.manual_review gönderilir. Cihaz yeniden ödeme alabilir; sonuç arka planda 7 güne kadar sorgulanmaya devam eder.Otomatik kontrol kesin bilgi sağlayamazsa son seçenek olarak ödemeyi panelden kanıtla çözebilirsiniz: banka ekstresi, gün sonu raporu, cihaz fişi gibi. "Para çekildi" kararı bankanın onay kodunu ya da RRN değerini ister. Bu işlemin API ucu yoktur.
ÇözüldüÖdeme son durumuna geçer; webhook yükünde resolvedBy: "MERCHANT" bulunur.Siparişinizi webhook'a göre güncelleyin.
  • Belirsiz ödeme iptal edilemez (409 physical_pos.payment.not_cancellable, outcome_unknown) ve geri alınamaz (409 physical_pos.payment.not_reversible, root_not_approved).
  • Aynı referansla yeni satış 409 physical_pos.payment.previous_outcome_unknown alırsa önceki ödeme (details.previousPaymentId) sonuçlanmamıştır; allowDuplicateReference: true göndermeyin.
  • resolvable: true olan ödeme panelden çözülebilir. Son duruma geçmiş ödemeye sonradan çelişen bir kanıt gelirse durum değişmez, outcomeConflict: true olur; ödemeyi panelde inceleyin.

Belirsiz ödemeleri listeleme

source lunixi-sign.sh
REQ_PATH="/api/v1/physical-pos/transactions/ambiguous?paymentStatus=MANUAL_REVIEW"
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"

UNKNOWN ve MANUAL_REVIEW durumundaki bütün ödemeler (kökler ve ters işlemler) en yeni önce döner. Parametreler: İşlemler › Sonucu belirsiz ödemeler. Akışın ayrıntısı: Ödeme Akışı › Sonucu belirsiz ödeme.

Cihazın tekrar kullanılabilmesi ile sonucun kesinleşmesi farklıdır

K-43 bekleme politikasından sonra sunucu özgün rezervasyonu bırakıp ödemeyi MANUAL_REVIEW'da tutabilir. Bu, aynı satışın yeni anahtarla tekrar çekilmesine izin vermez. Android yalnız kimliği/challenge'ı/özgün komutu doğrulanmış güncel sunucu yanıtını kalıcı saklayarak eski yerel rezervasyonu bırakır; yerel süre doldu diye açılmaz. Yeni, ayrı işlem bütün yetki/SDK/güven koşullarını ayrıca karşılar. İşleme ait çelişki incelemesi cihaz-geneli kalıcı yasak koymaz. Tekrar NFC/aynı sonuç mesajı yeni tahsilat değildir; geçerli kimlik/sandbox ve veri bütünlüğü kapıları sürer.

Ortak kurtarma altyapısı kaynakta eklendi; exact üretici query/callback sürücüsü ve fiziksel cihaz kabulü açık kalır. Mali belge için ayrı kurtarma sınırları geçerlidir. Banka onaylıyken belge sorunu nedeniyle yeniden tahsilat yapılmaz.

Otomatik kaçan işlem kontrolü ve mevcut sınırlar

Tek işlem sorgusu ile bütün sağlayıcı işlem geçmişinin taranması farklıdır. Hedef; hesabın/terminal bağının etkinleştiği andan ilk geçmiş taraması, ardından düzenli güncel tarama, örtüşen aralıklar ve kesintide kalan boşlukların tamamlanmasıdır. Bu sırada eksik sonuçlar kesin sağlayıcı kanıtıyla eşleştirilir; yeni ödeme başlatılmaz.

Kaynakta rapor işi artık ilk hesap/merchant bağının UTC oluşturulma gününden düne kadar geçmişi kalıcı, sınırlı parçalarla planlar; son 7 günü önceliklendirir. Tamamlanmamış gün yalnız yaşlandığı için düşmez. Eski EXPIRED satır değişmeden kalır, yeni bağlı deneme açılır. Cursor yalnız kuyruğa alınan günleri gösterir; tamamlanma bilgisi sağlayıcı raporu kapsamında ayrıca döner. Sayfa/host/sağlayıcı hatası boş başarılı rapor değildir.

Rapor yeni bir aday bulursa durmuş UNKNOWN/MANUAL_REVIEW sorgusunu uyandırır. Rutin 7 günlük review süresi sonrasında bu ipucu bir yeni uzaktan kesin doğrulama fırsatı sağlar; altı hızlı cihaz komutu bütçesini sıfırlamaz. Advisory/belirsiz rapor tek başına ödeme onayı üretmez. Vadesi gelmiş mevcut kuyruk kayıtları da 7/35 gün yaşlandıkları için atılmaz; kapanmış her eski ödeme sürekli yeniden sorgulanmaz.

COMPLETE günlerin sürekli yeniden denetimi, gün içi kesin başlangıç sınırı ve üreticilerin geçmiş/saat dilimi/retention garantileri açık devam işleridir. Metropol LIVE host listesi henüz yapılandırılmadı. Bu kaynak teslimidir; prod veya bütün üreticiler için destek duyurusu değildir.