5.2.3. KKB Rapor Sonucu Kontrolü

Eğer 2. Adım olan Kkb Talebinin Onaylanması servisinden rapor sonucu gelmemiş ise bu servis ile rapor sonucu kontrol edilebilir.

Servis Url: {SERVIS_URL}/RequestV2/AskKkbReportResult

Giriş Parametreleri

Parametre adı
Parametre Tipi
Z/O
Açıklama

merchantId

String

Z

Haso tarafından size verilen sabit parametredir.

ipAddress

String

O

İstek yapan istemcinin ip adresi. (Önemli: Lokal makinenizde yapacağınız denemelerde mutlaka dış IP adresini gönderdiğinizden emin olun)

kkbRefNo

String

Z

İkinci adımda dönen referans no bilgisidir.

testResult

String

O

Eğer 1. Adımda testOn=true gönderilmişse bu parametre ile istenen Kkb sonucu belirtilir. testResult dolu ise PinCode parametresinine herhangi bir değer verilebilir. testResult in (“A”,”B”,”C,”D”,”E”,”F”) gönderilirse sonuç başarılı ve bir limit değeri döner. E ve F için limit=0’dır. testResult=”RETRY” gönderilirse Kkb raporu henüz olaylanmamış tekrar deneyiniz gibi response döner.

requestToken

String

Z

merchantId + ipAddress + kkbRefNo + merhant_salt parametreleri ile sha256 algoritması ve HMAC(http://en.wikipedia.org/wiki/Hash-based_message_authentication_code) yöntemi ile şifreleyerek token oluşturur. Sonrasında token'ı base64 hale dönüştürür. token oluşturma için örnek kodlarımızı inceleyiniz.

Giriş parametreleri Servis Url adresine WebRequest ile post isteği yapılır. İstek sonucunda Json olarak response döner.

Onaylanan Kkb talebinin raporunun oluşturulup oluşturulmadığı kontrol edilir. Eğer kkb rapor sonucunu dönerse müşterinin limiti sonucu belli olur. Eğer reddedildiyse Success=false ile hata olarak response gelir. Reddedilmediyse rapor sonucu analiz edilerek müşterinin limiti oluşturulur. Eğer kkbden rapor sonucu gelmez ise müşterinin limiti bu anda belirlenemez. Sistem tarafından belli aralıklarla rapor sonucu sorgulanacak ve rapor oluştuğu anda müşteri limiti sisteme kaydedilecektir. Bu servis ile dilerseniz manuel olarak rapor sonucunu tekrar kontrol edebilirsiniz.

Çıkış Parametreleri

Parametre adı
Tipi
Açıklama

Success

bool

Yapılan isteğin başarılı sonuç dönüp dönmediğini bildirir. False dönerse Errors parametresi doludur. True dönerse Data parametresi doludur.

Errors

List<string>

Success=false ise işlem ile ilgili hataları liste şeklinde getirir.

Data

Dictionary<string, object>

Eğer success=true ise key-value şeklinde data döner.

Rapor sonucu belli olmamışsa bu adımda tekrar kullanılmak üzere KkbRefNo ve durumu belirten Message değerleri Data içinde yer alır.

Parametre adı
Tipi
Açıklama

Data[“KkbRefNo”]

String

  1. adımda request olarak kullanılacaktır.

Data[“Message”]

String

M101 kodu ile 3.adımın tekrar çağrılabileceği belirtilir.

Büyük olasılıkla rapor oluşacaktır. Bu durumda CustomerId ve güncel limit bilgisini içeren CustomerInfo model döner.

Parametre adı
Tipi
Açıklama

Data[“CustomerInfo”]

Model

GetCustomerInformation endpointinde de bulunan response modeldir.