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şlatan | Kaynak uygulama | Sürümün kaynağı |
|---|---|---|
| Restoran/kafe yazılımınız, Lunixi API'si üzerinden | Kayıtlı restoran/kafe yazılımınız | O yazılımın isteği başlatan sürümü |
| Lunixi Android uygulamasının kendi kasa ekranı, kasiyer PIN'iyle | Bu 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:identityyetkisi 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"
}
}
}| Alan | Kural |
|---|---|
serialNumber | Kendi 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. |
fingerprint | Yazılım örneğinin sabit, sır olmayan kimliği; 1–256 harf/rakam/./_/:/-. Biyometrik parmak izi veya kart verisi değildir. |
transactionSequence | 1…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.