5.5 Ödeme Planını Getir

Haso sisteminde onaylanmış bir işlemin güncel ödeme planını (taksit detaylarını) istediğiniz zaman bu metod ile alabilirsiniz.

İşlem ilk onaylandığında başvuru sonucunda size zaten ödeme planı döner. Gelen ödeme planını kendi sisteminize kaydetmenizi ve müşterinize gerekli gördüğünüz yerlerde kendi sisteminizden göstermenizi tavsiye ederiz. Bu metodun kullanılma amacı ise iptal, iade veya zamanla taksitlerde ödeme yapılması durumunda taksit durumları değişeceği için kendi sisteminizdeki ödeme planı tablonuzu güncellemenizi sağlamaktır.

Servis Url: {SERVIS_URL}/Index/GetPaymentsOfTransaction

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)
requestToken	String	Z	merchantId + merchantOid + transactionCode + ipAddress + merchantSalt parametrelerinden oluşan string parametre sha256 algoritması ve HMAC(http://en.wikipedia.org/wiki/Hashbased_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.
transactionCode	String	Z	Ödeme planını getirmek istediğiniz işlemin Haso sistemindeki işlem numarasıdır. Başvuru sonucunda okUrl’e düşen response parametrelerinde bu değer vardır
merchantOid	String	Z	Haso işlem numarası ile eşleştirilmiş kendi sipariş numaranızdı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 taksit değerleri vardır. Data parametresi içeriği ise şöyledir:

Parametre adı	Tipi	Açıklama
Data[“TransactionPayments”]	String	İşleme ait ödeme planını içerek json modeldir.

Transaction Payments Model içeriği şöyledir.

Parametre adı	Tipi	Açıklama
TransactionCode	String	Request olarak gönderilen transactionCode ile karşılaştırılması için kullanılabilecek bir değerdir.
MerchantOid	String	Request olarak gönderilen merchantOid ile karşılaştırılması için kullanılabilecek bir değerdir.
CustomerId	String	İşlemin sahibi olan müşteriyi tanımlayan unique bir değerdir.
TotalAmount	Decimal	Toplam işlem tutarıdır.
Fee	Decimal	Sipariş tutarı haricinde ödenecek toplam ekstra tutardır.
Downpayment	Decimal	Bu işlem için müşteriden alınması gereken peşinat tutarını gösterir.
TransactionPayments	List	Ödeme planında kaç taksit varsa o kadar item içeren listedir. Listedeki elemanların parametreleri şunlardır.
TransactionPayments.InstallmentNo	Integer	Kaçıncı taksit olduğunu belirten değerdir.
TransactionPayments.InstallmentPayment	Decimal	Taksit tutarını belirten değerdir.
TransactionPayments.TermDate	DateTime	Taksit vade tarihidir.
TransactionPayments.PaymentStatusText	String	Taksitin durumunu gösteren string ifadedir. “Ödendi” vs gibi değerler içerir.
TransactionPayments.PaymentCode	String	Her ödeme kaydı için verilen unique bir değer.
TransactionPayments.Fee	Decimal	Taksit için geçerli ekstra ücrettir.