Fiziksel POS
Fiziksel POS yönetim API'si, mağazalarınızdaki POS altyapısının kayıtlarını kendi sunucunuzdan yönetmenizi sağlar: mağaza ve kasa tanımları, mantıksal terminaller, terminallerin banka bilgileri (üye işyeri ve terminal numaraları), cihazlar ve terminale bağlı cihaz. Aynı kayıtları panelde de görür ve düzenlersiniz; API ile panel aynı veriyi kullanır.
Bu bölüm yalnız yönetim uçlarını anlatır. Ödeme işlemleri bu uçların kapsamında değildir. Üretici hesapları (POS üreticisindeki hesabınızın bilgileri) yalnız panelden yönetilir; API'de karşılığı yoktur.
Ne sunar
| Yetenek | Açıklama |
|---|---|
| Katalog | Platformda tanımlı POS üreticileri, cihaz modelleri (görselleriyle) ve fiziksel POS'ta kullanılabilen bankalar. Yalnız okunur. → Katalog |
| Mağazalar | Mağaza oluşturma, güncelleme, arşivleme ve yeniden açma; mağaza başına değişiklik geçmişi. → Mağazalar |
| Kasalar | Mağazaya bağlı kasalar; oluşturma, yeniden adlandırma, arşivleme ve yeniden açma. → Kasalar |
| Mantıksal terminaller | Ödeme kabul eden terminal kayıtları: terminal kodu, üretici, üretici tarafındaki kimlikler, durum ve kapanış. → Mantıksal Terminaller |
| Banka satırları | Bir terminalin her bankadaki üye işyeri numarası (MID), terminal numarası (TID) ve para birimleri. → Banka Satırları |
| Cihazlar | Fiziksel POS cihazlarını kaydetme, mağazaya ya da kasaya atama, depoya alma ve emeklilik; atama ve değişiklik geçmişi. → Cihazlar |
| Cihaz bağı | Terminale bağlı cihazı değiştirme ya da bağı çözme; bağ geçmişi. → Cihaz Bağı |
| Genel bakış sayaçları | Aktif ve arşivli mağaza ve kasa sayıları, açık ve kapalı terminal sayıları, durumlara göre cihaz sayıları. → Genel Bakış Sayaçları |
Temel kavramlar
Mağaza ve kasa
Mağaza, işletmenizin bir satış noktasıdır (şube, mağaza, servis noktası). Kasa, bir mağazanın içindeki ödeme noktasıdır ve her zaman tek bir mağazaya aittir; kasa başka mağazaya taşınmaz.
Mağaza ve kasa ortamsızdır: test ve canlı ortam aynı mağaza ve kasa kayıtlarını görür. → Ortamlar
Mağaza ve kasa silinmez, arşivlenir. Arşivli kayıt kodunu korur ve yeniden açılabilir. Mağaza arşivlendiğinde aktif kasaları da aynı işlemde arşivlenir; mağaza yeniden açıldığında kasalar arşivli kalır.
Cihaz ve mantıksal terminal
Fiziksel POS'ta iki ayrı kayıt vardır:
| Kayıt | Nedir | Örnek |
|---|---|---|
| Cihaz | Elle tutulan donanım: üreticisi, modeli ve seri numarası olan POS cihazı. | Mağazadaki bir masaüstü POS |
| Mantıksal terminal | Ödemeyi kabul eden kimlik: terminal kodu, üretici ve bankalardaki üye işyeri ve terminal numaraları bu kayıttadır. | IST-KADIKOY-01 kodlu terminal |
Cihaz değiştiğinde (arıza, kayıp, yenileme) mantıksal terminal ve banka bilgileri aynı kalır; yalnız terminale bağlı cihaz değişir. Bu ilişkiye cihaz bağı denir:
- Bir terminalin aynı anda en çok bir bağlı cihazı olur.
- Bir cihaz aynı anda en çok bir terminale bağlıdır.
Mantıksal terminal ortamlıdır: her terminal test ya da canlı ortamdadır ve bu sonradan değişmez.
Zincir
Kayıtlar birbirine şöyle bağlanır:
Mağaza
└─ Kasa
└─ Cihaz (mağazaya, isteğe bağlı olarak kasaya atanır)
└─ Mantıksal terminal (cihaz bağı)
└─ Banka satırları (bankalardaki MID / TID)Mantıksal terminal mağazaya doğrudan değil, bağlı olduğu cihaz üzerinden bağlanır: cihaz bir mağazaya (ve isteğe bağlı olarak o mağazanın bir kasasına) atanır, terminal de o cihaza bağlanır. Bu yüzden cihaz değişse bile terminalin kimliği ve banka bilgileri korunur.
Katalog
Katalog, platform genelinde ortak referans verisidir: üreticiler, cihaz modelleri ve bankalar. Kataloğu yalnız okursunuz. Terminal oluştururken vendorCode üretici listesinden gelir; banka satırındaki vendorAcquirerRef, üreticinin banka kodu eşlemesiyle katalogdaki bankaya bağlanır.
Uçlar
Taban adres: https://api-gateway.lunixi.com/api/v1/physical-pos
| Yöntem | Yol | Kapsam | Sayfa |
|---|---|---|---|
GET | /catalog/vendors | physical_pos:view | Katalog |
GET | /catalog/device-models | physical_pos:view | Katalog |
GET | /catalog/acquirers | physical_pos:view | Katalog |
GET | /stores | physical_pos:view | Mağazalar |
POST | /stores | physical_pos:manage | Mağazalar |
GET | /stores/{storeId} | physical_pos:view | Mağazalar |
PATCH | /stores/{storeId} | physical_pos:manage | Mağazalar |
POST | /stores/{storeId}/archive | physical_pos:manage | Mağazalar |
POST | /stores/{storeId}/restore | physical_pos:manage | Mağazalar |
GET | /stores/{storeId}/audit | physical_pos:view | Mağazalar |
GET | /stores/{storeId}/registers | physical_pos:view | Kasalar |
POST | /stores/{storeId}/registers | physical_pos:manage | Kasalar |
PATCH | /registers/{registerId} | physical_pos:manage | Kasalar |
POST | /registers/{registerId}/archive | physical_pos:manage | Kasalar |
POST | /registers/{registerId}/restore | physical_pos:manage | Kasalar |
GET | /registers/{registerId}/audit | physical_pos:view | Kasalar |
GET | /terminals | physical_pos:view | Mantıksal Terminaller |
POST | /terminals | physical_pos:manage | Mantıksal Terminaller |
GET | /terminals/{terminalId} | physical_pos:view | Mantıksal Terminaller |
PATCH | /terminals/{terminalId} | physical_pos:manage | Mantıksal Terminaller |
POST | /terminals/{terminalId}/close | physical_pos:manage | Mantıksal Terminaller |
GET | /terminals/{terminalId}/audit | physical_pos:view | Mantıksal Terminaller |
GET | /terminals/{terminalId}/acquirers | physical_pos:view | Banka Satırları |
POST | /terminals/{terminalId}/acquirers | physical_pos:manage | Banka Satırları |
PATCH | /terminal-acquirers/{terminalAcquirerId} | physical_pos:manage | Banka Satırları |
GET | /devices | physical_pos:view | Cihazlar |
POST | /devices | physical_pos:manage | Cihazlar |
GET | /devices/{deviceId} | physical_pos:view | Cihazlar |
PATCH | /devices/{deviceId} | physical_pos:manage | Cihazlar |
POST | /devices/{deviceId}/assignment | physical_pos:manage | Cihazlar |
POST | /devices/{deviceId}/assignment/close | physical_pos:manage | Cihazlar |
POST | /devices/{deviceId}/retire | physical_pos:manage | Cihazlar |
GET | /devices/{deviceId}/assignments | physical_pos:view | Cihazlar |
GET | /devices/{deviceId}/audit | physical_pos:view | Cihazlar |
POST | /terminals/{terminalId}/device-link | physical_pos:manage | Cihaz Bağı |
POST | /terminals/{terminalId}/device-link/close | physical_pos:manage | Cihaz Bağı |
GET | /terminals/{terminalId}/links | physical_pos:view | Cihaz Bağı |
GET | /overview | physical_pos:view | Genel Bakış Sayaçları |
Bu uçlar API anahtarınızla imzalanmış istek ister ve anahtarınızda Fiziksel POS ürünü (PHYSICAL_POS) tanımlı olmalıdır. → Kimlik Doğrulama ve Kapsamlar