# Sıkça Sorulan Sorular

1)Ödeme İste API İlke ve Kuralları’na nereden erişebiliriz?

2)Ödeme İste geçiş tarihlerine nereden ulaşabiliriz?

3)Ödeme İste API İlke ve Kuralları dokümanında yapılan değişiklikleri nereden görebiliriz?

4)Ödeme İste Sistemi katılımcısı olmak istiyoruz. Ön koşul var mıdır?

5)Ödeme İste Sistemi katılımcısı olmak için başvuru yapmak istiyoruz. Süreç hakkında bilgi alabilir miyiz?

  • Ödeme İste e-posta adresine (odemeiste@bkm.com.tr) talebinizi iletmeniz beklenmektedir. Talebiniz doğrultusunda sizleri mail üzerinden bilgilendiriyor olacağız. Eğer FAST katılımcısı adayı olup BKM Üyesi değilseniz Ödeme İste e-posta adresine (odemeiste@bkm.com.tr) talebinizi iletmeniz beklenmektedir.

6)Ödeme İste Dokümanlarına, İletişim Listesine ve Simülatörüne erişim için neler yapılması gerekmektedir?

  • Ödeme İste API geliştirmeleri için BKM olarak simülator ortamı sunulmaktadır. Simülatör ortama erişim sağlayabilmek için destek@bkm.com.tr adresine mail atılarak yetki talebinde bulunulmalıdır. Mail atıldıktan sonra sizlere iletilecek formda sarı ile belirtilmiş alanları işaretlemeniz gerekmektedir. Mavi ile işaretli ‘İstemci Sertifikası Talep Ekranı’ ise sadece yetkili kişi tarafından seçilerek gönderilmelidir. Simülatör ortamı sizlere API geliştirmelerinizi test edebilme imkanı sunmaktadır. Bu yüzden form içerisinde kullanacağınız role göre yetki istemelisiniz.

  • Üretim ortamında olan Ödeme İste Katılımcıları için Trip/Tripsit ortamında İletişim Listesi alanı bulunmaktadır. (Trip/Tripsit> BKM Online > Ödeme İste > İletişim Listesi)Bu alana yetki alarak katılımcıların Ödeme İste mail gruplarına erişebildiğiniz gibi sizler de kendi iletişim adresiniz buraya ekleyebilirsiniz.

  • Simülatör için yetki alındıktan sonra Ödeme İste API’ları kullanabilmek için dokümanlar altında Ödeme İste ÖHS BKM Test API Entegrasyon Formu doldurularak odemeiste@bkm.com.tr adresine mail iletilmelidir. BKM tarafından tanımların yapıldığına dair mail dönüşü sağlandıktan sonra Ödeme İste API’ları kullanmaya başlayabilirsiniz. Tanımlar yapılana kadar BKM simülatörü 8000’den 8000’ e işlemler deneyerek API’larını test edebilirsiniz. Tanımlar yapıldığına dair dönüş yapıldıktan sonra erişim sorunu yaşanıyorsa kendi tarafınızdaki firewall talepleri kontrol edilmelidir.

7)Üretim ortamı katılımcılarının iletişim adreslerine nereden ulaşabiliriz?

  • Trip/Tripsit > BKM Online > Ödeme İste > İletişim Listesi altından bulabilirsiniz. Bu menüye erişim sağlayamıyorsanız destek@bkm.com.tr adresinden yetki talep edebilirsiniz.

8)Üretim ortamı katılımcılarının iletişim listesinde kendi kurumuma ait güncelleme yapmam gerekiyor. Nasıl yapabilirim?

  • Trip/Tripsit > BKM Online > Ödeme İste > İletişim Listesi > İletişim Listesi Yönetim menüsünden güncelleme yapılabilir. Bu menüye erişim sağlayamıyorsanız destek@bkm.com.tr adresinden yetki talep edebilirsiniz.

