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

Last updated