iyzico tahsilatının sonucu satış ekranına gelir; kart verisi gelmez.
Tutar, tarih, durum ve varsa taksit sayısı müşteri kartına alan olarak taşınır; ödemesi geçmeyen sipariş için sorumluya görev açılır. Dürüst olalım: iyzico ürünün ödeme sağlayıcı kaydında tanımlı bir adaptör, ama canlı bir tahsilat akışını bugün bir müşteri kurulumuyla gösteremiyoruz. Bağlantıyı REST API ve dönemsel aktarımla biz kuruyoruz.
Ödeme iyzico'da geçti; satış tarafı hâlâ bilmiyor
iyzico sorusu genellikle Türkiye içine kartla satan şirketlerden gelir: e-ticaret, bayi satışı, kurumsal hizmet, eğitim. iyzico Türkiye'de kartla ödeme kabul etmeyi sağlayan bir ödeme kuruluşudur; sanal POS, ödeme linki ve pazaryeri tarafında ürünleri vardır. Hangi ürünün sizde açık olduğu, komisyon ve taksit koşulları iyzico'nun kendi sayfasında yazar — o rakamları bu sayfaya taşımıyoruz.
Mekanizma şu: tahsilat bilgisi ödeme tarafında oluşur, satış tarafı o panele bakmaz. Kendi projelerimizde gördüğümüz tablo şu:
- Temsilci teklifi onaylatır, ödeme linkini gönderir ve bekler. Link açıldı mı, ödeme geçti mi, taksitli mi geçti — hiçbiri onun ekranında değildir.
- iyzico paneline erişim finansta ve muhasebededir; her temsilciye açılması da doğru değildir. Dolayısıyla “ödendi mi” sorusunun tek cevap yolu bir mesaj trafiği olur.
- Ödemesi geçmeyen sipariş hafızada kalır. Perşembe gönderilip Pazartesi hatırlanan link kimsenin raporunda görünmez.
- Taksit ve komisyon farkı tekliften sonra ortaya çıkar; şirketin eline geçen net tutar satış tarafında görünmez.
- İade edilmiş bir ödeme fırsat kaydında hâlâ “kazanıldı” olarak durur; ay sonunda iki farklı rakam tartışılır.
- Hatırlatma temsilcinin kişisel telefonundan gider; temsilci ayrılınca yazışma da onunla gider.
Bunların hiçbiri ödeme kuruluşu değiştirerek çözülmez. Hepsi, iyzico'da zaten oluşmuş bilginin müşteri kaydına ulaşmamasından doğar.
Önce dürüst tablo: adaptör tanımlı, saha ölçümü yok
Ürünün ödeme sağlayıcı kaydında iyzico tanımlı bir adaptör olarak duruyor — PayNkolay ile birlikte, o kayıttaki iki addan biri. Ama bu sayfa “iyzico entegrasyonumuz hazır” demiyor, çünkü diyemez: canlı bir iyzico tahsilat akışını bugün bir müşteri kurulumuyla gösteremiyoruz.
İki cümle arasındaki farkı bilerek koruyoruz. “Adaptör üründe tanımlı” bir kayıt durumudur; “sahada çalışıyor” bir ölçümdür. İkincisi elimizde yok.
Aynı ayrımı ürünün başka bir yerinde de böyle yazdık: belge imzalama ekranı kurulu ama sahada ölçülmedi — 8 kiracıda 0 imza. Ekranın kurulu olması, kullanıldığı anlamına gelmiyor. iyzico adaptörü için de bugün paylaşabileceğimiz bir saha ölçümü yok; olsaydı sayıyı yazardık.
Pratik sonucu şu: adaptör kendi iyzico hesabınızla yapılandırılır, ama işe başladığınız gün sizi bekleyen şey bir düğme değil bir kurulumdur. Tahsilat bilgisini satış ekranına taşımak istiyorsanız bunu — REST API, dönemsel aktarım ya da ikisinin karışımı — kapsamı keşif görüşmesinde belirlenen bir iş olarak kuruyoruz. Genel yaklaşımımızı entegrasyonlar sayfasında aynı açıklıkla yazdık; aynı soruyu PayTR ve Param için de ayrı ayrı cevapladık.
Hangi veri hangi yöne akıyor
| Veri | Nerede oluşur | Yön | CRM tarafında ne olur |
|---|---|---|---|
| Kart numarası, CVV, son kullanma tarihi | iyzico ve banka tarafında | Hiçbir yöne akmaz | CRM'e girmez; bu alanlar üründe hiç açılmaz |
| Ödemenin sonucu: tutar, tarih, para birimi, durum | iyzico tarafında | iyzico → CRM | Müşteri ve fırsat kaydına alan olarak yazılır |
| Taksit sayısı ve kesinti sonrası net tutar | iyzico tarafında hesaplanır | iyzico → CRM | Alan olarak taşınır; komisyonu CRM hesaplamaz |
| İade ve iptal bilgisi | iyzico tarafında | iyzico → CRM | Durum alanı güncellenir; iadeyi CRM başlatmaz |
| Sipariş ya da ödeme referans numarası | Her iki tarafta | Eşleşme anahtarı | Ödemeyi doğru kayda bağlayan alan; keşifte seçilir |
| Ödeme linki | iyzico tarafında üretilir | CRM üretmez | Linki gönderme ve gönderimi kayda bağlama CRM'de çalışır |
| Müşteri adı, e-posta, telefon | CRM tarafında | Varsayılanda akmaz | Ödeme tarafına alan geçmesi gerekiyorsa kapsamda tek tek yazılır |
| 3D Secure doğrulaması ve banka yönlendirmesi | iyzico ve banka tarafında | CRM'e akmaz | CRM bu akışın hiçbir adımında yer almaz |
Bağlantı kurulduğunda CRM tarafında ne yapılabiliyor?
Tahsilat sonucunun kayda taşınması
Tutar, tarih, para birimi, durum ve varsa taksit sayısı alan olarak gelir. Paranın otoritesi iyzico tarafında kalır; CRM bir görünürlük katmanı ekler.
Ödemenin siparişle eşleştirilmesi
Ödeme kaydı, sipariş numarası ya da müşteri kodu anahtar alınarak ilgili fırsat ve müşteri kaydına bağlanır. Anahtar alan keşifte seçilir, test aktarımında doğrulanır ve yazılı kapsamda durur.
Ödenmemiş siparişte görev üretimi
Belirlenen sürede tahsilatı geçmeyen kayıt için sorumluya görev açan kural kurulur. CRM tahsilat denemesi yapmaz; yalnız insanın yapacağı takibi kayda bağlar.
Hatırlatmanın şirket kanalından gitmesi
WhatsApp Business ve SMS bağlantıları bugün üründe çalışıyor; hatırlatma şirket numarasından gider ve aynı kayda işlenir. Ticari ileti İYS izin kaydıyla birlikte yürür.
Ödeme alanlarını kod yazmadan tanımlamak
iyzico referansı, taksit sayısı, net tutar ya da tahsilat kanalı gibi alanları yönetici kod yazmadan ekler. Özel alan ekleme üründe standarttır: bugün 19 kiracıda toplam 277 özel alan tanımlı; bir kiracı 9 özel nesne ekledi.
Tahsil edilmemiş tutarın raporlanması
“Kazanıldı ama tahsil edilmedi” ayrı bir görünüm olur. Satış ve finans aynı tabloya bakar; ay sonunda iki farklı rakam tartışılmaz.
Bağlantı nasıl kuruluyor: REST API, OAuth2, webhook
Teknik taraf da satış tarafı kadar açık olsun.
Arayüz. Ürün kutudan 183 iş nesnesiyle geliyor ve her biri REST API'de kendi veri ve şema ucuyla yayımlanıyor — alan yapısını describe ile dışarıdan okuyabilirsiniz. Yetkilendirme OAuth2 ile yapılır. Hacim tarafında iki sayı işinize yarar: composite uç tek istekte 25 alt-istek taşır, toplu uç bir çağrıda 200 kayıt yazar. Bir günlük tahsilat dosyasının kaç istekte biteceğini bu iki sayı belirler.
Webhook — burada dikkat. Üründeki webhook giden yöndedir ve imzalıdır: CRM'de bir şey olduğunda dışarıya bildirim gider. iyzico'nun size gönderdiği bildirimi kutudan dinlediğimizi söylemiyoruz. Gelen bildirimin nasıl karşılanacağı — doğrudan mı, aradaki bir uç mu — keşifte kararlaştırılan bir kurulum kalemidir.
Dönemsel aktarım. Olay bazlı akış kurulmuyorsa tahsilat dosyası dört adımlı içe/dışa aktarma sihirbazıyla dönemsel olarak taşınır. Tavan şudur: dosya 25 MB, iş 100.000 satır. Sıklık — günlük ya da gün içinde birkaç kez — yazılı kapsamda tanımlanır; peşinen “anında” demiyoruz.
Test aktarımı neden asıl adım? Çünkü ölçtük: 8 kiracıda 34 içe aktarma işi çalıştı, 16'sı hatayla bitti. Yarıya yakını. Alan eşlemesinin kendiliğinden tutmadığını da ölçtük — ölçtüğümüz bir kişi dışa aktarımında 17 başlığın 13'ü eşleşti, 2'si yanlış alana bağlandı. Yanlış alana bağlanmış bir tutar, boş kalmış bir tutardan daha zararlıdır: boş olanı görürsünüz, yanlış olanı görmezsiniz. Bu yüzden örnek bir dönemin tahsilatını canlıdan önce test olarak aktarıyoruz.
Bağlantıyı kendi geliştiriciniz yazmak isterse bu desteklediğimiz bir yoldur: API belgesini, OAuth2 erişimini, nesne tanımlarını ve alan eşleme tablosunu veririz.
iyzico tarafında ne var, ne yok
| Ne isteniyor | Rapitek CRM'de | Nerede yapılır |
|---|---|---|
| iyzico'nun ürüne gömülü ödeme adaptörü olarak gelmesi | Kısmen. Ürünün ödeme sağlayıcı kaydında iyzico tanımlı; canlı bir tahsilat akışını bugün bir müşteri kurulumuyla gösteremiyoruz | Rapitek CRM — kendi iyzico hesabınızla yapılandırılır |
| Ödeme tutarı, tarihi ve durumunun müşteri kartında görünmesi | Var. REST API ya da dönemsel aktarımla alan olarak taşınır | Rapitek CRM — kapsamı keşifte belirlenen bağlantıyla |
| Ödemesi geçmeyen sipariş için takip görevi | Var. Süre eşiği, sorumlu ve zamanlama kurulumda tanımlanır | Rapitek CRM |
| Ödeme hatırlatmasının şirket numarasından gitmesi | Var. WhatsApp Business ve SMS bağlantıları bugün üründe çalışıyor; İYS izin senkronu iki yönlü | Rapitek CRM — kendi Meta ve Verimor hesaplarınızla |
| CRM ekranından iyzico ödeme linki üretilmesi | Yok. Link üretimi ödeme kuruluşunun işidir | iyzico panelinizde ya da e-ticaret sisteminizde |
| CRM'in müşterinin kartından tahsilat çekmesi | Yok. Kart saklama ve tahsilat denemesi ürünün işi değil; kart verisi CRM'e hiç gelmez | iyzico tarafında |
| İade ve iptalin CRM'den başlatılması | Yok. İade iyzico tarafında başlatılır; CRM yalnız sonucunu taşır | iyzico panelinizde |
| iyzico'nun gönderdiği bildirimin kutudan dinlenmesi | Yok. Üründeki webhook giden yöndedir; gelen bildirimi karşılayan taraf kurulumda tanımlanır | Kurulum kapsamında |
| Abonelik ve tekrarlayan tahsilat motoru | Yok. Abonelik, fatura ve ödeme modeli üründe tanımlı değil | Faturalandırma sisteminizde |
| Pazaryeri ve alt üye işyeri hakediş yönetimi | Yok. Bu tarafta üründe tanımlı bir modül bulunmuyor | iyzico tarafında |
| Banka ekstresiyle havale tahsilatının eşleştirilmesi | Yok. Banka, ekstre ve IBAN eşleştirme tarafında ürüne yazılmış kod bulunmuyor | Muhasebe ya da banka tarafınızda |
| Tahsilatın ardından e-Fatura kesilmesi | Yok. Rapitek CRM GİB özel entegratörü değildir ve resmî belge düzenlemez | e-Fatura sağlayıcınızda; bilgisi CRM'e taşınabilir |
iyzico bağlantısı nasıl devreye alınır?
-
1
Keşif
iyzico tarafında hangi ürünü kullandığınızı, tahsilatın hangi kanaldan geldiğini ve verinin bugün kimde durduğunu çıkarırız. Finans ya da muhasebe sorumlunuzun bu görüşmede olmasını öneririz.
-
2
Eşleşme anahtarının seçilmesi
Ödemeyi hangi alanın siparişe bağladığına karar veririz: sipariş numarası, müşteri kodu ya da e-posta. Bu, entegrasyonun en kritik satırıdır ve yazılı kapsamda durur.
-
3
Yöntemin seçilmesi
Olay bazlı akış mı, dönemsel aktarım mı — ve iyzico'nun gönderdiği bildirimi kimin karşılayacağı burada netleşir. Sıklık ve alan eşleme tablosu yazılı paylaşılır.
-
4
Yapılandırma ve test aktarımı
Ödeme alanları, görev kuralları, hatırlatma şablonları ve yetkiler kurulur; örnek bir dönemin tahsilatı test olarak aktarılır. Eşleşmeyen kayıtlar burada görülür, canlıda değil.
-
5
Eğitim ve canlı geçiş
Satış ekibine hangi alanın neyi gösterdiği ve hatırlatmanın hangi izinle gidebileceği anlatılır. Keşiften önce süre taahhüt etmiyoruz; keşif görüşmesinden sonra size aralık değil tarih veririz.
Sınırlarımız: bu sayfada vaat etmediklerimiz
Sayfa bir çekinceyle açıldı; sınırların tamamı da tek yerde dursun.
- “iyzico entegrasyonumuz hazır” demiyoruz. Adaptör ürünün ödeme sağlayıcı kaydında tanımlıdır; canlı bir tahsilat akışını bugün bir müşteri kurulumuyla gösteremiyoruz.
- Kart verisi CRM'e girmez. Kart numarası, CVV ve son kullanma tarihi taşınmaz; bu alanlar üründe hiç açılmaz. Bu bir tercih değil kuraldır ve kapsamın ilk satırına yazılır. Kart verisi bize hiç gelmediği için PCI DSS kapsamına giren bir iş de yapmıyoruz.
- CRM ödeme linki üretmez, tahsilat denemesi yapmaz, iade başlatmaz. Para hareketi iyzico tarafında gerçekleşir; CRM yalnız sonucunu taşır.
- “iyzico webhook'unu kutudan dinliyoruz” demiyoruz. Üründeki webhook giden yöndedir ve imzalıdır; gelen bildirimi karşılayan taraf kurulum kapsamında tanımlanır.
- Abonelik ve tekrarlayan tahsilat motoru vaat etmiyoruz. Abonelik, fatura ve ödeme modeli üründe tanımlı değil.
- Pazaryeri ve alt üye işyeri hakediş yönetimi için modül tanımlamıyoruz. Taşınabilecek şey, ödeme tarafında zaten hesaplanmış tutarların bilgisidir.
- Banka ekstresiyle havale eşleştirme yok. Banka, ekstre ve IBAN eşleştirme tarafında ürüne yazılmış kod bulunmuyor.
- iyzico'nun komisyon ve taksit koşullarını bu sayfaya yazmıyoruz. Güncel koşullar iyzico'nun kendi sayfasındadır; iki yerde farklı bir rakam okumayasınız diye.
- Sipariş → fatura → tahsilat zincirinin kendiliğinden akacağını söylemiyoruz, stok senkronu vaat etmiyoruz ve üretim/MRP otomasyonu vaat etmiyoruz. Üçünün nedenini ve yerine ne yapılabildiğini tek yerde yazdık: vaat etmediğimiz üç şey.
- e-Fatura kesmiyoruz. Ayrıntı e-Fatura sayfamızda.
Ticari ileti: ödeme hatırlatmasının ticari ileti sayılıp sayılmayacağı metnin içeriğine bağlıdır. İYS izin durumu CRM'de kayıtlı tutulur ve iki yönlü senkronlanır; gönderim bu kayıtla birlikte yürür. Hukuki değerlendirme sizin ve danışmanınızındır; biz mekanizmayı kuruyoruz.
Veri konumu: verileriniz Avrupa Birliği'nde tutulur — veritabanı Helsinki'de (Finlandiya), dosyalar Frankfurt'ta, yedekler Falkenstein'da (Almanya). Türkiye'de hiçbir bileşenimiz yok ve bölge seçimi diye bir özelliğimiz yok. Bu, KVKK m.9 kapsamında yurt dışına aktarımdır; dayanağınızı sözleşme sürecinde birlikte kurarız. Ayrıntı güvenlik sayfasında ve KVKK aydınlatma metnindedir.
Sertifika: ISO 27001 veya SOC 2 belgemiz yok ve alana kadar da iddia etmeyeceğiz.
Rakamı bu sayfaya değil, fiyatlandırma sayfasına yazıyoruz
iyzico bağlantısının kapsamı ve varsa bedeli keşif görüşmesinde çıkarılıp yazılı paylaşılır. iyzico'nun kendi komisyonu bizde değil onların sayfasında yazar. Plan fiyatlarını tek yerde tutuyoruz — iki yerde farklı bir rakam okumayasınız diye.
Üç plan, kapsam tablosu ve ayrı fiyatlanan kalemler tek sayfada.
iyzico ve Rapitek CRM hakkında sık sorulanlar
Rapitek CRM'in iyzico entegrasyonu var mı?
“Adaptör tanımlı” ile “entegrasyon hazır” arasındaki fark ne?
Kart bilgisi CRM'e taşınır mı?
Hangi veri hangi yöne akıyor?
CRM'den iyzico ödeme linki gönderebilir miyiz?
iyzico'nun webhook'unu dinliyor musunuz?
Ödeme geçtiğinde CRM'de anında görünür mü?
Ödemeyi siparişle nasıl eşleştiriyorsunuz?
İade ve iptal CRM'de görünür mü?
Taksit ve komisyon bilgisi CRM'e taşınır mı?
Pazaryeri modelimiz var; alt üye işyeri hakedişlerini CRM'de yönetebilir miyiz?
Bağlantıyı bizim geliştiricimiz yazabilir mi?
Bu bağlantının maliyeti nedir?
Kurulum ne kadar sürüyor?
Verilerimiz nerede tutuluyor?
Bu bağlantıyı satın almadan önce görebilir miyiz?
İlgili sayfalar
Entegrasyonlar
Hangi bağlantı bugün üründe çalışıyor, hangisini talep üzerine kuruyoruz — ve vaat etmediğimiz üç şeyin nedeni.
PayTR ve CRM
Aynı soru başka bir ödeme kuruluşu için: gömülü adaptörün olmadığı yerde tahsilat bilgisi satış ekranına nasıl taşınıyor.
Stripe ve CRM
Yurt dışına satan taraf için aynı ayrım: hangi veri hangi yöne akar, kart verisi neden hiç gelmez.
e-Fatura ve CRM
Tahsilattan sonraki soru: belgeyi kim keser, bilgisi CRM'e nasıl gelir, hangi alan üründe hiç yoktur.
Tahsilat akışınızı 30 dakikada netleştirelim
Demoda iyzico tarafında hangi ürünü kullandığınızı, ödemeyi siparişe hangi alanın bağladığını ve ödenmemiş siparişi bugün kimin takip ettiğini kendi senaryonuz üzerinden konuşalım.
Kart verisi CRM'e girmez. Adaptör üründe tanımlı; saha ölçümü yok.