9)İstemci sertifikası talebini nereden yapabiliriz?

  • ‘İstemci Sertifikası Talep Ekranı’ ise sadece yetkili kişi tarafından seçilerek gönderilmelidir. Yetkili kişi Trip/Tripsit > BKM Online > Ödeme İste > Dokümanlar menüsü altından ulaşabilir.

10)Ödeme İste API’lerine ait swagger dosyası bulunmakta mıdır?

  • Evet bulunmaktadır. ÖHVPS > Ödeme İste Simülatörü ekranına gidilerek açılan sayfada istenilen API seçilir ve ‘Swagger Dokümanını İndir’ seçilerek indirebilir.

11)Mesaj imzalama süreçleri nasıl olmalıdır?

12)Sertifikasyona gelmeden önce yapılması gerekenleri paylaşabilir misiniz?

  • Sertifikasyon onayı iletilmeden önce Trip/Tripsit> BOSS > Sertifikasyon Onayı Oluşturma> Sertifikasyon Slot Talebi menüsünden sertifikasyona geleceğiniz tarih için slot alınmalıdır. Aldığınız slot tarihinden en az üç iş günü öncesinde odemeiste@bkm.com.tr’ye mail ile “Ödeme İste ÖHS Sertifikasyon Belgesi Onay İstek Formu”nun iletilmesi gerekmektedir. Sertifikasyon kontrolleri sonrasında sizlere geri bildirimlerde bulunulur. Tüm revizeler tamamlandıktan sonra sertifikasyon onayı verilir ve üretime geçiş için planlama yapılır.

13)Kurum/Kuruluş olarak mobil kanallardan müşterimize hizmet vermemekteyiz. Bu kapsamda sertifikasyonda sadece web akışlarını işletebilir miyiz?

  • Mobil uygulama ile FAST hizmeti sunmayan katılımcılar muaftır. Ancak söz konusu katılımcılar müşterilerine mobil uygulama üzerinden hizmet vermeye başladıktan sonra en geç 6 ay içinde Ödeme İste servisini sunmak zorundadır.

14)Sertifikasyon onay isteği oluşturmak için nasıl bir yol izlemeliyiz?

  • Tüm seritifkasyon süreçleri ile ilgili bilgiler Tripsit>BKM Online> Ödeme İste > Dokümanlar menüsü altında paylaşılmaktadır. Bu süreçle ilgili yine destek alabileceğiniz Tripsit> BOSS> Sertifikasyon Onayı oluşturma menüsü altında sertifikasyon süreci ile ilgili video kaydı bulunmaktadır. Bu alanlardaki belgeleri ve video kayıtlarını inceleyerek destek alabilirsiniz. Simülatör üzerinden sertifikasyon senaryolarının tiklenerek onaya gönderilmesinden sonra Tripsit>BKM Online> Ödeme İste > Dokümanlar menüsü altında bulunan “Ödeme İste ÖHS Sertifikasyon Belgesi Onay İstek Formu”larının odemeiste@bkm.com.tr ye mail olarak iletilmesi gerekmektedir.

15)Sertifikasyon için koşulması gereken senaryolara nereden ulaşabiliriz?

  • Trip/Tripsit > BKM Online > Ödeme İste > Dokümanlar bölümünden ulaşabilirsiniz.

16)Bireysel ve kurumsal için ayrı sertifikasyona gelinebilir mi?

17)Sertifikasyon senaryolarının hepsi koşulmalı mıdır?

  • Trip/Tripsit > BKM Online > Ödeme İste > Dokümanlar menüsü altında yer alan (excel adı) Dokümanında yer almaktadır. Zorunlu olmayan senaryoların muafiyeti mümkündür. Ancak, muafiyet alacağınız senaryolara sertifikasyon ekranında açıklama girilmesi gerekmektedir.

18)Sertifikasyon onay istek formunu ve kontrol listesini nereden bulabiliriz?

  • Sertifikasyon kontrol listesi dokümanına Trip/Tripsit > BKM Online > Ödeme İste > Dokümanlar menüsü altından ulaşabilirsiniz.

