iKasa Move/5000 F Entegrasyon Altyapısı ve Web Entegrasyonu

Cihaz ve Teknik Altyapı

iKasa Move/5000 F, Worldline (Ingenico) tarafından sunulan yeni nesil YazarkasaPOS cihazıdır. Bu cihaz Gelir İdaresi Başkanlığı (GİB) onaylı olup EMV L1/L2 ve PCI PTS 5.x gibi uluslararası güvenlik sertifikalarına sahiptir. Entegrasyon altyapısının kalbinde, Türkiye'ye özgü güvenli haberleşme protokolü GMP3 (Güvenli Mobil Protokol 3) bulunur. GMP3, yazarkasaPOS ile harici sistemlerin (ör. restoran otomasyonu, eczane programı, web uygulaması vb.) güvenli iletişimini sağlar ve TÜBİTAK onaylı ilk çözümdür. Bu protokol sayesinde Move/5000 F, PC veya bulut tabanlı uygulamalarla şifreli ve güvenli veri alışverişi yapabilir.

Cihaz, Ethernet, 4G/2G (GPRS) veya WiFi üzerinden iletişim kurabilir. TSM (Masada Ödeme) desteği de mevcuttur; bu, restoran gibi ortamlarda müşterinin masasında ödeme alma senaryolarını destekler. Teknik olarak cihaz, Telium Tetra işletim sistemi ile çalışır (Ingenico Move serisinin platformu) ve harici sistemlerle iletişimde GMP3 protokolünü kullanır.

GMP3 protokolü entegrasyon için temel olsa da geliştiriciler doğrudan bu düşük seviyeli protokolle uğraşmazlar. Worldline (iKasa) genellikle kendi SDK veya servis uygulamalarıyla GMP3’ü soyutlayarak entegrasyon yapmanızı kolaylaştırır. Örneğin, iKasa ile entegre çalışan birçok yazılım, cihazla haberleşmek için iKasa’nın sağladığı servis uygulamasını veya API arayüzlerini kullanır. Bu sayede geliştirici, satış ve ödeme komutlarını gönderdiğinde GMP3 protokol detayları arka planda halledilir.

Güvenlik ve yasal uyumluluk cihazın altyapısının önemli bir parçasıdır. Tüm işlemler GİB’in belirlediği şekilde kayıt altına alınır ve elektronik/mekanik mühür ile korunur. Bu da entegrasyon yapan yazılımların, cihaz üzerinden fiş keserken mali kurallara uygun hareket etmesini sağlar.

Web Sitesi ile Entegrasyon Yöntemleri

Bir web sitesi üzerinden ödeme başlatıp Move/5000 F cihazında ödeme ekranını açmak ve fiş yazdırmak için bir entegrasyon katmanı kullanmak gerekir. İki temel yaklaşım vardır:

• Lokal (Kablolu) Entegrasyon: Cihaz ile aynı ağda veya aynı bilgisayarda çalışan bir ara yazılım üzerinden iletişim kurulur. Bu yöntemde Move/5000 F, TCP soket veya seri (USB-COM) bağlantı ile PC’ye bağlanır. Yazılımınız, cihazın IP’sine ve belirli bir porta (Ingenico cihazlarında genelde port 7500 veya yapılandırmaya göre 8150) komutlar göndererek işlemi başlatır​x-series-support.lightspeedhq.com . Örneğin Webticari ve DİA gibi ticari programlar, cihazı Ethernet üzerinden IP=cihaz_IP, Port=7500 olacak şekilde ayarlayıp doğrudan satış verisini cihazın fiskal modülüne iletebilmektedir​diateknoloji.com . Bu sayede web tabanlı bir arayüzde “Ödeme Al” butonuna basıldığında, arka plandaki entegrasyon servisi cihaza tutar ve sepet bilgilerini gönderir; cihaz da ödeme ekranını açar ve işlem sonucunda fişi otomatik yazdırır. Bu tam entegrasyon (full entegre) senaryosudur; tüm kontrol merkezi yazılımdadır ve cihaz bir periferik gibi davranır. Örneğin, DİA Yazılım hızlı satış ekranında ödeme seçildiğinde pos cihazına fiş otomatik gönderilip yazdırılmaktadır​diateknoloji.com . Benzer şekilde, ElektraPOS restoran sistemi de Ingenico yazarkasaya tüm ödeme tipleriyle tam entegre çalışarak adisyonu otomatik fiş haline getirebilmektedir.
• Bulut Tabanlı (Kablosuz) Entegrasyon: Cihazın, iKasa/Worldline altyapısındaki bir cloud (bulut) sunucu ile haberleşmesi sağlanır. Bu modelde, web siteniz veya sunucunuz bir Cloud API çağrısıyla iKasa’nın sistemine satış/ödeme bilgisini iletir; Move/5000 F cihazı ise kendi internet bağlantısı üzerinden bu bilgiyi alır. iKasa’nın “Kablosuz GMP3” adını verdiği çözüm buna örnektir. Bu yöntemde web siteniz, cihazda doğrudan fiş basmaz; bunun yerine satış verisini buluta sipariş olarak düşer. Cihaz üzerindeki özel bir uygulama (örneğin restoran uygulaması) bu bekleyen işlemi operatörün onayıyla fişe dönüştürür. Ödeme tetikleme (trigger) bulutta başlatıldığı için, cihazda genellikle kullanıcı “Açık Çekler” menüsünden ilgili işlemi seçip ödeme adımına geçer. Bu yaklaşım bir tür yarı entegrasyon (semi-entegre) olarak düşünülebilir: İşlemin son onayı cihaz üzerinde yapılır. Önemli bir not, BenimPOS’un açıklamasına göre kablosuz (bulut) entegrasyonda satışlar doğrudan cihaza otomatik olarak gönderilemez, kullanıcı cihazdan işlemi çağırır; tamamen otomatik olması isteniyorsa kablolu entegrasyon gerekir.

Hangi yaklaşımı kullanırsanız kullanın, arka planda GMP3 protokolü çalışır. Kablolu entegrasyonda GMP3 mesajları lokal ağ üzerinden cihazla direkt alışveriş yaparken, bulut tabanlı modelde GMP3 mesajları Worldline’ın sunucuları aracılığıyla iletilir. İkisi de güvenlidir ve GİB standartlarına uygundur; tercih, işletmenin ihtiyaçlarına ve altyapısına göre yapılır.

Webhook mekanizmaları da bazı entegrasyonlarda kullanılır: Örneğin, bulut tetiklemeli entegrasyonda cihaz bir işlemi tamamladığında sizin sunucunuza bir webhook (geri çağırma) göndererek “işlem tamamlandı/fiş kesildi” bilgisini iletebilir. Bu sayede web siteniz ödeme sonucunu otomatik öğrenebilir. iKasa’nın kendi dokümanlarında webhook kavramı açıkça belirtilmese de, entegratör firmalar (örn. BenimPOS) kendi panellerinde bu tür bildirimler sunabilir.

Entegrasyon İçin Gerekli Belgeler ve API Erişimi

iKasa (Worldline) cihazlarıyla entegrasyon yapabilmek için öncelikle Yetkili Entegratör olmanız veya bir entegratör çözümü kullanmanız gerekiyor. Move/5000 F gibi ÖKC (Ödeme Kaydedici Cihaz)’lerde, GİB kuralları gereği entegrasyon kullanımı yıllık lisans/ücret gerektirir. İzin ve dokümantasyon süreci şöyle ilerler:

