TR Karekod ile Ödeme yapmak istediğimde hata alıyorum neden olabilir?

Ödeme ya da Nakit çekim işlemlerinde TR Karekod üretme fonksiyonu POS ya da ATMlerdedir.

Kart Issue eden (çıkaran) bankanın görevi ise POS ya da ATMlerden üretilen TR Karekod formatındaki kodu okuyabilecek ve aksiyon alabilecek şekilde sistemini oluşturmaktır.

TR Krekod ile ödemelerde 2 farklı karekod formatı kullanılmaktadır.

1. Kısa Karekod
2. Uzun Karekod

QR kod okuması kart çıkaran kuruluş tarafından sunulan mobil uygulama/cüzdan tarafından yapılır.

İlgili uygulamanın QR ı okuduğunda uzun QR mı yoksa kısa QR mı olduğuna karar verip (genellikle kararı backend sistemler verip uygulamaya iletir.) BKMnin servislerini ona göre çağırması gerekmektedir.

Kısa QR sürecinde uzun QRa göre QR doğrulama adımı için BKM’den teyit alınması, daha sonra QR ile ödeme akışını işletmesi gerekmektedir.

Genellikle bu adımların doğru işletilmemesi entegrasyonlarda hata alınmasına neden olabilir.

Aşağıda BKM’nin uzun karekod ve kısa karekod ile ödeme akışını paylaşıyorum:

İlgili dokümanın linki:

https://www.tcmb.gov.tr/wps/wcm/connect/ec9fb83b-6e4c-479f-ac69-a11ba3f0c558/BKM_TR_Karekod_Rehberi.pdf?MOD=AJPERES&CACHEID=ROOTWORKSPACE-ec9fb83b-6e4c-479f-ac69-a11ba3f0c558-o3gOR1s

5.1.1 POS’tan BKM Uzun Karekod Formatı Üretilerek Başlayan Ödeme Akışı

Şekil 1’de, işyeri tarafından sunulan BKM UKF kullanımına ilişkin kartla ödeme iş akışı gösterilmektedir.

Şekil 1: BKM UKF’nin Kart Çıkaran Kuruluşun Mobil Uygulaması ile Okutulması ile Başlayan Ödeme Akışı

İşlem tutarının işyeri tarafından belirlendiği akış adımları:

1. Terminalde işlem tutarı belirlenerek karekod oluşturma işlemi başlatılır.
2. Terminal BKM UKF yapısına uygun olarak ödeme detaylarını içeren karekodu üretir.
3. Kart hamili, mobil uygulaması aracılığı ile terminalde oluşan karekodu okur. Karekoddan alınan işlem verilerindeki işlem tutarı ve işyeri ismi uygulamada görüntülenir.
4. Kart hamili işlem için kullanacağı kartı mobil uygulamadan seçer.

BKM (Kartlı Ödemeler) TR Karekod Teknik İlke ve Kuralları Rehberi 1.1.

5. Kart hamilinin seçtiği kartın kart numarası, son kullanma tarihi, müşterinin doğrulanma yöntemi (CVM tipi), elektronik ticaret göstergeci (ECI değeri) ve POS terminalinden okunan karekod değeri Kart Çıkaran Kuruluş tarafından KYS’ye iletilir. Bu veriler Kart Çıkaran Kuruluş ile KYS arasındaki AES anahtarı ile şifrelenir.
6. KYS, gelen kart bilgileri ve karekod değeri içindeki verileri Kart Kabul Eden Kuruluş’a ait AES anahtarı altında şifreleyerek Kart Kabul Eden Kuruluş’a yönlendirir.
7. Terminal, gelen verilerle otorizasyon mesajı oluşturarak işlemi Kart Kabul Eden Kuruluş’un sistemine yönlendirir. Eğer Kart Çıkaran Kuruluş, müşterinin doğrulanma yöntemi (CVM) tipi olarak PIN istemişse, kart hamilinden PIN ister ve otorizasyon mesajına PIN blok verisini de ekler.
8. Kart Kabul Eden Kuruluş, terminalden gelen talebe istinaden işlemi BKM Yönlendirme Sistemi’ne iletir.
9. BKM Yönlendirme Sistemi, işlemi Kart Çıkaran Kuruluş’a yönlendirir.
10. Kart Çıkaran Kuruluş, otorizasyon cevabı vermenin yanı sıra, onay veya ret bilgisini karekod işlemini başlatan mobil uygulamaya da bildirim olarak iletir.
11. BKM üzerinden gelen otorizasyon cevabına uygun olarak terminal işlemi tamamlar.