19)Sertifikasyon senaryoları koşulurken nelere dikkat edilmelidir? Ekranlar nasıl olmalıdır?

  • Sertifikasyon için https://odemeiste.github.io/ (opens new window) adresinde yayınlanan API İlke ve Kuralları dokümanındaki teknik gereksinimleri yerine getirmeniz beklenmektedir.
  • Web/mobil ekranlar için sertifikasyonda iletilmesi gereken zorunlu alanlar bulunmaktadır. Bu alanlar için Trip/Tripsit > BKM Online > Ödeme İste >Dokümanlar menüsü altında yer alan ‘Kullanıcı Deneyim Dokümanı’nı' inceleyebelirsiniz. Ekranlarda İstenilen şartlar yerine getirildiği sürece ekran tasarımlarını dileğiniz gibi dizayn edebilirsiniz.
    • Ödeme iste talebi oluşturulurken alacaklı ÖHS olarak müşterinize model seçimi yaptırıyor iseniz API dokümanındaki model isimleri ile belirtilmelidir. (Sonra Kabul-Sonra Öde, Sonra Kabul-Hemen Öde) Model isimleri ile ilerlendiğinde açıklama olarak aşağıdaki açıklamalar ile ilerlenebilir.Tavsiye niteliğindedir.
      • Sonra Kabul-Hemen Öde: Ödeme İste talebi belirlenen süre içerisinde kabul edilebilir. Kabul edilen ödeme, kabul edildiği an gerçekleştirilir.
      • Sonra Kabul-Sonra Öde: Ödeme iste talebi belirlenen süre içerisinde kabul edilebilir. Kabul edilen ödeme, sizin talep ettiğiniz zamana kadar borçlu müşteri tarafından seçilen tarihte gerçekleştirilir.
    • Ayrıca mobil/web ekran gösterimleri için ayrı bir form hazırlanmıştır. İlgili formdaki yönergeler izlenerek Sertifikasyon Onay Formu ile birlikte e-posta yoluyla iletilmesi gerekmektedir.
    • Sertifikasyona gelmeden önce ekranlar son kullanıcıya gösterilecek şekilde hazırlanmalıdır.
    • Ekran görüntülerindeki hata mesajlarının müşterinin anlayacağı şekilde ifade edilerek görsellerin düzenlenmesi beklenmektedir.
    • Ekran görüntülerinde yer alan saat ile log kayıtlarındaki saat uyuşmalıdır.

20)Sertifikasyon onay isteği nasıl oluşturabiliriz?

  • Tripsit > Sertifikasyon Onayı Oluşturma > Sertifikasyon Onay İsteği Oluşturma başlığı altından sertifikasyona gelinecek rol için oluşturulmaktadır. Bu süreçle ilgili yine destek alabileceğiniz video kaydı bulunmaktadır.

21)Sertifikasyon onay isteği oluşturdum. Başlatıldı statüsünde kaldı. Yardımcı olabilir misiniz?

  • Sertifikasyon talebinde bulunulduğunda seçilen tarih aralığındaki log kayıtları çekilerek otomatik olarak ‘Çalıştırıldı’ statüsüne geçmektedir. Çalıştırdığınız tarih aralığında log kaydı olup olmadığı kontrol edilmelidir.

22)Sertifikasyon onay isteği oluşturdum. Senaryolar tiklenmedi. Kontrol edebilir misiniz?

  • Sertifikasyon onayı oluşturulduktan sonra ‘Detay’ seçilerek senaryonun neden tiklenmediği ‘Hata Gör’ kolonundan kontrol edilmelidir.

https://odemeiste.github.io/v1.0.0/contents/temel-prensipler.html#_3-1-genel-ilkeler (opens new window)

