5.9 Müşteri İşlemlerini Getir
Haso sisteminde tanımlı bir müşterinin onaylanmış işlemlerinin güncel ödeme planını (taksit detaylarını) istediğiniz zaman bu metod ile alabilirsiniz. İşlemler yeniden eskiye göre sayfalama ile listelenir.
Servis Url: {SERVIS_URL}/Index/GetCustomerTransactions
Giriş Parametreleri
merchantId
String
Z
Haso tarafından size verilen sabit parametredir.
customerId
String(10)
Z
Haso sisteminde müşterinin sahip olduğu unique değerdir. Limit tanımında size gönderilmişti.
ipAddress
String
O
İstek yapan istemcinin ip adresi. (Önemli: Lokal makinenizde yapacağınız denemelerde mutlaka dış IP adresini gönderdiğinizden emin olun)
requestToken
String
Z
merchantId + customerId + ipAddress + merchantSalt parametrelerinden oluşan string parametre 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. Örnek token oluşturma için örnek kodlarımızı inceleyiniz.
transactionCodes
List<String>
O
Müşterinin bazı işlemlerinin ödeme planını almak isterseniz transactionCode değerlerini array olarak gönderebilirsiniz.
pageNo
Int
O
Geçerli sayfa numarasıdır. Gönderilmezse varsayılan 1 kabul edilir.
pageSize
Int
O
Bir sayfada kaç adet işlem gelmesini istiyorsanız bu parametreyi kullanabilirsiniz. Gönderilmezse varsayılan 50 değerini alır.
Giriş parametreleri Servis Url adresine WebRequest ile post isteği yapılır. İstek sonucunda Json olarak çıkış döner.
Çıkış Parametreleri
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.
Data parametresinde işlem listesi vardır. Data parametresi içeriği ise şöyledir:
Data[“Transactions”]
String
İşleme ait ödeme planını içerek json modeldir.
Transactions Model içeriği şöyledir.
Transactions.TransactionCode
String
Her işlem için unique olan işlem kodu değeridir.
Transactions.MerchantOid
String
Eticaret lokal sipariş numarasıdır.
Transactions.CustomerId
String
İşlemin sahibi olan müşteriyi tanımlayan unique bir değerdir.
Transactions.TotalAmount
Decimal
Toplam işlem tutarıdır.
Transactions.Fee
Decimal
Sipariş tutarı haricinde ödenecek toplam ekstra tutardır.
Transactions.counterPartyAttorneyFee
Decimal
İcraya verilen işlem için KYVU değeri
Transactions.expenseAmount
decimal
İcraya verilen işlem için masraf değeri
Transactions.transactionStatus
Int
İşlemin durumun bildiren durum kodudur.
Transactions.transactionStatusText
Int
İşlem durumunun açıklamasıdır.
Transactions.TransactionPayments
List
Ödeme planında kaç taksit varsa o kadar item içeren listedir. Listedeki elemanların parametreleri şunlardır.
Transactions.TransactionPayments.InstallmentNo
Integer
Kaçıncı taksit olduğunu belirten değerdir.
Transactions.TransactionPayments.InstallmentPayment
Decimal
Taksit tutarını belirten değerdir.
Transactions.TransactionPayments.TermDate
DateTime
Taksit vade tarihidir.
Transactions.TransactionPayments.PaymentStatus
Int
Taksit durum kodudur.
Transactions.TransactionPayments.PaymentStatusText
String
Taksitin durumunu gösteren string ifadedir
Transactions.TransactionPayments.PaymentCode
String
Her ödeme kaydı için verilen unique bir değer.
Transactions.TransactionPayments.totalExpenseAmount
Decimal
İcraya verilen işlem için ktvu ve diğer masraflar toplamının taksite yansıtılan değer