— Özel Proje Entegrasyonu
Kiosk ve Makinelere Özel Ödeme Entegrasyonu
Cihazınız hazır çözümlerimizin hiçbirine benzemiyor olabilir. Vennex açık bir ödeme altyapısıdır: kiosk, makine, kapalı devre sistem veya kendi yazılımınız için özel ödeme entegrasyonu yaparız. Ödeme akışını sizin senaryonuza göre tasarlar, cihaza bağlar ve tek panelden yönetilir hale getiririz.
- MDB, pulse, seri port ve API ile bağlantı
- Kart, QR, yemek kartı ve kapalı devre bakiye tek akışta
- Satış verisi ERP ve muhasebe sistemlerinize aktarılır
Cihazınız

Vennex terminali
Kart, temassız, QR






Vennex
Ödeme akışı, kurallar ve cihaz yönetimi
Sizin sistemleriniz
— Önce Tanım
Ödeme Entegrasyonu Nedir? Sanal POS ile Cihaz Entegrasyonu Aynı Şey Değil
Ödeme entegrasyonu, bir ürünün veya hizmetin satıldığı noktaya kartla, QR ile ya da bakiyeyle ödeme alma yeteneğinin eklenmesidir. İki ayrı dünya vardır: web sitesine ödeme eklemek (sanal POS) ve fiziksel bir cihaza ödeme eklemek. Vennex ikincisini yapar: kiosk, otomat, dolap, bariyer veya kendi ürettiğiniz makine gibi başında kasiyer olmayan cihazlarda ödemeyi alır ve cihazın işini yapmasını tetikler. Kiosk ödeme sistemleri, otomatik ödeme sistemleri, ödeme otomasyonu ya da cihaza POS entegrasyonu diye aranan şey de budur: kartlı ödeme sisteminin bir makineye bağlanması.
Sanal POS
- Web sitesi
- Ödeme sayfası
- Sipariş kaydı
Ürün günler içinde kargoyla gelir
Cihaz entegrasyonu
- Cihaz ekranı
- Terminale kart okutulur
- Ödeme onayı
Cihaz saniyeler içinde çalışır
Web sitenize ödeme eklemek istiyorsanız aradığınız şey sanal POS'tur. Bir cihazın, makinenin veya kioskun ödeme alması gerekiyorsa doğru yerdesiniz.
— Hangi Projeler
Hazır Listede Olmayan Her Cihaz İçin
Otomat, araç yıkama, turnike, eğlence cihazları ve şarj istasyonları için hazır çözümlerimiz var. Bunların dışındaki projelerde ödeme akışını sizin işleyişinize göre kuruyoruz. Örnek senaryolar:
Kiosk ve self servis sipariş
Sipariş, bilet veya hizmet kiosklarında kartlı ve temassız ödeme; tutar kiosk yazılımınızdan gelir.
Kapalı devre kampüs ve fabrika
Personel kartı, kota ve periyodik bakiye yükleme ile yemekhane, otomat ve hizmet noktalarında nakitsiz ödeme.
Akıllı dolap ve teslim noktaları
Kiralık dolap, emanet ve ürün teslim dolaplarında süre veya kullanım başına ödeme.
Çamaşırhane, su ve hava istasyonları
Jetonla çalışan makinelerde pulse çıkışıyla kartlı ödeme; jeton toplama ve sayma işi ortadan kalkar.
Otopark ve bariyer sistemleri
Süre bazlı ücretlendirmede ödemenin bariyer veya kontrol yazılımıyla birlikte çalışması.
Kendi ürettiğiniz makine
Makine üreticileri için kontrol kartınızla seri port üzerinden konuşan, ürününüze eklenen ödeme modülü.
— Bağlantı
Cihazınıza Dört Yoldan Bağlanırız
Doğru bağlantı tipi, cihazın elektroniğine ve yazılımına göre keşifte belirlenir. Çoğu projede mevcut makineyi değiştirmeniz gerekmez.
MDB protokolü
Otomat dünyasının standardı. MDB destekli makinelerde terminal makinenin ödeme birimi gibi çalışır; ürün seçimi ve tutar makineden gelir.
Pulse çıkışı
Jeton veya para okuyuculu makinelerde ödeme tamamlanınca makineye pulse gönderilir. Buton başına fiyat, pulse sayısı ve pulse süresi ayrı ayarlanır.
Seri port
Kendi kontrol kartı olan makinelerde terminal, makinenizle seri port üzerinden konuşur. Bağlantı hızı ve zaman aşımları cihaza göre yapılandırılır.
Sunucu tarafı: API ve WebSocket
Ödeme kararı yazılımınızda veriliyorsa terminal sunucumuza canlı bağlı çalışır; satış uzaktan onaylanabilir, ödeme sonucu anlık iletilir.
— Bağlantı Seçimi
MDB mi, Pulse mı, Seri Port mu, API mi?
Bağlantı tipini cihazın ne kadar 'konuşabildiği' belirler. Pulse en basit yoldur, API en esnek. Aynı projede ikisi birlikte de kullanılabilir: örneğin cihaz pulse ile çalışır, satış verisi API ile ERP'ye akar.
| MDB | Pulse | Seri port | API / WebSocket | |
|---|---|---|---|---|
| Uygun cihaz | MDB destekli otomatlar | Jetonlu veya paralı makineler | Kendi kontrol kartı olan makineler | Ekranlı kiosklar, yazılımla çalışan sistemler |
| Tutarı kim belirler? | Makine (ürün fiyatı) | Terminal (buton başına fiyat) | Makinenin kontrol kartı | Sizin yazılımınız |
| Sonuç cihaza nasıl iletilir? | MDB üzerinden satış onayı | Ödenen tutara karşılık pulse sayısı | Seri port mesajı | Anlık WebSocket mesajı |
| Çift yönlü iletişim | Var | Yok, tek yönlü sinyal | Var | Var |
| Ürün ve slot bilgisi | Var | Buton bazında | Protokole bağlı | Var |
| Tipik örnek | Kahve ve atıştırmalık otomatı | Araç yıkama, çamaşırhane, masaj koltuğu | Makine üreticisinin kendi cihazı | Akıllı dolap, sipariş kioskuna bağlı uygulama |
Bu bağlantılar hazır çözümlerimizde nasıl kullanılıyor?
Kararsız kalınan durumlarda keşifte cihazın elektroniği incelenir. Makinede MDB varsa çoğu zaman en zengin veri o yolla alınır; yoksa pulse ile hızlıca başlanır.
— Adım Adım
Kioska veya Makineye Kartlı Ödeme Nasıl Entegre Edilir?
Kiosk ödeme entegrasyonu da otomata ya da kendi makinenize kartlı ödeme eklemek de aynı altı adımdan geçer. Sahaya çıkmadan önce her şey yazılı ve test edilmiş olur.
- 1
Senaryoyu yazın
Ne satılıyor, tutar sabit mi değişken mi, hangi kartlar kabul edilecek, ödeme sonrası cihaz ne yapacak? Bu dört sorunun cevabı akışın tamamını belirler.
- 2
Bağlantı tipini seçin
Cihazın elektroniğine göre MDB, pulse, seri port veya API. Gerekirse ikisi birlikte: cihaz pulse ile çalışır, veri API ile akar.
- 3
Terminali seçin ve yerleştirin
İç mekanda kompakt PAX IM25, yüksek kullanımlı ya da dış mekan noktalarda PAVO UN20 veya PAX IM30. Montaj yeri, müşterinin kartı rahat okutacağı yükseklikte planlanır.
- 4
Akış kurallarını tanımlayın
Ön provizyon gerekiyor mu, iade nasıl olacak, cihaz hangi saatlerde satış yapacak, kapalı devre bakiye kullanılacak mı? Kurallar yönetim panelinde cihaz ayarı olarak tanımlanır.
- 5
Test modunda deneyin
Akış gerçek cihazda test modunda uçtan uca çalıştırılır: başarılı ödeme, reddedilen kart, zaman aşımı ve iade senaryoları tek tek denenir.
- 6
Yayına alın ve izleyin
Cihaz panele bağlanır; satışlar, cihazın çevrim içi durumu ve hatalar gerçek zamanlı izlenir. Fiyat ve ayar değişiklikleri sahaya gitmeden uzaktan yapılır.
Otomat özelinde aynı süreci adım adım anlatan rehber: Otomata kartlı ödeme nasıl eklenir?
— Ödeme Akışı
Akışı Sizin Kurallarınızla Kuruyoruz
Hazır çözümlerimizde kullandığımız yapı taşlarını projenize göre birleştiriyoruz. Bir projede tek kural yeter, bir diğerinde birkaçı birlikte çalışır.
Desteklenen ödeme yöntemleri
Mastercard, VISA ve Troy (temassız, çipli, manyetik), QR, İstanbulkart, Multinet, Metropol, Setcard, Ticket, Pluxee, TokenFlex, personel NFC kartı ve Vennex Wallet.
Tüm ödeme yöntemleri ve kart desteğiTutar nasıl belirlenir?
Sabit fiyat veya değişken tutar
Ürün başına sabit fiyat ya da tutarın cihazdan veya yazılımınızdan gelmesi.
Süre ve seans bazlı
Dakika, seans veya kullanım başına ücretlendirme.
Çoklu buton ve pulse
Aynı cihazda farklı hizmetler için ayrı fiyat ve ayrı pulse sayısı.
Ödeme nasıl alınır?
Ön provizyon
Önce blokaj, işlem bitince gerçek tutar. Şarj gibi tutarı baştan belli olmayan hizmetler için.
QR ile cüzdan ödemesi
Ekrandaki QR'ı müşteri Vennex Wallet ile okutur; sonuç cihaza anlık döner.
Kapalı devre bakiye
Personel kartı, ürün bazlı günlük/haftalık/aylık hak, dönemsel bakiye yükleme ve PIN ile harcama.
Kontrol sizde
Uzaktan onaylı satış
Satışın yazılımınızdan veya panelden uzaktan onaylanması; son kararı siz verirsiniz.
Çalışma saatleri, iade, ücretsiz mod
Belirli saatlerde satış, iade akışı ve test ya da kampanya için ücretsiz çalışma.
— Örnek Akışlar
Üç Projede Ödeme Akışı Adım Adım
Kim kime ne gönderiyor? Bir proje seçin; müşteri, terminal, cihaz ve Vennex arasındaki her adımı sırasıyla görün.
API ve WebSocket
1. Müşteri → Kiosk yazılımı
Dolap boyutu ve süre seçilir
2. Kiosk yazılımı → Terminal
Tutar terminale gönderilir
3. Müşteri → Terminal
Kart, telefon veya QR okutulur
4. Terminal → Vennex
Ödeme onaylanır
5. Vennex → Kiosk yazılımı
Sonuç anında yazılıma iletilir
6. Kiosk yazılımı
Dolap kapağı açılır
MDB ve kapalı devre bakiye
1. İnsan kaynakları → Vennex
Kart grupları ve günlük hak tanımlanır
2. Vennex
Hak her dönem otomatik yenilenir
3. Personel → Terminal
Yemekhanede kart okutulur
4. Terminal → Vennex
Hak veya bakiye kontrol edilir
5. Vennex → Terminal
Onay; haktan düşülür
6. Vennex → İnsan kaynakları
Kart bazında rapor Excel'e alınır
Günlük hak: 1/1
Bugünkü öğün kullanıldı; hak yarın yenilenir.
Seri port veya API
1. Müşteri → Terminal
Banka kartı okutulur
2. Terminal → Banka
Tahmini tutar bloke edilir
3. Terminal → Cihaz
Hizmet başlar
4. Cihaz → Terminal
Gerçek tüketim bildirilir
5. Terminal → Banka
Yalnızca gerçek tutar tahsil edilir
6. Banka → Müşteri
Kalan blokaj kaldırılır
Örnek: Blokaj 500 TL
Yemek ve ulaşım kartları ön provizyonu desteklemez; bu akışta banka kartları kullanılır.
Şarj istasyonunda ön provizyonlu ödeme nasıl alınır?— Sistemlerinizle
Veriniz Sizin Sistemlerinize Akar
Entegrasyon API'si
ERP veya SAP gibi sistemleriniz satışları size özel bir API anahtarıyla, cihaz bazında ya da tüm cihazlar için çeker. Ürün kodu ve KDV oranı satışla birlikte gelir.
Yönetim paneli ve mobil uygulama
Tüm cihazların gelir, işlem ve durum bilgisi gerçek zamanlı tek panelde; rol bazlı yetki ve çoklu kullanıcı.
Muhasebe ve raporlama
Satışlar cihaz, ürün ve ödeme yöntemi kırılımıyla Excel raporu olarak alınır; muhasebe sisteminize API veya dosya ile aktarılır.
Uzaktan yönetim
Cihaz ayarları, fiyatlar ve terminal yazılım güncellemeleri sahaya gitmeden uzaktan yapılır.
— Geliştiriciler İçin
Satış Verisini Kendi Sisteminize Çekin
ERP, SAP veya kendi raporlama sisteminiz, cihazlarınızın günlük satışlarını entegrasyon API'si ile alır. Size özel bir API anahtarı tanımlanır; anahtar yalnızca sizin cihazlarınızı görür.
- Tek bir cihazın ya da tüm cihazlarınızın satışları tek seferde alınır.
- Her satış ürün kodu ve KDV oranıyla gelir; net tutar ve KDV ayrıştırılmış olarak verilir.
- Erişim size özel, süreli ve istediğiniz an iptal edilebilen bir anahtarla yapılır.
- Teknik entegrasyon dokümanı, proje başlarken size özel olarak paylaşılır.
Örnek yanıt
{
"transactions": [
{
"transactionId": "48213977",
"machineTime": "2026-10-25T14:32:08.512",
"machineId": "PAV200000000",
"machineName": "Kampüs Kiosk 3",
"currency": "TRY",
"products": [
{
"material": "SKU-1042",
"quantity": "1",
"unitOfMeasure": "ST",
"taxRate": "10.00",
"netAmont": "40.91",
"taxAmount": "4.09",
"totalAmount": "45.00"
}
]
}
]
}— Teknik Altyapı
Altyapının Özeti
- Terminaller
- PAVO UN20, PAX IM30, PAX IM25 — gözetimsiz (unattended) kullanım için tasarlanmış, PCI PTS onaylı Android terminaller
- Kart kabulü
- Temassız (NFC), çipli ve manyetik kart; QR; BKM TechPOS altyapısı
- Cihaz bağlantısı
- MDB, pulse (buton başına fiyat, pulse sayısı ve süresi), seri port (cihaza göre hız ve zaman aşımı)
- Sunucu bağlantısı
- Terminal başına kimlik doğrulamalı WebSocket; uzaktan satış onayı ve anlık ödeme sonucu
- Uzaktan yönetim
- Toplu cihaz ayarı, fiyat yönetimi, terminal yazılım güncellemesi, uzaktan yeniden başlatma
- Panel güvenliği
- İki adımlı doğrulama, rol bazlı yetki, cihaz bazlı erişim kapsamı
- Veri aktarımı
- Entegrasyon API'si (anahtar ile, istek sınırlı), Excel raporları
— Sık Sorulanlar
Özel Entegrasyon Hakkında
01Kiosk ödeme sistemi nasıl çalışır?
Kiosk ödeme sistemi nasıl çalışır?
Müşteri kiosk ekranında ürünü veya hizmeti seçer, kiosk yazılımı tutarı ödeme terminaline gönderir. Müşteri kartını, telefonunu ya da QR kodunu okutur; ödeme onaylanınca sonuç anında kiosk yazılımına döner ve kiosk işlemi tamamlar: bileti basar, siparişi mutfağa iletir ya da dolabı açar. Kiosk ödeme entegrasyonu bu akışı kiosk yazılımınızla terminal arasında kurmaktır.
02POS entegrasyonu nedir, cihaza nasıl yapılır?
POS entegrasyonu nedir, cihaza nasıl yapılır?
POS entegrasyonu, ödeme terminalinin satış yapan sistemle konuşturulmasıdır. Kasiyerli mağazada bu sistem bir kasa yazılımıdır; kiosk ve makinelerde ise cihazın kendisidir. Vennex terminali cihaza MDB, pulse veya seri port ile, yazılıma ise API ve WebSocket ile bağlar; tutar cihazdan ya da yazılımdan gelir, ödeme sonucu cihaza geri döner.
03Ödeme entegrasyonu ile sanal POS aynı şey mi?
Ödeme entegrasyonu ile sanal POS aynı şey mi?
Hayır. Sanal POS, web sitesinde veya mobil uygulamada ödeme almak içindir. Cihaz entegrasyonunda ödeme cihazın üzerindeki terminalde alınır ve ödeme onaylanınca cihaz çalışır: ürün düşer, kapı açılır ya da hizmet başlar. Vennex cihaz tarafındaki entegrasyonu yapar.
04Kiosk için hangi ödeme terminali kullanılır?
Kiosk için hangi ödeme terminali kullanılır?
İç mekanda kompakt PAX IM25; yoğun kullanımlı veya dış mekan noktalarda PAVO UN20 ya da PAX IM30. Üçü de gözetimsiz kullanım için tasarlanmış, PCI PTS onaylı Android terminallerdir. Seçim, montaj yerine ve kullanım yoğunluğuna göre keşifte yapılır.
05Jetonlu makineme kartlı ödeme ekleyebilir miyim?
Jetonlu makineme kartlı ödeme ekleyebilir miyim?
Evet. Makineye kart okuyucu olarak bir ödeme terminali eklenir ve terminal makinenin jeton girişine pulse ile bağlanır; ödeme tamamlanınca makine jeton atılmış gibi çalışır. Buton başına fiyat, pulse sayısı ve pulse süresi ayrı ayarlanır; jeton toplama ve sayma işi ortadan kalkar.
06Kioskta yemek kartı kabul edilebilir mi?
Kioskta yemek kartı kabul edilebilir mi?
Evet. Banka kartlarının yanında Multinet, Metropol, Setcard, Ticket, Pluxee, TokenFlex ve İstanbulkart aynı terminalde kabul edilir. Tek istisna ön provizyonlu akışlardır: yemek ve ulaşım kartları blokajı desteklemediği için bu senaryoda banka kartları kullanılır.
07Entegrasyon için yazılım geliştirmemiz gerekir mi?
Entegrasyon için yazılım geliştirmemiz gerekir mi?
Bağlantı tipine bağlı. MDB ve pulse bağlantısında sizin tarafınızda yazılım gerekmez. Seri port bağlantısında makinenizin mesaj biçimi birlikte belirlenir. Ödeme kararını kendi yazılımınızın vermesini istiyorsanız yazılımınız sunucumuzla haberleşir; satış verisini almak için entegrasyon API'si kullanılır.
08Çözümler listesinde olmayan bir cihaza Vennex entegre edilebilir mi?
Çözümler listesinde olmayan bir cihaza Vennex entegre edilebilir mi?
Evet. Otomat, araç yıkama, turnike, eğlence ve şarj istasyonu hazır çözümlerimiz; altyapı bunlarla sınırlı değil. Cihazınız MDB, pulse veya seri port ile bağlanabiliyorsa ya da ödeme kararı bir yazılımda veriliyorsa, ödeme akışını projenize göre kurarız.
09Kendi yazılımımız var. Ödemeyi ona nasıl bağlarız?
Kendi yazılımımız var. Ödemeyi ona nasıl bağlarız?
Terminal sunucumuza canlı (WebSocket) bağlı çalışır. Yazılımınız tutarı belirler, satış uzaktan onaylanabilir ve ödeme sonucu anlık döner. Satış verilerini de entegrasyon API'si ile kendi sisteminize çekersiniz.
10Makinemi değiştirmem gerekir mi?
Makinemi değiştirmem gerekir mi?
Çoğu projede hayır. Terminal mevcut makineye eklenir; bağlantı tipi keşifte makinenin elektroniğine göre seçilir.
11Tutarı baştan belli olmayan hizmetlerde ödeme nasıl alınır?
Tutarı baştan belli olmayan hizmetlerde ödeme nasıl alınır?
Ön provizyonla: işlem başında karttan blokaj alınır, işlem bitince gerçek tutar tahsil edilir ve kalan blokaj kaldırılır. Süre veya seans bazlı ücretlendirme de kurulabilir.
12Satış verilerini ERP sistemimize aktarabilir miyiz?
Satış verilerini ERP sistemimize aktarabilir miyiz?
Evet. Entegrasyon API'si satışları cihaz bazında veya tüm cihazlar için ürün kodu, KDV oranı ve tutar ayrımıyla döndürür. Erişim size özel, süreli bir API anahtarıyla yapılır.
13Kapalı devre (personel kartı) ödeme kurulabilir mi?
Kapalı devre (personel kartı) ödeme kurulabilir mi?
Evet. Personel NFC kartları gruplara atanır; her grup için ürün bazlı günlük, haftalık veya aylık hak (örneğin günde bir öğün) ya da dönemsel bakiye yüklemesi tanımlanır. PIN ile harcama ve kart bazında raporlar aynı panelden yönetilir.
14Süreç nasıl başlıyor?
Süreç nasıl başlıyor?
İletişim formundan veya WhatsApp'tan projenizi kısaca anlatın: cihaz tipi, ödeme senaryosu ve tahmini adet. Ekibimiz keşif görüşmesi için size dönüş yapar.
— Terimler
Kısa Sözlük
- MDB
- Otomatlarda ödeme birimleri ile makine arasındaki standart iletişim protokolü. Çift yönlüdür: makine tutarı ister, ödeme birimi sonucu bildirir.
- Pulse
- Ödeme tamamlanınca makineye gönderilen elektrik sinyali. Jetonlu makinelerde jeton atılmış gibi davranır.
- Seri port
- Makinenin kontrol kartıyla terminal arasında veri alışverişi yapılan bağlantı. Mesaj biçimi makineye göre belirlenir.
- Ön provizyon
- Karttan önce tahmini bir tutarın bloke edilmesi, işlem bitince yalnızca gerçek tutarın tahsil edilmesi.
- Kapalı devre ödeme
- Yalnızca belirli bir kurum içinde geçerli bakiye ile ödeme: personel kartı, kampüs kartı, PIN ile harcama.
- Unattended POS
- Başında kasiyer olmadan çalışan ödeme terminali. Kiosk, otomat ve self servis cihazlarda kullanılır.
— Başlayın
Projenizi Anlatın, Akışı Birlikte Tasarlayalım
Cihaz tipi, ödeme senaryosu ve tahmini adet yeterli. Keşif görüşmesinde uygun bağlantıyı ve akışı birlikte belirleriz.
Projenizi AnlatınSon güncelleme:

