Ödeme ve e-belge entegrasyonlarını bağlama: kimlikler, test ve canlıya geçiş

Genel bakıştaki Tahsilat yöntemi kartlarından birini seçersiniz: Kendi üye işyeri (kendi iyzico üyeliğiniz, para doğrudan size geçer, PratiVia komisyon almaz) ya da Platform aracılı tahsilat (üyeliğiniz yoksa iyzico pazaryeri alt üye işyeri, ayrıntılar ayrı makalede). Kendi üye işyeri ekranında bugün yalnız iyzico seçilebilir. Başka bir sağlayıcıyla kayıtlı eski bir yapılandırmanız varsa ekran bunu kırmızıyla belirtir ve iyzico’ya geçmenizi ister.

Ekran iyzico panelindeki adlarla iki anahtar ister: API anahtarı (API Key) ve Güvenlik anahtarı (Secret Key). İkisi iyzico üye işyeri panelinde Ayarlar › Firma Ayarları bölümündedir. Ortam seçimi iki seçeneklidir: Deneme: gerçek para çekilmez (iyzico deneme panelinin anahtarları) ve Gerçek ödeme (canlı panelin anahtarları). Ödemenin aktarılacağı IBAN da aynı ekrandadır. Tahsilat hesabını yalnız kurum sahibi, kendi oturumunda değiştirebilir ve doğrulayabilir.

Ayarlar ile anahtarlar tek bir kaydet çubuğuyla (“Yapılandırmayı kaydet”) birlikte kaydedilir. Kaydedilmemiş değişiklik varken “Bağlantıyı doğrula” kapalıdır, çünkü doğrulama kaydedilmiş bilgilerle yapılır. Doğrulama iyzico’ya küçük bir sorgu gönderir: anahtar geçerliyse durum “Aktif” olur, değilse “Hata” rozeti ve iyzico’nun nedeni görünür. Gerçek ödemeye geçtiğinizde canlı anahtarları girip yeniden doğrulamanız gerekir.

1. 1iyzico panelinde Ayarlar › Firma Ayarları’ndan API anahtarı ve güvenlik anahtarını kopyalayın (önce deneme panelinden).
2. 2Entegrasyonlar › Tahsilat ve e-belge › Kendi üye işyeri’ni açın. Ortam’ı “Deneme” bırakın, iki anahtarı ve IBAN’ı girip “Yapılandırmayı kaydet”e basın.
3. 3“Bağlantıyı doğrula”ya basın. Durum “Aktif” olmalı.
4. 4Gerçek tahsilata geçerken Ortam’ı “Gerçek ödeme” yapın, canlı paneldeki anahtarları girin, kaydedin ve yeniden doğrulayın.

İlk soru Belgeleri kim iletsin? sorusudur. PratiVia iletsin (hesap gerekmez) seçeneğinde ayrı bir entegratör hesabı açmazsınız. Belgeler PratiVia’nın entegratör sözleşmesi üzerinden sizin adınıza iletilir. Bu yol PratiVia’nın e-belge iletimi açıkken çalışır. Açık değilse ekran bunu yazar ve doğrulama nedenini söyler. İlk kurulumda iletim açıksa ekran bu seçenekle gelir. Kendi entegratör hesabım var seçeneğinde bugün Nilvera kullanılır ve tek bir API anahtarı istenir (Nilvera portalında API anahtarı bölümünden oluşturulur, deneme ortamı için test portalının, gerçek kullanım için canlı portalın anahtarı).

Mükellef türü belge türünü belirler: şahsınız adına serbest meslek makbuzu kesiyorsanız “Serbest meslek erbabı” (e-SMM, stopaj oranıyla), şirketseniz “Şirket / tüzel kişi” (e-Fatura ya da e-Arşiv, alıcıya göre fatura anında seçilir). Emin değilseniz mali müşavirinize danışın. Belgelerde görünecek unvan ve VKN/TCKN girilmeden doğrulama yapılamaz.

“Bağlantıyı doğrula” Nilvera’ya kurumunuzun VKN’siyle kimlik doğrulamalı bir sorgu yapar. Anahtar reddedilirse durum “Hata” olur ve “Nilvera API anahtarı kabul edilmedi” gibi bir neden yazar. Anahtarı ve seçtiğiniz ortamı (deneme ya da gerçek) kontrol edip yeniden kaydedin. Daha önce kullanıcı adı ve parolayla kaydedilmiş bir Nilvera hesabı varsa doğrulama API anahtarı girmenizi ister.

