— Ö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

Kiosk
Otomat
Akıllı dolap
Bariyer, turnike
Kendi makineniz
MDBPulseSeri port
Vennex ödeme terminali (PAVO UN20)

Vennex terminali

Kart, temassız, QR

MastercardVISATroyMultinetMetropolİstanbulkart
4GWi-Fi

Vennex

Ödeme akışı, kurallar ve cihaz yönetimi

API ve WebSocket

Sizin sistemleriniz

Yönetim paneliGelir ve cihaz durumu
ERP ve muhasebeEntegrasyon API'si
Kendi yazılımınızUzaktan onay, anlık sonuç
Cihazınız terminale bağlanır, terminal Vennex'e. Ödeme kuralları Vennex'te çalışır; sonuç cihaza, veri sizin sistemlerinize gider.

— Ö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

  1. Web sitesi
  2. Ödeme sayfası
  3. Sipariş kaydı

Ürün günler içinde kargoyla gelir

Cihaz entegrasyonu

  1. Cihaz ekranı
  2. Terminale kart okutulur
  3. Ö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

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

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.

SERİ PORT

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.

API

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.

MDBPulseSeri portAPI / WebSocket
Uygun cihazMDB destekli otomatlarJetonlu veya paralı makinelerKendi kontrol kartı olan makinelerEkranlı 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şimVarYok, tek yönlü sinyalVarVar
Ürün ve slot bilgisiVarButon bazındaProtokole bağlıVar
Tipik örnekKahve ve atıştırmalık otomatıAraç yıkama, çamaşırhane, masaj koltuğuMakine üreticisinin kendi cihazıAkıllı dolap, sipariş kioskuna bağlı uygulama

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. 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. 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. 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. 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. 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. 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ği

Tutar 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. 1. Müşteri → Kiosk yazılımı

    Dolap boyutu ve süre seçilir

  2. 2. Kiosk yazılımı → Terminal

    Tutar terminale gönderilir

  3. 3. Müşteri → Terminal

    Kart, telefon veya QR okutulur

  4. 4. Terminal → Vennex

    Ödeme onaylanır

  5. 5. Vennex → Kiosk yazılımı

    Sonuç anında yazılıma iletilir

  6. 6. Kiosk yazılımı

    Dolap kapağı açılır

MDB ve kapalı devre bakiye

  1. 1. İnsan kaynakları → Vennex

    Kart grupları ve günlük hak tanımlanır

  2. 2. Vennex

    Hak her dönem otomatik yenilenir

  3. 3. Personel → Terminal

    Yemekhanede kart okutulur

  4. 4. Terminal → Vennex

    Hak veya bakiye kontrol edilir

  5. 5. Vennex → Terminal

    Onay; haktan düşülür

  6. 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. 1. Müşteri → Terminal

    Banka kartı okutulur

  2. 2. Terminal → Banka

    Tahmini tutar bloke edilir

  3. 3. Terminal → Cihaz

    Hizmet başlar

  4. 4. Cihaz → Terminal

    Gerçek tüketim bildirilir

  5. 5. Terminal → Banka

    Yalnızca gerçek tutar tahsil edilir

  6. 6. Banka → Müşteri

    Kalan blokaj kaldırılır

Örnek: Blokaj 500 TL

Tahsil edilen: 380 TLSerbest kalan: 120 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ı.

Vennex

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

PAVO UN20 gözetimsiz ödeme terminali, kiosk ve dış mekan cihazları için kartlı ödeme
PAVO UN20Yoğun kullanım ve dış mekan
PAX IM30 unattended POS terminali, kiosk ve makine ödeme entegrasyonu
PAX IM30Büyük ekran, dış mekan
PAX IM25 kompakt ödeme terminali, otomat ve iç mekan kiosk entegrasyonu
PAX IM25Kompakt, iç mekan
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

01

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.

02

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?

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.

04

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.

05

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.

06

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.

07

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?

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.

09

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.

10

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.

11

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.

12

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.

13

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.

14

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ın

Son güncelleme: