Yeni İşlem Oluşturma

FORM POST /ServletV2/Transaction

Host: {SERVIS_URL}

Content-Type: text/html

Yeni bir sipariş talebi başlatmak için kullanılan methoddur. Gönderilen veriler doğrulanması durumunda istek HASO URL’sine yönlendirilecektir. customerId parametresi sağlanırsa müşteri tanınacak, doğrulanmış ve limiti bulunan bir müşteriyse HASO arayüzlerinden Taksit Planı adımı ile devam edecektir. Aşağıda Giriş ve Çıkış parametreleri detaylı olarak bulunabilir.

Giriş Parametreleri

Ad	Tipi	Z/O	Açıklama
token	String	Z	/Index/GetToken methodundan elde edilen token bilgisi
orderAmount	String		Gönderilecek değer 100 ile çarpılarak gönderilmelidir ondalık basamak nokta yada virgül içermemelidir. Örn: 500 TL lik bir alışveriş için 500*100 = 50000 değeri gönderilmelidir.
merchantId	String		HASO tarafından verilen sabit parametredir.
okUrl	String	Z	Sipariş başarılı olarak tamamlanırsa HASO Sistemi tarafından FORM POST edilecek URL adresiniz.
failUrl	String	Z	Sipariş başarısız olarak tamamlanırsa ya da iptal edilirse HASO Sistemi tarafından FORM POST edilecek URL adresiniz.
callbackUrl	String	Z	Siparişin başarılı olması ve müşterinin HASO UI ekranlarında tamamlanmış olduğu halde işlemi yarıda bırakması tarayıcısını kapatması gibi durumlarda E-Ticaret sistemine failURL veya okURL dönüşü sağlanamazsa sipariş bildiriminin kesilmemesi için HASO tarafından E-Ticaret sistemine bildirimin sağlanmasını garanti edecek URL.
IpAddress	String	O	İsteği yapan müşterinin gerçek IP Adresi loglama ve herhangi bir sorun durumunda kullanılacak veridir.
merchantOid	String	Z	Sizin tarafınızdan oluşturulan benzersiz olması gereken HASO işlem numarası ile eşleştirilmiş kendi sipariş numaranızdır. Siparişe ait tanımlayıcıdır. Örn: 1905231436-1
customerId	String	O	Her başarılı işlemin sonunda okUrl adresinize POST edilen verilerin içinde tarafınıza dönülecek doğrulanmış müşterilerin tanımlayıcı numarasıdır. Bir sonraki İşlem oluşturma isteklerinde gönderilirse ilgili müşteri HASO tarafından tanınacaktır.
mobileNumber	String	Z	GSM numarası ilk basamağında 0 içermeyen 10 haneli olarak aşağıdaki formatta sağlanmalıdır. Format : ########## örn : 5536616020
birthDate	String		Doğum Tarihi Yıl-Ay-Gün aşağıdaki formatta sağlanmalıdır. Format : yyyy-MM-dd örn : 19830817
email	String	Z	E-Posta adresi
name	String	Z	Ad bilgisi
surname	String	Z	Soyad bilgisi
tckn	String	Z	TCKN bilgisi (Eğer customerId ile geliniyorsa zorunlu değildir)
UserAddress	String	O	Sipariş teslimat adresidir. Opsiyonel olmasına rağmen sipariş sonrası müşteri takibini kolaylaştırdığı için gönderilmesi rica olunur. Gönderilecek modelde şu parametre isimlerinde gönderilmelidir. { "UserNameSurname": "Nilüfer Bursalı", "Detail": "Abc Mahallesi Abc Caddesi Abc Sitesi B Blok D:1", "PostalCode": "16240", "TownName": "NİLÜFER", "CityName": "BURSA", "CountryName": "TÜRKİYE", "Phone": "[phone]" }
OrderItems	String	Z	Sipariş içeriğindeki ürün bilgilerinin gönderileceği modeli json array stringi olarak gönderilmelidir. Örnek modelde göründüğü gibi şu parametre isimlerinde gönderilmelidir. [ { "Id": "1.Ürün Sku kodu unique kod", "Name": "1. Ürün adı", "Category": "1. Ürün kategori adı veya kodu", "Brand": "1.Ürün markası", "Variant": "1. ürün özellik örneğin renk adı", "Variant2": "1. ürün diğer özellik örneğin beden, boy vs", "Url": "Sitenizdeki 1. ürün detay adresi", "Image": "1. ürünü gösteren bir foto adresi", "Quantity": "1. ürün adedi", "Price": "1. ürün tutarı. Ondalık olmadan 100 ile çarparak int gönderilmelidir" }, { "Id": "2.Ürün Sku kodu unique kod", "Name": "2. Ürün adı", "Category": "2. Ürün kategori adı veya kodu", "Brand": "2.Ürün markası", "Variant": "2. ürün özellik örneğin renk adı", "Variant2": "2. ürün diğer özellik örneğin beden, boy vs", "Url": "Sitenizdeki 2. ürün detay adresi", "Image": "2. ürünü gösteren bir foto adresi", "Quantity": "2. ürün adedi", "Price": "2. ürün tutarı. Ondalık olmadan 100 ile çarparak int gönderilmelidir" } ]