23)Ödeme İste Sertifikasyon onayı aldım. Üretim ortamına geçiş için neler yapılması gerekir?

  • Üretim ortamına geçmek istediğiniz tarihini öncelikle odemeiste@bkm.com.tr adresine iletilmesi beklenmektedir. Sonrasında paylaşılacak olan güvenli paylaş linki üzerinden Ödeme İste ÖHS BKM Üretim ortamı Entegrasyon Formunun doldurularak iletilmesi beklenmektedir.

24)Geliştirmeler sırasında doküman ile simülatör arasında fark görüldüğünde hangisi doğrudur? Nasıl ilerlemeliyiz?

  • Her zaman Ödeme İste API İlke ve Kuralları dokümanı dikkate alınmalıdır.

25)Ödeme İste talebi yapıldıktan sonra müşteriye bildirim gönderilmesi zorunlu mudur?

  • Ödeme İste Talebinin Yanıtlanması: Borçlu ÖHS, müşterisine Ödeme İste Talebini bildirim aracılığı ya da kendi belirleyeceği metotlar ile yönlendirir. Anlık bildirimler ÖHS tarafından iletilecek SMS ya da push notifikasyon olabilir. Müşterinin iletişim tercihi birincil iletişim kanalı olmak üzere en azından SMS ile bilgilendirme yapılması beklenmektedir.

26)Ödeme iste yapılırken hangi hesap türleri kapsama dahildir?

  • Ödeme İste akışları, Havale veya FAST Sistemi ödemeleri için kullanılabilecektir. Mevcut havale/fast süreçlerinde para transferi gerçekleştirilen TL hesap türleri ile işlem yapılabilmektedir. Ödeme İste için sadece TL transferler gerçekleştirilebilir. FAST sistemi üzerinden yapılacak ödemeler için FAST limitleri geçerli olacaktır.

27)Ödeme İste API kullanımları için ücretlendirme olacak mıdır? Ücretlendirme kapsamında nasıl bir yol haritası izlenecektir?

  • Mevcut durumda ücretlendirme süreci işletilmemekte olup süreç başlatıldığında ücretlendirme ile ilgili detaylar Trip/Tripsit > BKM Online > ÖHVPS> Dokümanlar menüsü altında yer alan Ödeme İste Sistemi Uygulama Kuralları Dokümanında yer alacaktır.

28)Kurumsal müşterilerin mobil/internet bankacılık uygulamalarında farklı onay yapısı bulunmaktadır.(Örn: çoklu onay yapısı) Bu kapsamda Ödeme İste talebindeki Kurumsal müşteri bildirim akışı nasıl olmalıdır?

  • Mevcut durumda müşterilere nasıl bildirim gönderiliyorsa aynı yöntem izlenebilir. (Yetkili kişi ataması yapılabilir vs.) Eğer ödemenin yapılabilmesi için çoklu onaycı mekanizması işletilmesi gerekiyorsa ÖHS’ler bu akış için kendi iç süreçlerini yürütmelidir.

29)Ödeme İste Hizmetini 3.Taraf kullanıcılara API üzerinden açabilir miyiz?

  • Bu konuyla ilgili çalışmalar devam etmektedir. Bu konu netlik kazanınca API dokümanında güncelleme yapılacaktır.

30)Ödeme iste talebi için gönderici ve alıcıya onay&red akışlarında anlık bildirim mu yoksa sms mi gidiyor olmalı? SMS gönderimi zorunlu mudur?

31)Ödeme İste fonksiyonlarını uygulama içerisinde konumlandırırken ana menü isminin "Ödeme İste" olması bir zorunluk mudur?

  • TCMB tarafından yayınlanan “FAST Sistemi Logo ve Marka Kullanım Esasları” belgesinde FAST için ayrı bir menu yapılması ve altında “Ödeme İste” ibaresi olması bekleniyor. Bunun dışında login sonrası kendi mevcut menu itemlerinız altında Ödeme İste’ye özel farklı bir ifade kullanılabilirsiniz. Ancak, hizmetin adının Ödeme İste olması beklenmektedir.

