Entegrasyonlar
Kullandığınız e-fatura, SMS, sanal POS ve WhatsApp hesabıyla çalışır
15 sağlayıcı panele hazır bağlı. Kurumun kendi hesabını kullanırsınız: kontör, komisyon ve fatura kontenjanı sizde kalır, para doğrudan sizin hesabınıza geçer. Sağlayıcı değiştirmek isterseniz panelden bir seçim kutusu yeterli.
e-Fatura ve ön muhasebe
Tahsilatı girdikten sonra faturayı ayrı bir programda yeniden yazmanız gerekmez. Kurum hangi entegratörle çalışıyorsa onu seçer, panel belgeyi o hatta gönderir.
-
Paraşüt
Ön muhasebe ve e-Arşiv / e-Fatura. Tahsilat girildiğinde belge kuyruğa alınır.
Paraşüt > Ayarlar > Uygulamalar (client ID / secret) ve adres çubuğundaki firma numarası.
-
Nilvera
Özel entegratör. e-Arşiv ve e-Fatura tek API anahtarıyla gönderilir; alıcı e-Fatura mükellefiyse belge kendiliğinden e-Fatura olarak kesilir.
Nilvera Portal > API Tanımları > Yeni Anahtar: e-Arşiv, e-Fatura ve Genel (mükellef sorgusu) yetkileriyle anahtar üretin. Anahtar yalnızca bir kez gösterilir. Portal > Tanımlamalar > Seriler bölümündeki e-Arşiv serisini de girin. Gönderici bilgisi portaldaki firma kaydından alınır.
-
Uyumsoft
Özel entegratör. Entegrasyon servisi kullanıcı adı ve şifre ile çalışır.
Uyumsoft e-Fatura Portalı > Kullanıcı Yönetimi bölümündeki entegrasyon kullanıcısı.
SMS sağlayıcıları
Ders ve taksit hatırlatmaları, portal giriş kodu ve toplu duyuru kurumun kendi SMS hesabından çıkar. Başlık ve kontör sizde kalır, mesaj bizim üzerimizden geçmez.
-
NetGSM
Türkiye’de en yaygın kullanılan SMS sağlayıcılarından biri.
NetGSM > Abonelik İşlemleri > Alt Kullanıcı Hesapları: türü "API Alt Kullanıcısı" olan bir alt kullanıcı açın. Kullanıcı adı abone numaranız (850… / 312…), şifre bu alt kullanıcının şifresidir; ana hesap şifresi API’de çalışmaz. Başlık, SMS Ayarları > Gönderici Adlarım listesinde onaylı olmalıdır.
-
İletimerkezi
JSON arayüzü. Gönderim referansı yanıtta döner.
İletimerkezi > Hesabım > API Bilgileri. Kullanıcı alanına API anahtarı (key), şifre alanına hash değeri girilir.
-
Verimor
JSON arayüzü. Yanıtta kampanya numarası döner.
Verimor OİM paneli > SMS Ayarları bölümünde API kullanıcı adı ve API şifresi tanımlanır; başlık ise Başlıklar bölümünde onaylanmış olmalıdır.
-
Mutlucell
XML arayüzü. Başarılı yanıt “$” ile başlayan mesaj numarasıdır.
Mutlucell > Müşteri Paneli > Kullanıcı Bilgileri. Başlık, panelde tanımlı originatör adıdır.
-
VatanSMS
JSON arayüzü (yeni panel, tek API anahtarı). Türkçe karakterli gönderim desteklenir; toplu gönderimde tüm alıcılar tek istekte gider.
VatanSMS > Api Entegrasyonu > API Key Göster. Kullanıcı adını boş bırakın, şifre alanına API anahtarını yazın; eski panel (api_id/api_key) hesaplarında kullanıcı adına api_id.
Online tahsilat (sanal POS)
Kursiyer taksitini karttan öder, para doğrudan kurumun kendi sanal POS hesabına geçer. Kart numarası ve CVV Direksyo’da saklanmaz.
-
PayTR
Ortak ödeme sayfası ya da panel içi kart formu. Tahsilat PayTR hattından geçer.
PayTR > Mağaza Paneli > Bilgi > Mağaza Bilgileri: mağaza no, merchant key ve merchant salt.
-
iyzico
Checkout Form. Ödeme sonucu ayrıca sağlayıcıya sorularak doğrulanır.
iyzico > Merchant Panel > Ayarlar > API Anahtarları: API key ve secret key.
-
Sipay
Barındırılan ödeme formu. Tutar ve sipariş bilgisi şifreli özetle imzalanır.
Sipay > Üye İşyeri Paneli > Ayarlar > Entegrasyon & API: merchant key, app id ve app secret.
WhatsApp bildirimleri
Ders, taksit ve sınav hatırlatmaları kurumun kendi WhatsApp hattından çıkar. WhatsApp Business (Meta Cloud API) ve VatanSMS WhatsApp Business API yollarında Meta’nın 24 saat kuralı gereği mesajlar yalnızca onaylanmış şablonlarla gönderilir. VatanSMS bağlı numarada kurumun kendi numarası düz metinle yazar. WhatsApp Web bağlantısı QR kodu veya telefonla eşleştirme koduyla kurulur; oturum sunucuda sürer.
-
WhatsApp Web
QR kodunu okutun veya eşleştirme kodunu WhatsApp’ta girin. Oturum Direksyo sunucusunda sürer.
Kurum panelinde QR kodu veya telefonla eşleştirmeyi seçin. WhatsApp > Bağlı cihazlar ekranında QR kodunu okutun ya da paneldeki eşleştirme kodunu girin.
-
WhatsApp Business (Meta Cloud API)
Hatırlatmalar kurumun kendi WhatsApp Business hesabından, Meta panelinde onaylanmış şablonlarla gönderilir. Gönderim sonucu panelden izlenir.
Meta for Developers > uygulamanız > WhatsApp > API Setup: telefon numarası kimliği (phone number ID) ve sistem kullanıcısı erişim belirteci. Mesaj şablonları (ders_hatirlatma, taksit_hatirlatma, ...) Meta iş panelinde aynı adlarla onaylatılmalıdır; gövdeleri {{1}} değişkenini içermelidir.
-
VatanSMS WhatsApp (bağlı numara)
Kurumun kendi WhatsApp numarası VatanSMS’e bağlanır; şablon gerekmez, düz metin gider. Bağlı numara WhatsApp kurallarına tabidir; toplu gönderimde hız sınırı VatanSMS tarafından uygulanır.
VatanSMS > Api Entegrasyonu > "API Key Göster". Numarayı panelde ya da aşağıdaki bağlantı adımıyla bağlayın; reg_id kendiliğinden dolar.
-
VatanSMS WhatsApp Business API
Meta WhatsApp Business hesabınız VatanSMS üzerinden kullanılır; mesajlar onaylı şablonla kampanya olarak gider.
VatanSMS > WhatsApp Business > Numaralarım: Meta telefon numarası kimliği (phone number ID). Şablonlar bölümünde gövdesi {{1}} olan onaylı bir şablon oluşturup ID’sini yazın.
Nasıl bağlanıyor
Kurulum için bize bir şey göndermeniz gerekmiyor; işlem tamamen sizin panelinizde.
-
1
Sağlayıcıda hesap açın
Panelde her sağlayıcının kendi sitesine ve kayıt sayfasına bağlantı var. Zaten hesabınız varsa bu adımı atlayın.
-
2
API bilgilerini kopyalayın
Anahtarın sağlayıcı panelinde hangi menüde durduğunu da yazıyoruz; “API Ayarları” gibi menü adları panelde birebir görünür.
-
3
Panele girin ve sağlayıcıyı seçin
Ayarlar bölümünde sağlayıcıyı seçtiğinizde yalnızca o sağlayıcının istediği alanlar açılır. Gizli anahtarlar şifreli saklanır ve bir daha ekranda gösterilmez.
-
4
Bağlantıyı doğrulayın
Seçtiğiniz sağlayıcının kurulum adımlarını tamamlayın. İşlemin yalnızca gönderilmiş olmasını yeterli saymayın; sağlayıcı hesabındaki sonucu da kontrol edin.
Açık konuşalım
Bu sayfada sağlayıcı adı saymak kolay; hangi sözü verdiğimizi de yazalım.
-
Hesap ve sözleşme sizin adınıza.
Kurumun sağlayıcıyla ilişkisine aracı olmuyoruz. Kontör, komisyon oranı, başlık onayı ve fatura kontenjanı sağlayıcı ile sizin aranızdadır; biz yalnızca API’ye bağlanırız.
-
Anahtarınızı görmüyoruz, göremeyiz.
Girdiğiniz gizli anahtarlar veritabanında şifreli saklanır ve ekranda bir daha gösterilmez. Kart numarası hiçbir sağlayıcıda veritabanımıza yazılmaz.
-
Bir sağlayıcı çökerse panel çökmez.
Sağlayıcıya çıkan her istek zaman aşımı ve hata sarmalamasıyla korunur. SMS gitmezse gitmediği kaydedilir; fatura gönderilemezse kayıt “bekliyor” kalır ve tekrar denenir.
-
Bazı sağlayıcıların akışını canlı hesapla henüz doğrulamadık.
Sağlayıcıların yayımlanmış API belgelerine göre hazırlanan bağlantıların canlı doğrulama durumu kartlarında belirtilir. Canlı doğrulama bekleyenlerde ilk işlemi küçük tutarla yapmanızı öneriyoruz; panelde de bu uyarıyı gösteriyoruz.
-
Sağlayıcı listesi kapalı bir liste değil.
Kullandığınız sağlayıcı burada yoksa bize yazın. İhtiyacınız olan bağlantıyı birlikte değerlendirelim.
Yazılımı Ayasofya Bilişim geliştirir. Entegrasyon kurulumunda takılırsanız panelden destek talebi açabilir ya da iletişim formunu kullanabilirsiniz.