Çıkış Parametreleri

Ad	Tipi	Açıklama
OkUrl callbackUrl (callbackUrl tamamlanan sipariş E-Ticaret sisteminden onaylanmaz yada okURL erişimi sağlanamazsa aynı verilerle Http 200 durum kodu alınana kadar E-Ticaret tarafının HASO sistemine çağrı yaparak siparişi onaylayana kadar istek yapılır.)	Form Post	Müşterinin siparişi HASO arayüzlerinde başarılı olarak tamamlanırsa. İstekte belirttiğiniz okURL ya da callbackUrl URL adresine aşağıdaki parametrelerle FORM POST yöntemi ile geri bildirim sağlanacaktır. Geri bildirim içerisinde bulunan veriler şöyledir;
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

Data Parametresinde taksit değerleri vardır. Data parametresi içeriği ise şöyledir;

Ad	Tipi	Açıklama
NameSurname	String	Müşteri Ad Soyad
CustomerId	String	HASO sistemindeki müşteri numarası bir sonraki Transaction işlemlerinde customerId ile bu değer gönderilirse HASO sistemi kullanıcıyı tanıyacak ve limiti varsa Taksit Planı ekranından devam edilecektir.
TransactionStatus	String	İşlemin durum kodu durum kodu 6 olarak tarafınıza dönülen siparişler E-Ticaret tarafından /Index/UpdateTransaction isteği yapılarak aktif edilmesi gereken siparişlerdir.
Data[“TransactionPayments”]	String	İşleme ait ödeme planını içerek json modeldir.

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

Ad	Tipi	Açıklama
TransactionCode	String	HASO sistemindeki işlem numarası. Bu numarayı kendi sipariş numaranız ile birlikte kendi veritabanınızda saklamanızı tavsiye ederiz.
MerchantOid	String	Sizin tarafınızdan oluşturulan benzersiz olması gereken HASO işlem numarası ile eşleştirilmiş kendi sipariş numaranızdır.
Fee	Decimal	Sipariş tutarı haricinde ödenecek toplam ekstra tutardır.
TotalAmount	Decimal	Toplam işlem tutarıdı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	Taksit numarasıdır.
TransactionPayments.PaymentCode	String	Her ödeme kaydı için verilen unique bir değer.
TransactionPayments.InstallmentPayment	Decimal	Ödenmesi gereken taksit tutarıdır.
TransactionPayments.Fee	Decimal	Taksit kaydına düşen fee değeridir.
TransactionPayments.TermDate	DateTime	Taksitin vade tarihidir.
FailUrl	Form Post	Müşterinin siparişi HASO iptal edilirse, istekte belirttiğiniz failURL URL adresine aşağıdaki parametrelerle FORM POST yöntemi ile geri bildirim sağlanacaktır. Geri bildirim içerisinde bulunan veriler şöyledir;
Success
Errors	List	Success=false ise işlem ile ilgili hataları liste şeklinde getirir.
MercantOid	String	İşlem başlangıcında gönderilen Sipariş Numarası