5.21. Satıcı Segmenti ile Ödeme planının Getirilmesi

Satıcı segmenti ödeme planındaki işlem ücretini etkiler. Bu sebeple satıcı segmenti ve sipariş tutarı parametreleri ile oluşacak olan taksit planını getirmek için kullanılır.Eğer satıcı segmenti Haso tarafında birden fazla segment ile ilişkili ise en yüksek işlem ücreti çıkacak Haso segmenti oranı ile ödeme planı hesaplanır.

Servis Url: {SERVIS_URL}/Index/GetPaymentPlanByDealerSegment

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)
dealerSegment	String	O	Müşterinin satıcı tarafındaki segmentidir
orderAmount	String	Z	Sipariş tutarı. 100 ile çarparak gönderiniz. Ondalık basamak olmamalıdır.
notCalculateFees	Bool	O	Ekstra ücret hesaplanmaması isteniyorsa true gönderilmeli.
forceRiskFreeEvaluate	Bool	O	true geldiğinde riskli müşterilerden ilk taksiti peşin olarak almayacak şekilde ayarlanır
postponeSelected	Bool	O	Taksitler ertelemeli olarak hesaplanacak ise true gönderilir. False ise taksitlerde erteleme yapılmaz.
RevisedFeeRate	İnt	O	Fee değerinde yapılacak değişikliği belirten değerdir. 100 ile çarparak gönderiniz. Ondalık basamak olmamalıdır. 0 gönderilirse veya gönderilmezse fee değerinde değişiklik yapılmaz. 20 gönderilirse yeni fee değeri orjinal feenin %20’sidir.
requestToken	String	Z	merchantId + ipAddress + dealerSegment + orderAmount + 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.
basketList	List model	O	Sepette bulunan ürünleri aşağıdaki bilgileri gönderilirse erteleme, peşinat, taksit sayısı ve işlem ücreti gibi hesaplamalarda özelleştirme yapılabilir.
basketList.skuCode	String	O	Ürününüzün sku kodudur.
basketList.skudefinitionId	String	O	Ürün grubu kodudur.
basketList.skuAmount	İnt	O	Ürün tutarının 100 ile çarpılmış halidir.
basketList.skuMerchant	String	O	Ürünün satan satıcıya verdiğiniz koddur.
basketList.skuMerchantContributionRate	İnt	O	Taksit planında çıkan fee değerinin ürünün sepetteki oranına göre hangi satıcı ürünü için ne kadar fee olacağı hesaplanabilir. Böylelikle satıcı bazlı fee hesaplanabilir.

Giriş parametreleri Servis Url adresine WebRequest ile post isteği yapılır. İstek sonucunda Json olarak response 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 müşteri limit bilgileri ile taksit değerleri vardır. Data parametresi içeriği ise şöyledir:

Parametre adı	Tipi	Açıklama
Data[“FirstPaymentDate”]	DateTime	İlk ödeme günüdür
Data[“DownPaymentAmount”]	Decimal	Limit aşımı durumunda peşin alınacak tutar değeridir.
Data[“PostponeEnabled”]	Bool	Taksit Erteleme seçilip seçilemeyeceğini belirtir.
Data[“Installments”]	List	Sipariş tutarına göre kaç taksit olacaksa o sayıda item’a sahip bir liste gelir.

Listenin içindeki her bir taksit modeline ait alanlar ise şöyledir.

Parametre adı	Tipi	Açıklama
Installments.InstallmentNo	Int	Kaç taksit olacağını belirten taksit sayısıdır.
Installments.Price	Decimal	Taksit tutarıdır.
Installments.TransactionPrice	Decimal	Sipariş tutarıdır. Ekstra ücretler eklenmiş taksitler ilave olan tutar değildir. Taksitleri getirmek için orderAmount parametresi olarak gönderdiğiniz değerdir.
Installments.TotalAmount	Decimal	Toplam işlem tutarıdır.
Installments.downPayment	Decimal	Taksit kaydı eğer peşin alınacak ise bu tutar ile gösterilir.
Installments.Fee	Decimal	Sipariş tutarı haricinde ödenecek toplam ekstra tutardır.
Installments.originalFee	Decimal	Fee değerinde indirim yapıldığını göstermek için kullanılır. üstü çizili değerdir. İşlem ücreti listelerindeki değerdir.
Installments.feeDiscountCampaigns	List	Fee indirimi uygulanan kampanya adı ve indirim oranlarını listeler
Installments.merchantContributions	List	Requestte basketList parametresinde gönderilen skuMerchantContributionRate değerine göre hangi satıcının ne kadar işlem ücretini karşılayacağı gösterilir.
Installments.merchantContributions.skuCode	string	basketList ile gönderilen sku
Installments.merchantContributions.skuMerchant	string	basketList ile gönderilen merchant kodu
Installments.merchantContributions. skuMerchantContributionAmount	Decimal	Merchant için hesaplanan işlem ücreti katkı bedeli
Installments.PaymentPlan	List	Her taksit değeri için ödeme planını list olarak gösterir. Bu modele ait alt parametreler ise şöyledir.
Installments.PaymentPlan. InstallmentNo	Int	Ödeme planındaki taksit numarasıdır.
Installments.PaymentPlan. installmentPayment	Decimal	Ödeme planındaki taksitin tutarıdır.
Installments.PaymentPlan. termDate	Date	Ödeme planındaki taksidin vade tarihidir.
Installments.PaymentPlan.fee	Decimal	İşlemdeki fee değerinin taksit başına düşen değeri
Installments.PaymentPlan.originalFee	Decimal	İşlemdeki original fee değerinin taksit başına düşen değeri