İptal İşlemi

Servis Adresi

/PaymentDealer/DoVoid

İstek Parametreleri

PaymentDealerAuthentication

Parametre	Açıklama
DealerCode (string)	Moka sistemi tarafından verilen bayi kodu
Username (string)	Moka sistemi tarafından verilen kullanıcı adı
Password (string)	Moka sistemi tarafından verilen şifre
CheckKey (string)	Kontrol anahtarı (DealerCode + "MK" + Username + "PD" + Password) bilgileriyle elde edilen anahtar SHA-256 hash algoritmasından geçirilerek bu alanda gönderilecektir

PaymentDealerRequest

Parametre	Açıklama
VirtualPosOrderId (string)	Ödeme işlemi sonucunda dönen işlem numarası bilgisidir. 3D ödemelerde trxCode ismiyle dönülen numaradır. Key: trxCode Value : ORDER-17131QQFG04026575
ClientIP (string)	Ön Provizyonu kapatan uygulamanın (desktop/web) çalıştırıldığı bilgisayarın IP bilgisi
VoidRefundReason (integer)	İptal İade Sebebi (Dışarıdan yapılan iptaller için değeri 2 olmalı)

Örnek İstek (JSON)


{
	"PaymentDealerAuthentication": {
		"DealerCode": "123456",
		"Username": "ZXCVBNVBN",
		"Password": "abcdef",
		"CheckKey": "ff4a6ee22aeafe87f7930f84b5ce2ad9655bfc6b5e430644a88c5b75a09fdee1"
	},
	"PaymentDealerRequest": {
		"VirtualPosOrderId": "ASDFGZXCVQWERT",
		"ClientIP": "195.155.96.234",
		"VoidRefundReason": 2
	}
}

Başarılı İstek Sonucu

Gönderilen istek verileri Moka’ da başarılı bir şekilde işlenmişse, geri dönüş nesnesinin "ResultCode" alanında "Success" bilgisi yazar. "Data" alanında ise bankadan dönen işlem sonucu bulunur. "Data" içinde yer alan "IsSuccessful" (true/false) alanı kontrol edilerek işlemin durumu kontrol edilir. Bu alanda false dönmesi durumunda aynı nesne içindeki ResultCode ve ResultMessage alanları kontrol edilerek işlemin sanal pos üzerinde neden başarısız olduğu görülebilir.

Başarılı Sonuç Örneği


{
	"Data": {
		"IsSuccessful": true,
		"ResultCode": "00",
		"ResultMessage": ""
	},
	"ResultCode": "Success",
	"ResultMessage": "",
	"Exception": null
}

Başarısız İstek Sonucu

Gönderilen istek verileri Moka’ da başarılı bir şekilde işlenemediyse, geri dönüş nesnesinin "ResultCode" alanında alttaki tablodaki hata kodlarından birisi bulunur. "Data" nesnesi ise null olarak gelir.

ResultCode	Açıklama
PaymentDealer.CheckPaymentDealerAuthentication.InvalidRequest	Hatalı hash bilgisi
PaymentDealer.CheckPaymentDealerAuthentication.InvalidAccount	Böyle bir bayi bulunamadı
PaymentDealer.CheckPaymentDealerAuthentication.VirtualPosNotFound	Bu bayi için sanal pos tanımı yapılmamış
PaymentDealer.DoVoid.PaymentNotFound	İptal edilecek ödeme bulunamadı
EX	Beklenmeyen bir hata oluştu

Başarısız Sonuç Örneği


{
	"Data": null,
	"ResultCode": "PaymentDealer.CheckPaymentDealerAuthentication.InvalidAccount ",
	"ResultMessage": "",
	"Exception": null
}