5.1.2 POS’tan BKM Kısa Karekod Formatı Üretilerek Başlayan Ödeme Akışı

Şekil 2’de, işyeri tarafından sunulan BKM KKF kullanımına ilişkin kartla ödeme iş akışı gösterilmektedir.

Şekil 2: BKM KKF’nin Kart Çıkaran Kuruluşun Mobil Uygulaması ile Okutulması ile Başlayan Ödeme Akışı

İşlem tutarının işyeri tarafından belirlendiği akış adımları:

1. Terminalde işlem tutarı belirlenerek karekod oluşturma işlemi başlatılır.
2. Terminal, BKM KKF yapısına uygun olarak ödeme detaylarını içeren karekodu üretir.
3. Kart hamili mobil uygulaması aracılığı ile terminalde oluşan KKF karekodu okur.
4. Mobil uygulama tarafından okunan kısa karekod değeri Kart Çıkaran Kuruluş sistemine iletilir.
5. Kart Çıkaran Kuruluş, KKF değerini KYS’ye iletir.
6. KYS, gelen karekod içeriğini Kart Kabul Eden Kuruluş’a yönlendirir.
7. Kart Kabul Eden Kuruluş, KKF karekoda ilişkin işleme ait verileri KYS’ye döner.
8. KYS, Kart Kabul Eden Kuruluş’tan gelen karekod bilgilerini Kart Çıkaran Kuruluş’a yönlendirir.

BKM (Kartlı Ödemeler) TR Karekod Teknik İlke ve Kuralları Rehberi 1.1.

9. Kart Çıkaran Kuruluş, mobil uygulamasında işlem bilgilerini görüntüler. Kart hamili işlem için kullanacağı kartı seçer.
10. Kart hamilinin seçtiği kart, son kullanma tarihi, müşterinin doğrulanma yöntemi (CVM tipi), Elektronik ticaret göstergeci (ECI) ve terminalden okunan karekod değeri Kart Çıkaran Kuruluş tarafından KYS’ye iletilir. Bu veriler Kart Çıkaran Kuruluş ile KYS arasındaki AES anahtarı ile şifrelenir.
11. KYS, gelen kart ve karekod değeri içindeki verileri Kart Kabul Eden Kuruluş’a, Kart Kabul Eden Kuruluş’a ait AES anahtarı altında şifreleyerek yönlendirir.
12. Terminal, gelen verilerle otorizasyon mesajı oluşturarak Kart Kabul Eden Kuruluş sistemine yönlendirir. Eğer Kart Çıkaran Kuruluş, müşterinin doğrulanma yöntemi (CVM tipi) olarak PIN istemişse terminal kart hamilinden PIN ister ve otorizasyon mesajına PIN blok verisini de ekler.
13. Kart Kabul Eden Kuruluş, işlemi BKM Yönlendirme Sistemi’ne yönlendirir.
14. BKM Yönlendirme Sistemi, işlemi Kart Çıkaran Kuruluş’a yönlendirir.
15. Kart Çıkaran Kuruluş, onay veya ret bilgisini karekod işlemini başlatan mobil uygulamaya bildirim olarak iletir.
16. BKM üzerinden gelen otorizasyon cevabına uygun olarak terminalde işlem tamamlanır.