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

Parametre adı	Parametre Tipi	Z/O	Açıklama
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

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.

Data parametresinde işlem listesi vardır. Data parametresi içeriği ise şöyledir:

Parametre adı	Tipi	Açıklama
Data[“Payments”]	array	Müşteriye ait ödeme planını içerek json modeldir.

Payments Model içeriği şöyledir.

Parametre adı	Tipi	Açıklama
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