Kart Sağlayıcıları
Kart ödemelerini bağlı banka sanal POS’ları veya ödeme kuruluşları üzerinden alabilirsiniz. Sağlayıcıyı POS Merkezi → Keşfet ekranından seçin; hesabınıza ait bağlantı bilgilerini panelde girin.
| Sağlayıcı | Bağlantı türü |
|---|---|
| Akbank | Banka sanal POS |
| DenizBank | Banka sanal POS |
| Garanti BBVA | Banka sanal POS |
| Halkbank | Banka sanal POS |
| İş Bankası | Banka sanal POS |
| QNB Finansbank (NestPay) | Banka sanal POS |
| QNB Finansbank (PayFor) | Banka sanal POS |
| VakıfBank | Banka sanal POS |
| Yapı Kredi | Banka sanal POS |
| Ziraat Bankası (Payten) | Banka sanal POS |
| Ziraat Bankası (PayFlex) | Banka sanal POS |
| iyzico | Ödeme kuruluşu / PSP |
| Moka | Ödeme kuruluşu / PSP |
| Paycell | Ödeme kuruluşu / PSP |
| Paynkolay | Ödeme kuruluşu / PSP |
| PayTR | Ödeme kuruluşu / PSP |
| QNBpay | Ödeme kuruluşu / PSP |
| Rubik Para | Ödeme kuruluşu / PSP |
| TKPAY | Ödeme kuruluşu / PSP |
Hakediş ve işlem eşleştirme
POS Merkezi → Bağlantınız → Hakediş & Mutabakat bölümünde, destekleyen sağlayıcılarda Sağlayıcı yanıtı ödeme takvimini seçebilirsiniz. QNBpay bağlantılarında bu seçenek varsayılandır; daha önce kaydettiğiniz manuel takvim korunur. Mutabakat türü Sağlayıcı yanıtı (API) olduğunda Lunixi, kendi üzerinden geçen işlemleri sağlayıcının doğrulanmış yanıtıyla eşleştirir.
Sağlayıcının bildirdiği hakediş tarihi işlem satırında gösterilir. Tarih bildirilmemişse bekleniyor olarak kalır; otomatik bir T+1 tarihi atanmaz. Bu tarih ve başarılı işlem eşleşmesi, paranın banka hesabınıza yatırıldığına dair teyit değildir.
Kendi POS bağlantınızı kullanıyorsanız sağlayıcı tahsilatı sözleşmenize göre doğrudan sizin hesabınıza aktarır. Brüt tahsilat Lunixi tarafından size ödenecek platform bakiyesi olarak kaydedilmez.
QNBpay eşleştirmesi işlem bazındaki durum sorgusuna dayanır; QNBpay hesabınızdaki tüm hareketleri kapsayan bir hesap ekstresi veya banka transferi teyidi değildir.
QNBpay, App Key, App Secret ve Merchant Key ile bağlanır; hesabınızın izinlerine göre kart ödemesi, 3D Secure ve iade sunar, komisyon ve açık taksit bilgilerini bağlantı ekranında gösterir.
QNBpay sunucu bildirimlerini kullanmak için QNBpay işyeri panelindeki API ayarlarında aşağıdaki adresleri tanımlayın. Her adres için oluşturduğunuz anahtarı Lunixi bağlantısındaki QNBpay satış bildirim anahtarı veya QNBpay iade bildirim anahtarı alanına girin. Bu alanlar isteğe bağlıdır; App Key ve App Secret yerine geçmez.
| Bildirim | QNBpay paneline girilecek URL |
|---|---|
| Satış | https://api-gateway.lunixi.com/api/v1/provider-callbacks/qnbpay/sale |
| İade | https://api-gateway.lunixi.com/api/v1/provider-callbacks/qnbpay/refund |
QNBpay’den bu adreslere bildirim gönderimi için gereken firewall iznini de tanımlamasını isteyin. Bunlar QNBpay’in Lunixi’ye bildirim gönderdiği adreslerdir; müşterinin tarayıcı dönüş adresi ve sizin uygulamanıza gönderilen Lunixi webhook adresi ayrıdır.
İade isteğine gelen 101 yanıtı talebin işleme alındığını belirtir. Bildirim alınması tek başına iadenin tamamlandığı anlamına gelmez. Sağlayıcı tekil iade sonucunu doğrulayacak referans vermediğinde, satışın toplam iade tutarıyla otomatik eşleştirme yapılmaz; QNBpay’den işlem bazında sonuç teyidi gerekir.
Taksit ve işlem yetkileri sağlayıcıya ve işyeri sözleşmenize göre değişir. Ortak istek ve sonuç sözleşmesi için Kart Ödemeleri, Taksit & BIN ve İade sayfalarını kullanın.
PayTR
PayTR, Mağaza No, Mağaza Parolası ve Mağaza Gizli Anahtarı ile bağlanır. Bu bilgileri PayTR Mağaza Paneli’nde Destek & Kurulum → Entegrasyon Bilgileri sayfasında bulabilirsiniz. Kart bilgileri Lunixi ödeme formunda alınır; PayTR’ın kendi ödeme sayfası kullanılmaz.
Bağlantıyı kurmadan önce PayTR mağazanızda aşağıdaki yetkilerin açık olduğunu doğrulayın. Yetkileri PayTR’dan talep edebilirsiniz.
| PayTR yetkisi | Ne için gerekir |
|---|---|
| Direkt API | Kart ödemesi ve 3D Secure |
| Non3D | 3D Secure’suz kart ödemesi |
Non3D yetkisi yoksa yalnızca 3D Secure ile ödeme alabilirsiniz.
Bildirim adresi
PayTR ödeme sonucunu sunucudan sunucuya bildirir ve bildirimin alındığı onaylanmadan ödemeyi tamamlamaz. PayTR Mağaza Paneli’nde Ayarlar → Bildirim URL Ayarları bölümüne aşağıdaki adresi girin ve protokolü HTTPS olarak seçin.
| Bildirim | PayTR paneline girilecek URL |
|---|---|
| Ödeme sonucu | https://api-gateway.lunixi.com/api/v1/provider-callbacks/paytr/notification |
PayTR, mağaza başına tek bir bildirim adresi kabul eder. Aynı mağazayı başka bir sitede de kullanıyorsanız o sitenin bildirimleri de bu adrese gelir ve Lunixi tarafından işlenmez; Lunixi bağlantısı için ayrı bir PayTR mağazası kullanın.
Bu adres PayTR’ın Lunixi’ye bildirim gönderdiği adrestir; müşterinin tarayıcı dönüş adresi ve sizin uygulamanıza gönderilen Lunixi webhook adresi ayrıdır.
Ödeme, taksit ve iade
- Ödeme sonucu PayTR’ın bildirimi ve durum sorgusuyla doğrulanır. Müşterinin dönüş sayfasına ulaşması tek başına ödemenin tamamlandığı anlamına gelmez.
- Müşteri 3D Secure doğrulamasını tamamlamazsa ödeme, oturum süresi dolduktan sonra başarısız olarak kapanır.
- Tek çekim ve 2–12 taksit desteklenir. Taksit, kartın bağlı olduğu kart programına ve mağazanızın PayTR sözleşmesine göre sunulur; bir kart programına dahil olmayan kartlarla taksit yapılamaz. PayTR’ın bildirdiği taksit oranları bağlantı ekranında gösterilir.
- TRY, USD ve EUR ile ödeme alabilirsiniz. USD ve EUR için PayTR’dan onay almanız gerekir.
- Tam ve kısmi iade desteklenir. İade, PayTR’daki net bakiyeniz yeterli olduğunda gerçekleşir.
- PayTR bağlantısında ön provizyon ve iptal işlemi bulunmaz. Aynı gün içinde geri alma için iade kullanın.
PayTR Mağaza Paneli’nde taksit vade farkının müşteriye yansıtılması açıksa müşteriden, onayladığı tutardan farklı bir tutar çekilir. Lunixi bu durumda ödemeyi tamamlanmış saymaz ve işlemi mutabakat incelemesine alır. Taksitli satışlarda bu ayarı kapalı tutun.
Test
Bağlantıdaki Test Mode seçeneği açıkken işlemler PayTR’a test işlemi olarak gönderilir ve gerçek tahsilat yapılmaz. PayTR’ın ayrı bir test ortamı yoktur; test ve canlı işlemler aynı mağaza bilgileriyle çalışır. Test kartları için PayTR’ın test kart bilgileri (opens in a new tab) sayfasını kullanın.
TKPAY
TKPAY bağlantınızı POS Merkezi → Keşfet → TKPAY üzerinden oluşturun. TKPAY’in verdiği Üye İşyeri ID, İşyeri Güvenlik Anahtarı (Store Key), API Kullanıcı Adı, API Parolası, Client ID ve Client Secret bilgilerini girin. TKPAY kullanıcı adı ile Lunixi panel kullanıcı adınız farklı bilgilerdir.
Test bağlantısında TKPAY sandbox hesabınızı kullanın. TKPAY’e bildirilen çıkış IP adresinin ilgili ortamda izinli olması gerekir. Canlı işlemler için TKPAY’in canlı ortam hesabı ve bağlantısı gerekir; test hesabı canlı tahsilat yapmaz.
Ödeme ve taksitler
- TRY, USD, EUR ve GBP kart ödemeleri desteklenir. Müşterinin telefon numarası, e-posta adresi ve IP bilgisi ödeme isteğinde bulunmalıdır.
- Standart Lunixi kart akışında 3D Secure doğrulamasının ardından ödeme Lunixi tarafından tamamlanır ve sunucudan sorgulanır. Tarayıcının başarılı dönüş sayfasına ulaşması tek başına tahsilat kanıtı değildir.
- 3D Secure’suz satış için TKPAY hesabınızda ilgili yetkinin açık olması gerekir. 3D zorunlu bir işlem otomatik olarak 2D’ye çevrilmez.
- Taksit seçenekleri kartın ilk sekiz hanesi, tutar, para birimi ve bağlantınız için sorgulanır. Teknik üst sınır 36 taksittir; sunulan seçenekler kartınıza ve TKPAY sözleşmenize bağlıdır.
- Müşterinin onayladığı toplam korunur. TKPAY sorgusunda taksit için farklı bir toplam dönerse bu bağlantı o toplamla ödeme için uygun sayılmaz.
- TKPAY bağlantısında komisyon bilgisi işlem raporundan alınır. Bu komisyon gerçekleşen işleme aittir; genel maliyet oranlarınızı veya müşteriye gösterdiğiniz taksit oranını otomatik değiştirmez.
İade ve iptal
Tam ve kısmi iade desteklenir. Birden fazla kısmi iadenin toplamı satış tutarını aşamaz; TKPAY’de iade için yeterli ödenmemiş hakediş bakiyesi bulunmalıdır. Aynı gün, sağlayıcının gün sonundan önce iptal kullanılabilir. İptal reddedilirse otomatik iade başlatılmaz.
Yanıtı alınamayan satış veya iade yeniden gönderilmez. Sonuç sorgu ve işlem raporuyla kontrol edilir. Sağlayıcı bir iadeyi tekil operasyonla eşleştirecek bilgi vermiyorsa işlem beklemede kalır; toplam iade tutarı tek bir iadenin tamamlandığına kanıt sayılmaz.
Hakediş ve mutabakat
Hakediş & Mutabakat bölümünde Sağlayıcı yanıtı (API) eşleştirmesini ve Sağlayıcı yanıtı ödeme takvimini kullanın. Daha önce seçtiğiniz manuel takvim korunur.
İşlem raporları satış, iade ve iptal hareketlerini; işlem tutarı, komisyon ve varsa hakediş tarihini getirir. Sağlayıcının ödeme yaptı bildirimini panelde Sağlayıcı ödendi bildirdi · banka teyidi bekleniyor olarak görürsünüz. Bu bilgi banka ekstresiyle doğrulama yerine geçmez. Bildirilmeyen komisyon veya tarih sıfır ya da ertesi gün olarak doldurulmaz.
Kendi TKPAY POS’unuzda tahsilat sağlayıcı ile sizin aranızdadır. Lunixi, brüt tahsilatı size ödeyeceği bir platform bakiyesi olarak kaydetmez.
Dönüş adresleri
TKPAY’in ödeme sayfasından tarayıcı dönüşü, ödeme başlatılırken Lunixi tarafından iletilen adrese gelir. TKPAY paneline ayrıca satış/iade webhook URL’si girmeniz gerekmez. Uygulamanıza Lunixi’nin gönderdiği ödeme bildirimleri için Webhook ayarlarınızı kullanın.