Entegrasyonlar ekranı (sol menüde Yönetim grubunda) dış bağlantıları ne işe yaradıklarına göre üç bölümde toplar: Ödeme ve resmî kurumlar (online tahsilat, e-Fatura / e-Arşiv / e-SMM, TC kimlik doğrulama ve sektörünüzde varsa Medula), Takvim eşitleme (Google ve Outlook) ve Mesajlaşma ve görüşme (SMS, e-posta, WhatsApp, görüntülü görüşme, mobil uygulama bildirimleri). Her servis kendi kartında tek durum rozeti ve o duruma uyan tek düğmeyle görünür. Kurulmamış bir servis için “Test et” sunulmaz.

Ekran kurumunuza göre süzülür. Sektörünüzde kullanılmayan servis hiç görünmez: Medula (SGK provizyon ve reçete) yalnız Medula modülü olan sektörlerde (psikiyatri, diş hekimliği, genel tıp) çıkar. Güzellik, hukuk, veteriner gibi sektörlerde kart da, açılma talebi de yoktur. Sektörünüzde olup paketinizin kapsamadığı servis Paketinize dahil değil der ve Paketleri gör ile paket ekranını açar. Görüntülü görüşme kurumunuzda kapalıysa Kurumunuzda kapalı ve Aç, Telesağlık Ek Koşulları henüz kabul edilmediyse Koşul onayı bekliyor ve Koşulları gör görünür. İkisi de Ayarlar › Online görüşme ekranına götürür.

Diğer rozetler: Kurulmadı: kurumunuzun bağladığı bir servis (tahsilat, e-belge) henüz kurulmadı. Kur ayar ekranını açar. Bağlı / Açık: servis çalışıyor. Tahsilat ve e-belgede Yönet, Medula’da Ayarları aç ilgili ayara gider. Test edilebilen servislerde bağlantı testi kartın ⋯ menüsündedir. Doğrulanmadı gibi sarı rozetler eksik bir adımı gösterir. Tamamla o adıma götürür. Henüz açık değil: servisi PratiVia açar. Kurum sahibi, yöneticisi ya da işletme yöneticisi Açılmasını iste ile kısa bir notla talep gönderir. Kart Talep edildi rozetine geçer ve Talebi gör yazışmayı Destek ekranında açar. Aynı servis için ikinci talep açılmaz. Servis açılınca kart kendiliğinden “Açık” görünür, talep “Çözüldü” olarak kapanır ve talebi gönderene bildirim gelir.

Android ve iPhone bildirimleri tek Mobil uygulama bildirimleri kartındadır. Yalnız biri açıksa kart hangisinin açık olduğunu yazar. Takvim bağlama, kaldırma ve bağlantı testleri yalnız kurum sahibi ya da yöneticisindedir. İşletme yöneticisi kartları görür ve bunu belirten bir not okur. WhatsApp açıkken kartın içinde yurt dışına aktarım beyanının durumu yazar. Beyan verilmemişse Beyanı görüntüle beyan penceresini açar.

Bildirimler ekranında “Bağlı değil” rozetli bir kanal görürseniz bağlantı durumunu bu ekrandan kontrol edin. Sağlayıcı bağlanana kadar o kanaldan mesaj gitmez.

Bu ekrandaki tahsilat ve e-belge ayarları kurumun kendi kimliğine aittir. Çok şubeli kurumda bir şube ayrı bir şirketse, o şirketin e-belge ve ödeme hesabı burada değil, Kurum Yapısı › Şubeler › şube › Fatura kimliği sekmesinde bağlanır: aynı kart dili (tek durum, tek düğme: Bağla / Test et / Düzenle). Şubenin e-belge “Test et”i de hesabı entegratöre sorar. Anahtar reddedilirse hesap “Hata”ya düşer ve neden yazılır. Şube ödeme hesabını yalnız kurum sahibi bağlar. Anahtarlar geri gösterilmez.

Kurumun hesabı o şubenin faturaları için yedek olarak kullanılmaz: şubenin hesabı bağlı değilse o şubenin e-belgesi bekler, online ödemesi kapalı kalır. Ayrıntılar “Şubeler” makalesindedir.