Sonucu Belirsiz Ödeme
- 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.
Ö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.
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:
- İsteği aynı
Idempotency-Keyve aynı gövdeyle tekrarlayın. Ödeme açıldıysa200,replayed: trueile güncel hâli döner; açılmadıysa şimdi açılır. - 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şama | Ne olur | Siz ne yaparsınız |
|---|---|---|
UNKNOWN | Lunixi 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_REVIEW | Sonuç 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_unknownalırsa önceki ödeme (details.previousPaymentId) sonuçlanmamıştır;allowDuplicateReference: truegöndermeyin. resolvable: trueolan ödeme panelden çözülebilir. Son duruma geçmiş ödemeye sonradan çelişen bir kanıt gelirse durum değişmez,outcomeConflict: trueolur; ö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.