• iKasa Online İşlemler Kaydı: Cihaz sahibi, iKasa’nın online portalına (online.ikasa.com.tr) yazarkasa sicil no ile kayıt olur​webticari.net . Portalda “Sanal Market > Katma Değerli Servis” bölümünde, entegrasyon hizmeti seçilerek ödeme yapılır. Örneğin Webticari entegrasyonu kullanacak biri, listeden Webticari entegratörünü seçip yıllık GMP3 entegrasyon ücretini öder. Entegratör adı listede yoksa not bölümüne yazılabilir. Bu ödeme, Worldline/iKasa tarafında cihazınızın entegrasyona açılması için gereklidir.
• Dokümantasyon ve SDK: Ödeme tamamlandıktan sonra, iKasa cihazınıza ilgili entegrasyon yetkisini uzaktan tanımlar (genellikle 24 saat içinde kablosuz entegrasyon aktif edilir). Ayrıca entegrasyon için teknik dokümanlar ve gerekli yazılımlar sağlanır. İKasa, geliştiricilere özel bir SDK veya protokol kılavuzu sunar. Bu dokümanlarda cihazla nasıl haberleşileceği, gönderilecek komut yapıları, fiş formatları vb. ayrıntılı şekilde yer alır. Örneğin, Ingenico’nun Türkiye distribütörü üzerinden GMP3 mesaj yapıları ve örnek kodlar alınabilir (GİB’in resmi GMP3 protokol PDF’i de referans olabilir). Akinsoft gibi iş ortakları, iKasa entegrasyonu için kendi servis uygulamalarını geliştirmiş ve bunun için iKasa’dan destek almıştır. Sizin de entegrasyon için iKasa teknik ekibinden “Harici Sistemlerle Haberleşme GMP3 dokümanları”nı talep etmeniz gerekir. İKasa’nın Teknik Destek kanalı bu konuda yönlendirme yapacaktır.
• API Erişimi ve Test: Worldline, güvenlik nedeniyle doğrudan internet üzerinden açık bir API sunmaz; entegrasyon genelde cihazla lokal iletişime veya cihazın Worldline altyapısıyla konuşmasına dayanır. Bu nedenle “API erişimi” kavramı, ya cihazla lokalde konuşan bir API (örneğin bir DLL, .NET/Python kütüphanesi) ya da cloud entegrasyonu için size verilen web servis uç noktaları anlamına gelebilir. Entegrasyon yetkisi aldıktan sonra size test ortamı ve gerekirse bir demo terminal sağlanabilir. Test modunda sahte fişler keserek uygulamanızı doğrulayabilirsiniz. İKasa, entegratörlerin geliştirme yapabilmesi için genellikle doküman + destek mühendisliği sunuyor. Örneğin, Akinsoft Bilgi Bankası’nda, Ingenico yazarkasa entegrasyonu için “Ingenico Servis Uygulaması” kurulumu ve parametre ayarlarına dair bilgiler bulunmaktadır​bilgibankasi.akinsoft.net – bu bilgiler iKasa’nın sağladığı servis yazılımı üzerinden API benzeri bir etkileşimi anlatır.

Özetle, entegrasyon belgelerine ve API’lere ulaşmak için önce iKasa’dan resmi entegrasyon izni ve hizmetini satın almanız, ardından iKasa’nın teknik ekiplerinden veya entegrasyon ortaklarından gerekli dokümanları edinmeniz gerekiyor. İzinsiz olarak cihaza dışarıdan komut göndermek mümkün değildir; GİB regülasyonları gereği her entegrasyon kayıt altına alınır ve ücretlendirilir.

iKasa’nın Sunduğu Entegrasyon Türleri

iKasa/Worldline, farklı ihtiyaçlara göre çeşitli entegrasyon yöntemleri sunar:

