5.10 Müşteri Ödemelerini Getir
Haso sisteminde tanımlı bir müşterinin onaylanmış ödemelerini istediğiniz zaman bu metod ile alabilirsiniz. İşlemler yeniden eskiye göre sayfalama ile listelenir.
Servis Url: {SERVIS_URL}/Index/GetCustomerPayments
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.
paymentStatuses
List<int>
O
Ödeme durumuna göre filtre yapılmak istenirse kullanılabilir. 0-Ödenmedi, 1-Ödendi, 2-Kısmi Ödeme, 3-Vadesi Geçmiş Ödeme, 4-İptal Edildi
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[“Payments”]
array
Müşteriye ait ödeme planını içerek json modeldir.
Payments Model içeriği şöyledir.
Payments.paymentCode
String
Her ödeme için unique olan ödeme kodu değeridir.
Payments.merchantOid
String
Satıcı sipariş numarasıdır
Payments.InstallmentNo
Integer
Kaçıncı taksit olduğunu belirten değerdir.
Payments.InstallmentPayment
Decimal
Taksit tutarını belirten değerdir.
Payments.TermDate
DateTime
Taksit vade tarihidir.
Payments.PaymentStatus
Int
Taksit durum kodudur.
Payments.PaymentStatusText
String
Taksitin durumunu gösteren string ifadedir
Payments.overdueAmount
Decimal
Taksite ait gecikme ücreti
Payments.overdueRate
Decimal
Taksite ait gecikme oranı
Payments.overdueDate
DateTime
Taksite ait gecikmenin başlayacağı tarih
Payments.totalExpenseAmount
Decimal
İcraya verilen işlem için ktvu ve diğer masraflar toplamının taksite yansıtılan değer