32)Ödeme İste altyapısını kullanarak ön yüzde farklı amaca yönelik farklı bir hizmet sunmamız mümkün mü?

  • Hizmet detaylarının BKM ile paylaşılması ve onay alması durumunda farklı bir hizmet sunma noktasında Ödeme İste altyapısının kullanılması mümkündür ancak öncesinde mutlaka onay alınması gerekmektedir.

33)Müşterilere gönderilen bildirim üzerindeki butonlarla Ödeme İsteği kabul/red'i yapılabilir mi?

  • Müşterilerin ÖHS uygulamalarına login olması ve ödeme detaylarını görerek onay ya da red vermesi tavsiye edilmektedir. Diğer taraftan, ÖHS'lerin risk algısına göre bellirli bir tutar ya da belirli sayıdaki tekrarlı ÖDEME İSTE taleplerine göre değerlendirebilir.

34)Alacaklı ÖHS’lerin, kullanım modellerinden asgari “Sonra Kabul Hemen Öde” modelini Alacaklı’ya sunması zorunlu iken, Borçlu ÖHS için tüm modelleri desteklemesi zorunlu mudur?

35)Sonra Öde modellerinde ödeme iste talepleri talimatlı işlem gibi düşünerek sisteminize kaydedeceğiz. Ödeme iste talebi EFT ile gerçekleştirilebilir mi?

  • Ödeme iste talepleri fast olarak gerçekleştirilmelidir. Kendi tarafınızda talimat olarak kabul edilse bile işlem türü EFT olarak değil FAST olarak gerçekleştirilmelidir.FAST’ın talimat olarak oluşturulması beklenmektedir.

36)Sonra Öde modellerinde borçlu müşteri tarafından kabul edilen ödeme isteği beklenen ödeme tarihinde gerçekleştirildiğinde alacaklı ya da borçlu hesabın kapalı olması, bakiye yetersiz olması durumunda ödeme iste durumu nasıl güncellenmelidir?

  • Ödeme iste talebi borçlu müşteri tarafından kabul edilirken pop-up ile ‘Ödeme iste talebiniz 10.10.2024 tarihinde hesabınızın açık ve bakiyesi yeterli olması durumunda gerçekleştirilecektir.’ Şeklinde bilgilendirme yapılabilir. Sonra öde modellerinde, kabul edilen ödeme iste talebi ödeme sistemine kaydedilir ve beklenen ödeme tarihinde gerçekleştirilir. Ödeme iste gerçekleştirilirken borçlu hesabın kapalı olması ya da bakiyenin yetersiz olması durumunda ise ödeme iste talebi iptal edilir. Borçlu ÖHS, ödeme iste durumunu K statüsünden I durumuna günceller. B ⇨ I / 04.
  • Borçlu ÖHS tarafından FAST ödeme sistemine iletildiğinde alacaklı hesabın kapalı olması durumunda; Alacaklı ÖHS T01 mesajıyla '13: Ret/Alıcı hesabı dondurulmuş/askıda/kapatılmış.' olumsuz sonuç dönülür. Ödeme iste talebi ise '21' : FAST Sistem Hatası' detay kodu ile iptal edilir. K⇨I / 21 edilir. https://odemeiste.github.io/v2.0.0/contents/odeme-iste.html#_7-2-adim-1-odeme-isteginin-olusturulmas%C4%B1 (opens new window)

37)Kabul edilen ödeme iste talebi alacaklı müşteri tarafından iptal edilebilir mi?

38)Kabul edilen ödeme iste talebi borçlu müşteri tarafından iptal edilebilir mi?

  • Kabul edilen ödemesi henüz gerçekleşmemiş ödeme isteği borçlu müşteri tarafından beklenenOdemeTarihi'ne kadar iptal edilebilir.