• Full Entegre (Tam Entegrasyon): Harici yazılım (ör. restoran programı, e-ticaret sitesi altyapısı) satış ve ödeme işlemlerini tamamen kontrol eder. Cihaza ürün bilgileri, tutar, ödeme tipi gibi veriler yazılım tarafından anlık gönderilir ve cihaz otomatik olarak fişi basar. Bu modelde kasa personeli sadece yazılım arayüzünü kullanır, cihaz fişi arka planda üretir. Full entegrasyonda, cihaz bir yazıcı/POS terminali gibi arka planda çalışır ve bütün işlem akışı harici uygulamadan yönetilir. Örneğin, Nebim, DİA, Akinsoft WOLVOX gibi yaygın ticari yazılımlar Move/5000 F ile tam entegre çalışır; satış esnasında ikinci bir cihaza işlem girmeye gerek kalmaz, veriler otomatik aktarılır​diateknoloji.com . Bu tür entegrasyonda genellikle kablolu bağlantı (USB veya Ethernet) kullanılır ve hızla fiş kesilebilir.
• Semi-Entegre (Yarı Entegrasyon): Bu modelde işlemin bir kısmı yazılımda, bir kısmı cihazda gerçekleştirilir. Genelde ödeme tutarı yazılım tarafından cihaza iletilir, ancak cihaz üzerinde ödeme onayı veya fişleme kullanıcının etkileşimiyle yapılır. Bir örnek, kredi kartı ödeme entegrasyonlarında görülür: Yazılım tutarı cihaza gönderir, cihaz müşteriden kart işlemini alır ve sonuç bilgisini yazılıma döndürür. Ingenico Move/5000’in “Semi-Integrated” modu, özellikle yurt dışında bu amaçla kullanılır; cihazı belirli bir porta dinlemede bırakıp POS yazılımının tetiklemesine olanak tanır​x-series-support.lightspeedhq.com ​x-series-support.lightspeedhq.com . Türkiye özelinde semi-entegrasyon kavramı, kablosuz entegrasyon senaryolarına da benzetilebilir: Örneğin iKasa’nın Restoran Entegrasyonu çözümünde garson POS üzerinden adisyonu kapat dediğinde, Move/5000 F üzerindeki restoran uygulaması otomatik açılır ve onayla birlikte fiş kesilir. Yani işlem iki tarafta koordineli yapılır. Semi-entegre modelde hata toleransı yüksektir; eğer harici yazılım çalışmazsa cihaz tek başına da fiş kesebilir, böylece operasyon aksamaz.
• Bulut Tabanlı Tetikleme: iKasa’nın yakın zamanda sağladığı bir entegrasyon türüdür. Fiziksel bağlantı olmaksızın, uzaktan satış tetiklemesi yapılmasını sağlar. Özellikle online sipariş ile mağazada ödeme alma veya merkezi yönetim senaryolarında kullanılır. Bu modelde cihaz, Worldline’ın bulutuna bağlıdır ve merkezi sistemden gelen komutları alabilir. Örneğin, bir e-ticaret sitesinde müşteri ödeme adımına geldiğinde “mağazada öde” seçeneğine tıklarsa, ilgili mağazadaki Move/5000 F anlık bir bildirim alabilir. BenimPOS adlı bulut tabanlı POS yazılımı, Ingenico cihazlar için bu tetikleme modelini kullanmaktadır: İşlemler buluta “açık satış” olarak düşer, cihaz üzerindeki Kablosuz Entegrasyon uygulaması ile fişe dönüştürülür. Bu yöntem kablo gerektirmez, GPRS/4G üzerinden çalışır. Avantajı, saha ekiplerinin mobil cihazları internet olan her yerden kullanabilmesidir. Dezavantajı ise, tamamen gerçek zamanlı olmamasıdır (kullanıcının cihazdan işlemi seçmesini gerektirir). İleride Worldline’ın doğrudan cihazı tetikleyen API’ler sunması beklenebilir, ancak şu anki mimaride bu yarı-manuel adım güvenlik için tasarlanmıştır.

Bu entegrasyon türleri dışında iKasa’nın özel sektör çözümleri de bulunur. Örneğin Mobil Ödeme uygulamaları (cihazdan karekodla ödeme alma), Sadakat Uygulamaları, Eczane Entegrasyonu gibi dikey çözümler iKasa platformuna entegre edilebilir. Ancak bunlar genelde iKasa’nın anlaşmalı olduğu üçüncü parti servislerin (Yemek çeki, SGK provizyon vs.) cihaz üzerinde çalıştırılmasıyla ilgilidir.

Türkiye’den Canlı Entegrasyon Örnekleri

Türkiye’de birçok firma iKasa (Ingenico) Move/5000 F ve benzeri yeni nesil yazarkasalarla entegrasyon yapmıştır. Örnek uygulamalar ve canlı entegrasyonlar:

