Fiziksel POS
Ödeme İşlemleri
Satış Uygulaması Kimliği

Satış Uygulaması Kimliği

Bu kayıt öncelikle Lunixi API'sine entegre olan restoran, kafe, adisyon ve kasa yazılımlarını tanımlar. Örneğin bir restoran otomasyonu ödeme başlatıyorsa satış uygulaması, bu otomasyonun resmî adı ve o isteği başlatan sürümüdür.

Kod hazır, yayın bekliyor. Aşağıdaki alanlar hazırlanmış OS-02 sözleşmesidir. Bu sayfa özelliğin prod'da açıldığını söylemez; dağıtım duyurusu olmadan mevcut ödeme isteklerinize bu alanları eklemeyin. Fatura/alıcı/mali belge alanlarının ayrı durumu: Satış verisi ve destek durumu.

Hangi yazılımın adı ve sürümü?

Ödemeyi başlatanKaynak uygulamaSürümün kaynağı
Restoran/kafe yazılımınız, Lunixi API'si üzerindenKayıtlı restoran/kafe yazılımınızO yazılımın isteği başlatan sürümü
Lunixi Android uygulamasının kendi kasa ekranı, kasiyer PIN'iyleBu yerel satış akışı için seçilen kayıtÇalışan Android uygulamasının build sürümü
Android ajanı yalnız API isteğini POS'a taşıyorÖzgün API istemcisiÖzgün istemcinin sürümü; köprünün sürümüyle değiştirilmez

Android ajanının, Pavo/Castles/PlusPay SDK'sının veya mali uygulamanın (GMU) sürümü ayrı yürütme bilgisidir. Bunlar API ile bağlanan restoran yazılımının adının/sürümünün yerine geçmez. Özgün kaynak bilgisinin her üretici SDK'sına aktarılması ve ek yürütme kanıtları bu pakette tamamlanmış değildir.

Paneldeki kayıt

Mevcut panel formu korunur: Fiziksel POS → Satış Uygulamaları. Merchant'ın physical_pos:manage yetkili panel kullanıcısı yazılımın resmî adını kaydeder; okuma physical_pos:view ister.

  • Her kayıt sabit bir UUID ve resmî ad taşır. UUID bir API anahtarı veya kimlik doğrulama sırrı değildir.
  • Kayıt merchant kapsamındadır; başka merchant'ın kaydı kullanılamaz.
  • En fazla 32 kayıt vardır. Kullanımı durdurmak için pasifleştirilir; kimlik silinmez/yeniden kullanılmaz.
  • Formda sürüm belirlenmez. Sürüm, ödemeyi başlatan yazılımın talebinden gelir.
  • Yeni işlemlerde kayıtlı kaynak bilgisi zorunlu yapılabilir. Bu zorunluluğu kaldırmak ek physical_pos:identity yetkisi gerektirir.

Bu form, entegratörün bütün merchant'larını yönettiği merkezi bir partner/yayıncı portalının tamamlandığı anlamına gelmez.

Ödeme isteğine eklenen bilgi

Yayın bekleyen ek alan örneği: aşağıdaki parça mevcut zorunlu ödeme alanlarına eklenir; tek başına ödeme isteği değildir.

{
  "sourceApplication": {
    "applicationId": "a1234567-1234-4234-8234-123456789abc",
    "version": "4.2.1+20261106"
  }
}

Burada version, örnekteki restoran otomasyonunun sürümüdür. Resmî ad istekte serbestçe gönderilmez; sunucu adı aynı merchant'ın etkin kaydından çözer. Normal merchant API kimlik doğrulaması ve ödeme yetkisi ayrıca gerekir.

Sürüm 1–64 ASCII karakterdir; ilk karakter harf/rakam, devamı harf/rakam/./_/+/- olabilir. Semver zorunlu değildir. Kart verisi, PIN, token ve kişisel veri bu alana konmaz. Sürüm bilgisi beyandır; çalıştırılan yazılımın uzaktan doğrulandığı veya mevzuat uygunluğu onaylandığı anlamına gelmez.

Geçmiş işlem ve tekrar güvenliği

