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ım | Ne yaparsınız | Uç |
|---|---|---|
| 1 | Mağazayı ve isteğe bağlı olarak kasayı oluşturun. | POST /stores, POST /stores/{storeId}/registers → Mağazalar · Kasalar |
| 2 | Cihazı kaydedin; storeId verirseniz cihaz o mağazaya atanır. Cihaz lifecycleStatus: "PENDING", ownershipStatus: "UNVERIFIED" ile başlar. | POST /devices → Cihazlar |
| 3 | Cihazı 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 |
| 4 | Mantı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ı |
| 5 | Cihazı terminale bağlayın. | POST /terminals/{terminalId}/device-link → Cihaz Bağı |
| 6 | Cihazı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
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şul | Nereden görürsünüz | Değilse |
|---|---|---|
| Cihaz aktif | Cihazda 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ğil | 422 physical_pos.payment.operation_unsupported (channel_unset) |
| Cihaz bir terminale bağlı | Cihazda logicalTerminal dolu | 409 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ır | Cihazda 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.