• Büyük Perakende Markaları: iKasa’nın GMP3 entegrasyon referansları arasında Zara, KFC, Papa John’s, Schafer, Oysho, Bershka, Pull&Bear gibi markalar bulunmaktadır​ikasa.com.tr . Bu firmalar kendi ERP veya POS sistemlerini Move/5000 F cihazlarıyla bütünleştirerek tüm satış noktalarında entegre ödeme alabilmektedir. Örneğin Zara mağazalarında kasiyer, satış bilgilerini kasadan girip tek tuşla Ingenico yazarkasadan fiş yazdırabiliyor; ayrı bir işlem yapmasına gerek kalmıyor. Bu seviyede entegrasyon genelde full entegredir ve markaların IT ekipleri Worldline ile çalışarak sisteme özel geliştirmeler yapmıştır.
• Yazılım Firmaları ve ERP’ler: Özellikle restoran, market ve perakende yazılımı üreten birçok firma Ingenico iKasa cihazlarıyla entegre çözümler sunuyor. AKINSOFT Wolvox (restoran ve hızlı satış programı) Ingenico Move/5000 F ile tam entegre çalışmakta ve saha satış, paket servis uygulamalarında cihaz üzerinden ödeme almaktadır. Bu entegrasyon için AKINSOFT, iKasa’dan aldığı SDK ile Ingenico Servis Uygulaması geliştirmiş, kullanıcılarından GMP3 hizmet bedelini iKasa portalı üzerinden ödeterek entegrasyonu aktifleştirmektedir. DİA Yazılım da Ingenico yazarkasalarla entegre olup USB veya IP üzerinden fiş kesebilmektedir – kendi bilgi bankalarında sürücü kurulumundan IP ayarlarına dek kılavuz yayınlamışlardır​diateknoloji.com ​diateknoloji.com . Diğer entegre firmalara örnek olarak Nebim (Winner), Logo ve Micro gibi ERP üreticileri, Elektra (otel/restoran otomasyonu), Webticari (perakende otomasyon), BenimPOS (bulut tabanlı satış sistemi), Eçözüm ve İntegra gibi firmalar sayılabilir. Bu firmaların entegrasyonları sayesinde farklı sektörlerde Ingenico cihazlar aktif olarak kullanılmaktadır.
• Küçük/Orta Ölçekli Uygulamalar: Tek bir mağaza için özel geliştirme yapan yazılım geliştiriciler de iKasa entegrasyonundan faydalanıyor. Örneğin, bazı e-ticaret siteleri fiziksel mağaza entegrasyonu için iKasa cihazlarını kullanıyor. Propay gibi ödeme şirketleri, veya Arniva gibi entegre satış noktası çözümleri de Ingenico uyumlu sistemler geliştirmiştir (örn. Arniva POS, Ingenico ile entegre fiş kesebildiğini sosyal medyada duyurmuştur). Yine Eczane otomasyonları (RxMedia gibi) Ingenico yazarkasalar ile doğrudan reçete ve ilaç satış fişi entegrasyonu sunmaktadır.

Bu örneklerin başarısı, iKasa’nın sunduğu entegrasyon altyapısının esnek ve güvenilir oluşundan kaynaklanıyor. Son kullanıcı açısından entegrasyonlu bir Ingenico Move/5000 F kullanımı oldukça kolay: Satış bilgilerinin tekrar cihaza girilmesine gerek kalmıyor, hatalar azalıyor ve hızlı bir ödeme deneyimi sağlanıyor.

Sonuç ve Özet

İKasa Move/5000 F cihazları, GMP3 tabanlı güvenli entegrasyon altyapısıyla harici yazılım ve web sistemlerine bağlanabiliyor. Web sitenizden bir ödeme başlatmak için cihazla ya doğrudan lokal ağ üzerinden (full entegre) ya da iKasa’nın bulut servisleri üzerinden (bulut tetiklemeli) haberleşebilirsiniz. Entegrasyon süreci için iKasa’dan yetki ve doküman alarak, gerekirse yıllık entegrasyon lisans ücretini ödeyip, SDK veya API’larını kullanmanız gerekir. İKasa, semi-entegre ve tam entegre çözümleriyle farklı işletme ihtiyaçlarına cevap verirken, Türkiye’de pek çok kurumsal ve KOBİ ölçekli firma tarafından canlı olarak kullanılmaktadır. Bu bütünleşik yapının doğruluğu, verilen referanslar ve saha örnekleriyle de kanıtlanmıştır.

Kaynaklar:

• Worldline (iKasa) – GMP3 Entegrasyonu Tanıtımı
• AKINSOFT – Ingenico YazarkasaPOS Entegrasyonu Bilgileri
• Webticari – Ingenico Yazarkasa Kurulum ve Entegrasyon Adımları​webticari.net
• BenimPOS – Ingenico Kablosuz GMP3 Entegrasyonu Açıklamaları
• ElektraPOS Haber – Ingenico Yazarkasa ile Tam Entegrasyon Duyurusu
• DİA Yazılım – Ingenico Entegrasyonu Kullanım Notları​diateknoloji.com ​diateknoloji.com