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.
Nilvera Portal > Ayarlar > API Anahtarları bölümünden anahtar üretilir.
-
Bizim Hesap
Ön muhasebe. Fatura tek çağrıyla oluşur, yanıtta belgenin görüntüleme adresi döner.
Bizim Hesap > Ayarlar > Entegrasyon bölümündeki firma (firm) ID.
-
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 > Müşteri Paneli > Ayarlar > API Ayarları. Kullanıcı adı abone numaranızdır, şifre panelde ayrıca belirlenen API şifresidir.
-
İ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ü. Türkçe karakterli gönderim desteklenir.
VatanSMS > Hesabım > API Bilgilerimi Görüntüle. Kullanıcı alanına api_id, şifre alanına api_key girilir.
Online tahsilat (sanal POS)
Kursiyer taksitini karttan öder, para doğrudan kurumun kendi sanal POS hesabına geçer. Kart numarası bizim sunucumuza hiç gelmez.
-
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.
-
Param POS
Ortak ödeme sayfası. Bankanın 3D Secure adımına yönlendirilir.
Param > Üye İşyeri Paneli: müşteri (client) kodu, kullanıcı adı, şifre ve GUID.
-
Shopier
Barındırılan ödeme sayfası. Küçük kurumlar için en hızlı kurulan seçenek.
Shopier > Mağazam > Ayarlar > Entegrasyonlar / API: API key ve API secret.
WhatsApp bildirimleri
Ders, taksit ve sınav hatırlatmaları kurumun kendi WhatsApp Business hesabından çıkar. Meta’nın 24 saat kuralı gereği mesajlar yalnızca Meta panelinde onaylanmış şablonlarla gönderilir; WhatsApp’a ulaşılamazsa aynı bildirim SMS’e düşer.
-
WhatsApp Business (Meta Cloud API)
Hatırlatmalar kurumun kendi WhatsApp Business hesabından, Meta panelinde onaylanmış şablonlarla gönderilir; WhatsApp’a ulaşılamazsa SMS’e düşülür.
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.
Muhasebe aktarımı
Tahsilat ve kasa hareketlerinden genel muhasebe fişi dökümü alınır; hesap kodları panelden kendi hesap planınıza göre eşlenir. Birebir program formatı iddia etmiyoruz: döküm, bu programların içe aktarma sihirbazlarında sütun eşleyerek kullanılır.
-
Luca
TÜRMOB’un muhasebe programı. Dökümdeki hesap kodları sizin hesap planınıza göre yazılır.
-
Logo
Logo ürünlerinin içe aktarma sihirbazında sütun eşleyerek kullanılır.
-
Mikro
Mikro Yazılım programlarının fiş içe aktarma ekranıyla uyumlu genel döküm.
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
Küçük bir tutarla deneyin
Canlı sunucuda sağlayıcının sandbox ucu hiç kullanılmaz; seçtiğiniz hat her zaman gerçek hattır. Kapatmayı unutabileceğiniz bir anahtar olmadığı için ilk işlemi düşük tutarla yapıp hesabınıza geçtiğini görmeniz yeterli.
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.
Kod her sağlayıcının yayımlanmış API belgesine göre yazıldı, ancak canlı kimlik bilgisiyle uçtan uca denenmiş olanlar şimdilik Paraşüt, NetGSM, İletimerkezi, PayTR ve iyzico. Yeni eklenenlerde 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. Panelin sağlayıcı yapısı tek bir arayüz üzerine kurulu; yenisini eklemek küçük bir iş.
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.