Fiziksel POS
Cihazı Ödemeye Hazırlama

Cihazı Ödemeye Hazırlama

Bir POS cihazının ödeme alabilmesi için kayıtlarının hazır, cihazın size ait olduğunun doğrulanmış ve cihazın Lunixi'ye bağlı olması gerekir. Bu sayfa cihazı sıfırdan ödemeye hazırlamayı anlatır.

Kurulum adımları

AdımNe yaparsınızUç
1Mağazayı ve isteğe bağlı olarak kasayı oluşturun.POST /stores, POST /stores/{storeId}/registers → Mağazalar · Kasalar
2Cihazı kaydedin; storeId verirseniz cihaz o mağazaya atanır. Cihaz lifecycleStatus: "PENDING", ownershipStatus: "UNVERIFIED" ile başlar.POST /devices → Cihazlar
3Cihazı eşleştirin: cihazdaki Lunixi uygulaması ekranda bir kod gösterir, kodu panelde girip onaylarsınız. Eşleşen cihaz doğrulanır ve ACTIVE olur.Panel: Cihazlar › Kodla cihaz ekle ya da cihaz detayı › Kimlik → Cihaz Kimliği
4Mantıksal terminali ve bankalardaki üye işyeri ve terminal numaralarını (banka satırları) ekleyin.POST /terminals, POST /terminals/{terminalId}/acquirers → Mantıksal Terminaller · Banka Satırları
5Cihazı terminale bağlayın.POST /terminals/{terminalId}/device-link → Cihaz Bağı
6Cihazın ödemeye hazır olduğunu kontrol edin: presence.decision: "READY".GET /devices/{deviceId} → Cihazlar › Bağlantı durumu
  • Terminalin doğrulanması cihaza bağlıdır: doğrulanmış bir cihaz terminale bağlandığında terminal de doğrulanır. Cihazı önce terminale bağlayıp sonra eşleştirirseniz terminal eşleştirmeyle doğrulanır.
  • Cihaz değiştiğinde 1, 4 ve 6. adımlar tekrarlanmaz: yeni cihazı kaydedip eşleştirir ve terminale bağlarsınız; terminal ve banka satırları aynı kalır.
  • Cihazı askıya almak ya da bakıma almak için: Cihazlar › Yaşam döngüsü.

Ödeme alabilmesi için

Cihazı ödemeye hazırlamaMağaza ve kasa oluşturulur, cihaz PENDING olarak kaydedilir, cihaz ekranındaki kod panelde onaylanarak eşleştirilir ve cihaz doğrulanıp ACTIVE olur, terminal ve banka satırı eklenir, cihaz terminale bağlanır ve cihaz hazır olunca ödeme alınır.1Mağaza ve kasaPOST /stores2Cihaz kaydıPOST /devicesPENDING3Eşleştirmepanelde kod onayıVERIFIED · ACTIVE4Terminal ve bankaPOST /terminals…/acquirers5Cihaz bağı…/device-link6Ödemeye hazırpresence READYLEJANTAPIPANEL VE CİHAZ EKRANISONUÇ
Eşleşen cihaz kendiliğinden doğrulanır ve ACTIVE olur. Cihazın hazır olup olmadığını presence.decision alanında görürsünüz.

Ödeme her zaman bir cihazda, cihazın bağlı olduğu mantıksal terminalde yürür. Cihazın ödeme alabilmesi için:

KoşulNereden görürsünüzDeğilse
Cihaz aktifCihazda lifecycleStatus: "ACTIVE"409 physical_pos.payment.device_not_payable (details.reason: lifecycle_<durum>)
Cihazın size ait olduğu doğrulanmışCihazda ownershipStatus: "VERIFIED"409 physical_pos.payment.device_not_payable (ownership_unverified)
Haberleşme kanalı tanımlıCihazda integrationChannel UNSET değil422 physical_pos.payment.operation_unsupported (channel_unset)
Cihaz bir terminale bağlıCihazda logicalTerminal dolu409 physical_pos.payment.terminal_not_payable (not_linked)
Terminal etkin ve doğrulanmışTerminalde terminalStatus: "ACTIVE", ownershipStatus: "VERIFIED"409 physical_pos.payment.terminal_not_payable (status_<durum> ya da ownership_unverified)
Cihaz ödemeye hazırCihazda presence.decision: "READY"409 physical_pos.payment.device_offline ya da 503 physical_pos.presence.unavailable → Adım 1

Cihazı kaydetme, mağazaya atama ve terminale bağlama: Cihazlar · Cihaz Bağı.

Banka satırı (isteğe bağlı). Ödemeyi belirli bir bankadan geçirmek istiyorsanız terminalin banka satırlarından birinin id değerini terminalAcquirerId olarak gönderirsiniz. Satır acquirerStatus: "ACTIVE" ve mappingStatus: "MAPPED" olmalı ve ödemenin para birimini currencies listesinde taşımalıdır. Göndermezseniz bankayı cihaz seçer. → Ödemeler › Banka satırı

Uygulama sürümünü denetleme

Android kaynak kodunda Cihaz → Uygulama sürümü kartı bulunur. Çalışan sürümü, sunucunun bu cihaza sunduğu sürümü, dağıtım kanalını ve son doğrulama zamanını gösterir. Kurulu sürüm geri çekilmişse veya önerilen asgari sürümün altındaysa uyarı görünür. Asgari sürüm politikası v1'de NOTICE_ONLY olduğundan bu uyarı ödemeleri engellemez.

Bu bilgi mevcut, cihaza ait imzalı app-release sözleşmesinden gelir; merchant API anahtarınız cihazda kullanılmaz. Manifest kuruluş, cihaz, ortam, uygulama paketi, cihaz bileşimi ve kurulu sürümle eşleştirilir. Ed25519 imzası, süre, revizyon ve uyumluluk kontrolleri geçmeden etkinleşmez. Son geçerli kopya cihazda şifreli tutulur; ağ veya doğrulama hatasında açıkça eski bilgi olarak gösterilir. Yeni bir uygulama build'ine ait olmayan eski uyarılar yeniden gösterilmez, revizyon geri düşme koruması korunur.

MQTT RELEASE_AVAILABLE yalnız denetim ipucudur; kurulum komutu değildir. Bildirimler 0–300 saniye gecikmeyle birleştirilir; bağlantı/ön plana geliş ve manifestin yarı ömrü de yenileme tetikleyebilir. Elle denetim ve bildirimler kota beklemesini veya Retry-After süresini atlayamaz. Dağıtım kanalı (Google Play, üretici mağazası, MDM veya Lunixi) MQTT taşıma kanalından ayrıdır.

Teslim sınırı: sürüm okuyucusu kaynakta hazırdır; APK indirme/kurulum, kurulum raporları ve fiziksel cihaz kabulü ayrı iştir. Bu kartta bir sürümün görünmesi o APK'nın indirildiği, kurulduğu veya prod'a dağıtıldığı anlamına gelmez. Aktif/UNKNOWN ödeme, gün sonu, bekleyen cihaz olayı ve journal/Keystore devamlılığı kurulum paketinde korunmalıdır; uygulama verisini silerek veya kaldırıp kurarak kurtarma yapılmaz.