Uygulamada eKYB: Apivom MERSIS API'si Şirket Doğrulamayı Nasıl Tek Bir API Çağrısına Dönüştürür?

Her B2B ilişki aynı sessiz soruyla başlar: bu şirket gerçekten iddia ettiği şirket mi? Bankalar hesap açmadan önce, pazaryerleri satıcıya ödeme yapmadan önce, distribütörler yeni bir bayiye kredi tanımadan önce, yazılım satıcıları ise bir tenant açmadan önce bu soruyu sorar. Soruya cevap veren disiplinin adı Know Your Business (KYB) — Müşterini Tanı'nın kurumsal karşılığıdır. Cevap taranmış bir PDF yerine yetkili bir sicilden, bir API üzerinden geldiğinde buna eKYB diyoruz.

Türkiye'de yetkili sicil, Ticaret Bakanlığı tarafından işletilen MERSIS — Merkezi Sicil Kayıt Sistemi'dir. Bu yazıda eKYB'nin ne olduğunu, bir Türk şirketini doğrulamanın neden göründüğünden zor olduğunu ve sorgu Apivom Atlas ile MERSIS şirket kartı API'si üzerinden çalıştığında somut olarak nelerin değiştiğini anlatıyoruz.

eKYB (Elektronik Know Your Business) Nedir?

KYB, KYC'nin kurumsal karşılığıdır. KYC gerçek kişiyi — kimlik, adres, yaptırım riski — doğrularken KYB tüzel kişiyi doğrular:

Varlık ve durum — şirket tescilli mi, faal mi, fesih veya tasfiye halinde mi?
Kimlik — ticaret unvanı, sicil numarası, sicil müdürlüğü, vergi kimliği.
Konum ve faaliyet — tescilli adres, beyan edilen faaliyet alanı (NACE kodları), sermaye.
Kontrol — ortaklar, hissedarlar, yönetim kurulu üyeleri, yetkili temsilciler.
Risk sinyalleri — iflas veya konkordato süreçleri, şube yapısı, güncel sicil ilanları.

Geleneksel KYB bunları belge olarak toplar: ticaret sicili gazetesi sureti, imza sirküleri, vergi levhası, kaşeli faaliyet belgesi. Biri yükler, bir başkası okur; ikisi de PDF basıldığından beri hiçbir şeyin değişmediğini umar.

eKYB bu belge kovalamacasını birincil kaynağa yapılan makine tarafından okunabilir bir sorguyla değiştirir. Müşteri vergi numarasını girer, arka uç sisteminiz sicile sorar ve cevap, onboarding iş akışınızın milisaniyeler içinde değerlendirebileceği yapılandırılmış JSON olarak gelir. Değer yalnızca hız değildir: yapılandırılmış veri yeniden kontrol edilebilir, karşılaştırılabilir ve denetlenebilir — kâğıt bunu asla yapamaz.

Bir Türk Şirketini Doğrulamak Neden Göründüğünden Zor?

Yalnızca AB veya ABD sicilleriyle çalışmış ekipler Türkiye'deki tabloyu genellikle hafife alır. Her eKYB tasarımını şekillendiren birkaç gerçek var:

İki kimlik, iki amaç. Şirketler Gelir İdaresi'nin verdiği 10 haneli vergi kimlik numarası (VKN) ile ticaret sicilinin verdiği 16 haneli MERSIS numarası taşır. Müşteriler vergi numaralarını bilir; sicil ise MERSIS diliyle konuşur. Kullanılabilir bir eKYB akışı ilkini kabul edip ikincisini çözümlemelidir.

Şahıs işletmeleri kişidir. Şahıs işletmesi, sahibinin T.C. kimlik numarası altında tescil edilir ve bir kişi birden fazla işletme yürütebilir. Bu numarayla yapılan bir sorgu meşru olarak birden fazla sicil kaydı döndürebilir. "Bir vergi numarası, bir şirket" varsayan kod sessizce veri kaybeder.

Şubeler ayrı kayıtlardır. Büyük perakendeciler, lojistik firmaları ve bayi ağları, her biri kendi MERSIS numarası ve faaliyetiyle onlarca şube tescil eder. Merkezi doğrulamak, siparişi fiilen imzalayan şube hakkında hiçbir şey söylemez.

Gazete hukuki gerçektir. Adres, sermaye, yönetici veya hukuki durum değişiklikleri Türkiye Ticaret Sicili Gazetesi'nde ilan edildiğinde bağlayıcı olur. Ciddi bir durum tespiti dosyası hâlâ en güncel ilana — tercihen bir transkripsiyon değil, orijinal belge olarak — ihtiyaç duyar.

Güncellik kapsamdan önemlidir. Sicil verisi her gün değişir. Onboarding'de yapılan doğrulama bir anlık görüntüdür; kredi ve uyum ekiplerinin yenilemede, ödemede veya risk modeli istediğinde ucuz bir yeniden doğrulama yoluna ihtiyacı vardır.

Apivom MERSIS API'si Gerçekte Ne Döndürür?