Ödeme kabul edilirken kayıt kimliği, kayıtlı ad, istemcinin beyan ettiği sürüm ve kayıt revizyonu değişmez olarak saklanır. Kayıt adı sonradan değişse de geçmiş ödeme değişmez. Aynı istek anahtarıyla farklı sürüm gönderilmesi idempotency uyuşmazlığıdır; belirsiz sonucu yeni anahtarla yeniden çekmeyin.

Eski ödemelere bugünkü kayıt üzerinden ad/sürüm eklenmez. Cihazda işlem sonucunun belirsiz kalması yalnız sonuç sorgusu gerektirir; otomatik yeni ödeme veya kanal değişimi doğurmaz.

Yeni mali talepte kayıt snapshot'ı cihaz içeriği v2'ye de bağlanır; Android köprü asıl yazılım adını kendi adı/sürümüyle değiştirmez. Bu, mali veri desteği ve yeni okuyucu gerektirir. Gerçek üretici SDK'sına teslim ve ajan/SDK/GMU çalışma kanıtı ayrıca kabul edilir; yalın kaynaksız eski işlemlere bugünkü kimlik eklenmez.

Entegrasyon işlem kimliği: seri, fingerprint, sıra ve zaman

Kaynakta hazır, prod yayını ve uygun Android sürümüyle kullanılacak ek: sourceApplication.integrationHandle, restoran/kafe/ERP yazılımının işlem kökenini üreticiden bağımsız taşır. Pavo'ya özel serbest bir SDK JSON alanı değildir. Aşağıdaki parça normal ödeme veya ters işlem isteğine eklenir:

{
  "sourceApplication": {
    "applicationId": "a1234567-1234-4234-8234-123456789abc",
    "version": "4.2.1",
    "integrationHandle": {
      "serialNumber": "TEST-SN",
      "fingerprint": "checkout-a",
      "transactionSequence": "9007199254740993",
      "transactionDate": "2026-11-08T00:00:00.000Z"
    }
  }
}
AlanKural
serialNumberKendi merchant'ınızda çözülen hedefin kayıtlı üretici seri/cihaz kimliğiyle birebir aynı; 1–128 boşluksuz yazdırılabilir ASCII. Hedef seçiminin yerine geçmez.
fingerprintYazılım örneğinin sabit, sır olmayan kimliği; 1–256 harf/rakam/./_/:/-. Biyometrik parmak izi veya kart verisi değildir.
transactionSequence1…9223372036854775807 kanonik ondalık metin. JSON number, baştaki sıfır, kesir ve üs kabul edilmez. Beyan edilen korelasyon sırası; merkezi monoton sayaç güvencesi değildir.
transactionDateİlk iş isteğinin gerçek UTC zamanı; tam YYYY-MM-DDTHH:mm:ss.SSSZ. Ağ tekrarında değiştirilmez. API imzasının taze zamanı değildir.

Tam nesne birlikte gönderilir; bilinmeyen alanlar ve null reddedilir. API anahtarı, şifre, token, PIN veya kişisel/kart verisi konmaz. Kimlik doğrulaması ve Idempotency-Key kuralları devam eder. Aynı anahtarla handle değiştirmek uyuşmazlıktır. Sıra tek başına tekrar engeli değildir; aynı sırayla yeni anahtar vermek yeni ödeme isteğidir. Belirsiz ödeme daima özgün anahtar/ödeme üzerinden sorgulanır.

Bilgiler kayıtlı uygulama snapshot'ında değişmez saklanır ve kendi merchant'ınızın yetkili ödeme görünümünde döner. MQTT üzerinden yürütülen, gerekli mali içerik protokolünü destekleyen SALE'de mali talep olmasa da şifreli, imzalı komutun özetine bağlı cihaz içeriği v3 taşır; mali belge yaratılmaz. Ters işlemin HTTP/sunucu snapshot'ı bilgiyi korur; komut v6'nın SALE kapsamı genişlemediği için ters işleme yeni cihaz bağlamı dağıtımı bu ekin parçası değildir. Pavo REST eşleştirme fingerprint'i ve kalıcı ortak sayacı adaptörün ayrı oturumudur; gelen merchant bilgileri oraya otomatik kopyalanmaz.

Önce tüm sunucu okuyucuları ve ilgili Android okuyucusu güncellenmeli, sonra bu alan gönderilmelidir. Eski uygulamalar handle'sız mevcut sözleşmeyle devam eder.