39)Alacaklı ÖHS olarak müşterimize fonksiyon seçimi yaptırmadan varsayılan E/H değeri gönderebilir miyiz?

  • Evet, gönderebilirsiniz. Örneğin; erken ödeme fonksiyonu alacaklı müşteriye ekranlardan seçim yaptırılmadan API'de varsayılan E olarak gönderilebilir. Üç fonksiyon için ekranlarda değişiklik yapılmadan varsayılan değerler gönderilmek isteniyor ise; Erken Ödeme = E, Kısmi Ödeme = H, Ödeme Erteleme = H ve TEÖZ değeri boş olarak gönderilmesi beklenmektedir.

40)Fonksiyonların birbirleriyle kullamı nasıl olmalıdır?

41)Kısmi ödeme evet olan ödeme iste talebi kabul edilirken minimum tutar gönderme kontrolü var mıdır, bu durum banka kararına mı bırakılmıştır?

  • Borçlu ÖHS insiyatifindedir. 0 TL gönderilemez.

42)Hemen Öde modellerinde fonksiyonların varsayılan değerleri nasıl gönderilmelidir?

  • Erken Ödeme = E ve Ödeme erteleme = H olarak gönderilmelidir. Kısmi ödeme fonksiyonu, Alacaklı müşteriye seçim olarak sunulabilir ya da müşteriye seçim yaptırılmadan ödeme iste talebinde varsayılan H olarak gönderilebilir.

43)"Şimdi Kabul-Hemen Öde" modelini alacaklı ÖHS sunabilir mi?

  • "Şimdi Kabul – Hemen Öde” modeli sadece Öİ Kurumsal API üzerinden başlatılan Ödeme İste talepleri için kullanılabilecektir. Alacaklı ÖHS, Öİ Kurumsal API dışındaki bir kanaldan müşterisine bu modelde Ödeme İste başlatamaz.

44)Sertifikasyon senaryolarına nereden ulaşabilirim? Sertifikasyon senaryoları için nasıl filtreleme yapmam gerekiyor? Tüm senaryoların koşulması gerekiyor mu?

45)Sertifikasyona web/mobil aynı sertifikasyon ID ile gelebilir miyiz?

  • Web ve mobil için ayrı ayrı sertifikasyon iletilmelidir. Aynı sertifikasyon id içerisinde gönderilirse sertifikasyon talebiniz reddedilecektir.

46)Sertifikasyona bireysel/kurumsal ayrı ayrı sertifikasyon ID ile gelebilir miyiz?

  • Hayır tek sertifikasyon içerisinde gönderilmelidir. Ayrı sertifikasyon id içerisinde gönderilirse sertifikasyon talebiniz reddedilecektir. Ancak tek bir müşteri segmenti destekleniyor ise desteklenen müşteri segmenti ile sertifikasyon onayı iletilebilir.

47)Sertifikasyon onay isteği oluştururken "Müşteri/Kanal Seçimi" nasıl olmalıdır?

  • İlk kez sertifikasyona geliniyor ise; Mobil için “Bireysel, Kurumsal, Mobil” seçilmelidir. Web için “Bireysel, Kurumsal, Web” seçilmelidir. S2.0 için sertifikasyona geliniyor ise; mobil için “Bireysel, Kurumsal, Sertifikasyon Güncelleme, Mobil” seçilmelidir. Web için “Bireysel, Kurumsal, Sertifikasyon Güncelleme, Web” seçilmelidir.

48)FAST loglarını nereden kontrol edebiliriz?

  • Ödeme İste simülatörü “Servis Logları” kısmının altında “Fast Logları” yer almaktadır. Bu bölümden inceleyebilirsiniz.

49)Sürüm yönetimi ile ilgili detay bilgi bulamadım. Yardımcı olabilir misiniz?


NOT: Ödeme İste Katılımcıları tarafından sorulmuş teknik soruların cevaplarına Trip/Tripsit > BKM Online > Ödeme İste > Dokümanlar menüsü altında yayınlanan ÖDEME İSTE_Aylık Soru Seti dokümanlarından ulaşabilirsiniz.