Apivom, resmi TOBB Şirket Kartı (MERSIS) veri setini, Apivom müşterileri için halihazırda onlarca üst kaynağın önünde duran API ağ geçidi Atlas üzerinden yeniden satar. Tek bir devasa kayıt yerine API, dört şirket kartı derinlik seviyesi ve bir şube kartı sunar; böylece kararınızın gerektirdiği derinliği tam olarak talep edersiniz:

Seviye	Ne alırsınız	Tipik karar
Kart 1 — Temel	Ticaret unvanı, MERSIS numarası, sicil müdürlüğü, tescil durumu	"Bu şirket var mı ve faal mi?"
Kart 2 — Adres, sermaye ve NACE	Kart 1 + yapılandırılmış adres, sermaye detayı, NACE faaliyet kodları	Adres eşleştirme, faaliyet uyum kontrolleri, segmentasyon
Kart 3 — Ortaklar, yönetim kurulu ve temsilciler	Kart 1–2 + ortaklar, aktif yönetim kurulu üyeleri, yetkili temsilciler, denetçiler	Nihai faydalanıcı ve imza yetkilisi kontrolleri
Kart 4 — Tam kayıt	Kart 1–3 + iflas/konkordato durumu, 50 adede kadar şube, en güncel Ticaret Sicili Gazetesi ilanı (PDF)	Kredi limitleri, yüksek tutarlı sözleşmeler, denetim dosyaları
Şube kartı	MERSIS numarasıyla şube düzeyinde kayıt, merkez bağlantısı dahil	Fiilen işlem yapan tüzel kişiliğin doğrulanması

Sorgular vergi numarasıyla (şubeler için MERSIS numarasıyla) yapılır ve yanıt, merkez bölümünün bir dizi olduğu güncel TOBB sözleşmesini izler — şahıs işletmesi durumu, ekibinizin canlı ortamda keşfedeceği bir istisna olmak yerine doğru biçimde ele alınır. Tam istek ve yanıt şemaları Atlas Portal MERSIS kılavuzunda herkese açık olarak belgelenmiştir.

eKYB'yi Apivom Atlas Üzerinden Çalıştırmanın Yedi Somut Faydası

1. Tek sözleşme, tek anahtar, üst kaynakla uğraşmak yok

Türk sicil web servislerine doğrudan erişim; ticari bir anlaşma, eski bir spesifikasyona karşı teknik entegrasyon ve sürekli sözleşme yönetimi demektir. Atlas ile self-servis portaldan tenant'a özel bir API anahtarı alır, HTTPS üzerinden temiz bir REST uç noktasını çağırır ve aynı gün doğrulamaya başlarsınız. Anahtar döndürülebilir, depoda özet (hash) olarak saklanır ve yalnızca sizin organizasyonunuza bağlıdır.

2. Deneme için değil, veri için ödersiniz

Ticari model ön ödemeli ve sorgu başınadır. İki kural bunu öngörülebilir kılar: şirket bulunamayan bir sorgu asla ücretlendirilmez ve aynı sorgunun tekrarı ağ geçidi önbelleğinden ücretsiz sunulur — yanıt, önbellekten gelip gelmediğini açıkça belirtir. Gerçekten taze veriye ihtiyacınız olduğunda tek bir force bayrağı önbelleği atlar ve ücretli canlı sorgu yapar. Finans ekibiniz sürpriz bir fatura değil, ön ödemeli bir bakiye ve bir hareket dökümü görür.

3. Talebe göre derinlik

Veri kademeli olduğu için bir onboarding formu herkes için Kart 1'i, yalnızca kredi eşiğinin üzerindeki hesaplar için Kart 3'ü, yalnızca sözleşme imzalanmak üzereyken Kart 4'ü çalıştırabilir. Evet/hayır sorusuna cevap vermek için tam kaydı satın almak zorunda kalmazsınız — eskiden "her lead için fazla pahalı" olan doğrulama adımı rutine dönüşür.

4. Resmi kaynak, makine tarafından okunabilir

Her alan, şirket kartı veri setini dağıtmakla yetkili kuruluş TOBB aracılığıyla ticaret sicilinden gelir. Yanıt tutarlı bir zarf içinde JSON olarak gelir — üst kaynak durumu, ücret bilgisi, önbellek bayrağı — böylece aynı kod yolu serbest metin ayrıştırmadan başarı, "bulunamadı" ve yetersiz bakiye sonuçlarını ele alır.

5. Kontrol ve imza yetkisi görünürlüğü

Kart 3, düzenleyicilerin ve kredi komitelerinin gerçekten sorduğu soruları cevaplar: ortaklar kim, yönetim kurulunda kim var, imzaya kim yetkili, defterleri kim denetliyor. Kara para aklamayla mücadele iş akışını besleyen Know-Your-Business programları için bu, elle aktarılan imza sirkülerinin yerini alan yapılandırılmış girdidir.

6. Şube ve iflas farkındalığı

Kart 4; iflas ve konkordato durumunu, 50 adede kadar şubeyi ve en güncel gazete ilanını orijinal PDF olarak sunar. Şube kartı ise sipariş veren veya kredi talep eden konumu özel olarak doğrulamanızı sağlar — dağıtım, lojistik ve franchising'de önemli bir ayrım.

