5.3. Yeni İşlem Oluşturma

Yeni bir işlem oluşturmak için lütfen aşağıdaki parametleri inceleyiniz.

Servis Url: {SERVIS_URL}/ServletV2/TransactionMobile

Giriş Parametreleri

Parametre adı	Parametre Tipi	Z/O	Açıklama
Token	String
merchantId	String	Z	Haso tarafından size verilen sabit parametredir.
okUrl	String		Sipariş başarılı olarak tamamlanırsa HASO Sistemi tarafından FORM POST edilecek URL adresiniz.
failUrl	String		Sipariş başarısız olarak tamamlanırsa ya da iptal edilirse HASO Sistemi tarafından FORM POST edilecek URL adresiniz.
callbackUrl	String		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	İstek yapan istemcinin ip adresi
merchantOid	String(20)	Z	Kendi sisteminizde oluşturduğunuz sipariş için unique verdiğiniz sipariş numaranızdır.
qrhash	String	O	Mobil uygulamadan oluşturulan QR kod içerisinde bulunan şifreli müşteri bilgileri. QR okutularak müşteri bilgileri elde etme, elde edilen bu değer gönderilir. Oluşturulan her QR kod 10 dakika geçerlidir. CustomerID verisi bu değer üzerinden okunacaktır.
branchId	String(20)	O	Siparişin verildiği şubenin (Mağazanın) Id numarası. Sipariş raporlarında hangi mağazadan verildiğini belirtir.
customerId	String(10)	Z	Haso sisteminde müşterinin sahip olduğu unique değerdir. Limit tanımında size gönderilmişti. Not: qrhash parametresi gönderilirse zorunlu değildir. Ancak yine de gönderilebilir fakat qrhash içerisindeki customerID verisi dikkate alınacaktır.
orderAmount	String	Z	Sipariş tutarı. 100 ile çarparak gönderiniz. Ondalık basamak olmamalıdır.
OrderItems	Json	O	Sipariş içeriğindeki ürün bilgilerinin key-value şeklinde json array stringi olarak hazırlanmasıdır. Json demetinde olması beklenen key değerleri şunlardır. “id”: sisteminizde her bir ürün için verilmiş unique kod. “name”: Ürün adı “category”: Ürün kategorisi “brand”: ürünün marka bilgisi “variant”: Renk gibi ürüne ait bir variant değeri “variant2”: Beden/size gibi ürüne ait diğer varyant “url”: Sitenizdeki ilgili ürünün detay urlsi. “image”: Sitenizdeki ilgili ürünün görsel urlsi. “quantity”: İlgili üründen kaç adet alındığı bilgisidir. “price”: Ürünün satış fiyatı

Çıkış Parametreleri

Parametre adı	Tipi	Açıklama
Success	bool	işlemin başarılı sonuç dönüp dönmediğini bildirir. False dönerse Errors parametresi doludur. True dönerse ödeme planını kendi veritabanınıza kaydedebilir ve siparişinizi aktif edebilirsiniz.
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.
expiredate	Datetime	Başlatılan işlemin sona erme süresi
customerID	String	İşlemi oluşturulan Müşteri numarası
checkoutkey	String	Her işlem için belirlenen benzersiz guid değeri (Kendi tarafınızda saklamanızı öneririz)

OkUrl, FailUrl, CallbackUrl dönüş parametreleri

Parametre 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.
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.
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	Taksit numarasıdır.
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.
FailUr	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ı