7. Uyum ekibinizin denetçiye gösterebileceği gözlemlenebilirlik

Atlas Portal, anahtar başına kullanım ve sistem kayıtlarını tutar, toplu çalıştırma öncesi sorgulayabileceğiniz bir bakiye uç noktası sunar ve kod yazmadan payload test etmek için bir Try-it konsolu sağlar. Hatta yapay zekâ kodlama asistanınızın API'yi tahmin etmek yerine resmi açıklamadan entegre edebilmesi için makine tarafından okunabilir bir llms.txt kılavuzu da vardır.

eKYB'nin İlk Karşılığını Verdiği Yerler

B2B müşteri onboarding'i. Bir yazılım satıcısı veya distribütör, hesap açmadan önce hukuki varlığı ve faaliyeti doğrular; ardından CRM kaydını sicil unvanı, adres ve NACE koduyla zenginleştirir. Apivom Iris kullanan ekipler bunu mükerrer hesapları durdurmak ve müşterileri tahmin yerine beyan edilen faaliyete göre segmentlemek için kullanır.

Bayi ve iş ortağı ağları. Yüzlerce bayiyi yöneten satıcılar her program yenilemesinde ortak durumunu yeniden doğrular. Tüm ağ genelinde otomatik Kart 1 kontrolleri, tek bir manuel incelemenin çok küçük bir kesrine mal olur.

Pazaryeri ve fintech ödemeleri. Türk satıcılara ödeme yapan platformlar fonları serbest bırakmadan önce alacaklı tüzel kişiyi ve yetkili temsilcilerini doğrular; banka bilgileri değiştiğinde kontrolü yeniler.

Tedarikçi durum tespiti. Satın alma ekipleri çerçeve anlaşması imzalamadan önce tam kaydı — iflas durumu ve en güncel gazete dahil — çeker ve gazete PDF'ini tedarikçi dosyasına koyar.

Kredi kararları. Sermaye detayı, yönetim kurulu yapısı, şube sayısı ve konkordato bayrakları, yılda bir değil talep üzerine yenilenen kredi modeli özellikleri haline gelir.

Sınır ötesi karşı taraflar. Aynı Atlas anahtarı, VIES entegrasyonu üzerinden bir AB ticaret ortağının KDV numarasını doğrulayabilir; böylece tek bir uyum servisi hem Türk sicilini hem de Avrupa KDV doğrulamasını kapsar.

Referans Bir eKYB Akışı

Pratik bir uygulama nadiren beş adımdan fazlasına ihtiyaç duyar:

Vergi numarasını alın — onboarding formunuzda toplayın ve biçimini istemci tarafında doğrulayın.
Kart 1'i çalıştırın — arka uçtan, Atlas API anahtarınızla. Kayıt yoksa veya durum faal değilse reddedin ya da manuel incelemeye yönlendirin. Merkez dizisini yinelemeyi unutmayın.
Riske göre yükseltin. Yapılandırılabilir bir eşiğin üzerinde ortakları ve imza yetkililerini almak için Kart 3'ü; sözleşme imzasından önce Kart 4'ü çalıştırıp gazete PDF'ini arşivleyin.
Kanıtı saklayın. Yanıtı, zaman damgasını ve önbellek bayrağını müşteri kaydıyla birlikte depolayın — denetim iziniz budur.
Yeniden doğrulamayı planlayın. Yenilemede veya bir risk tetikleyicisinde Kart 1'i tekrar çalıştırın. Değişmeyen sorgular önbelleğe düşer ve hiçbir maliyet oluşturmaz; iş olayı taze veri gerektirdiğinde force bayrağını kullanın.

Akışın tamamı sizin tarafınızdan durumsuzdur: üst servislere kimlik bilgisi yok, SOAP istemcisi yok, gazete kazıma yok. Kimlik doğrulama, yeniden deneme, hata eşleme ve ölçümlemeyi Atlas üstlenir.

Başlarken

Atlas Portal'ı açın ve bir organizasyon oluşturun.
Ön ödemeli bakiyeyi yükleyin ve bir API anahtarı üretin.
İlk Kart 1 sorgunuzu göndermek için Try-it konsolunu veya herkese açık MERSIS belgelerini kullanın.
Çağrıyı onboarding arka ucunuza bağlayın — asla tarayıcıdan değil — ve kanıtı saklayın.

İş akışınıza özel bir anlatım için MERSIS entegrasyon sayfası ve Atlas MERSIS ürün sayfası doğru başlangıç noktalarıdır.

Sonuç

eKYB bir uyum onay kutusu değildir; işletmenizin bir karşı tarafa kredi, erişim veya parayla güvenip güvenmeyeceğine karar verdiği andır. Apivom'un MERSIS API'si bu anı; seçtiğiniz derinlikte resmi sicil verisi döndüren, yalnızca fiilen aldığınız veri için ücret alan ve uyum ekibinizin savunabileceği bir denetim izi bırakan tek bir kimlik doğrulamalı çağrıya dönüştürür. Bir kez doğrulayın, ucuza yeniden doğrulayın ve onboarding'inizin satış ekibinizin hızında ilerlemesine izin verin.