Havuzdaki Ödemeyi Onaylama İşlemi
Servis Adresi
/PaymentDealer/DoApprovePoolPayment
İstek Parametreleri
PaymentDealerAuthentication
Parametre | Açıklama |
---|---|
DealerCode(string) | Moka sistemi tarafından verilen bayi kodu |
Username (string) | Moka sistemi tarafından verilen Api kullanıcı adı |
Password (string) | Moka sistemi tarafından verilen Api şifresi |
CheckKey (string) | Kontrol anahtarı (DealerCode + "MK" + Username + "PD" + Password) String olarak birleştirilen bu bilgilerin SHA-256 hash algoritmasından geçirilmesiyle oluşturulur. Buraya tıklayarak deneme ekranına gidebilirsiniz. |
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 |
OtherTrxCode (string) | Ödeme işlemi gönderirken bayinin kendine ait verdiği Unique işlem numarasıdır. VirtualPosOrderId verilmişse bu numarayı boş gönderebilirsiniz. Ya da kendi Unique numaranızı kullanmak istiyorsanız VirtualPosOrderId alanını boş gönderebilirsiniz. |
Örnek İstek (JSON)
{
"PaymentDealerAuthentication":{
"DealerCode":"xxx",
"Username":"xxx",
"Password":"xxx",
"CheckKey":"ff4a6ee22aeafe87f7930f84b5ce2ad9655bfc6b5e430644a88c5b75a09fdee1"
},
"PaymentDealerRequest":{
"VirtualPosOrderId":" ORDER-17131QMlH04026199",
"OtherTrxCode":""
}
}
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 Moka’ nın size döndüğü işlem bilgileri bulunur. "Data" içinde yer alan "IsSuccessful" alanı true olarak önecektir. "VirtualPosOrderId" alanında ise ödeme işleminin kodu bulunmaktadır.
Başarılı Sonuç Örneği
{
"Data": {
"IsSuccessful": true,
"ResultCode": "",
"ResultMessage": "",
"VirtualPosOrderId": "ORDER-17131QMlH04026199"
},
"ResultCode": "Success",
"ResultMessage": "",
"Exception": null
}
Başarısız İstek Sonucu
Gönderilen istek verileri Moka akışları içerisinde işlenemediyse, geri dönüş nesnesinin "ResultCode" alanında alttaki tablodaki hata kodlarından birisi bulunur.
Beklenmeyen yazılımsal bir hata oluştuğunda ise, "ResultCode" alanında EX yazar ve "ResultMessage" alanında alınan hata mesajı (Exception) yer alır.
Her iki durumda da, "Data" nesnesi null olarak gelir.
ResultCode | Açıklama |
---|---|
PaymentDealer.CheckPaymentDealerAuthentication.InvalidRequest | CheckKey hatalı ya da nesne hatalı ya da JSON bozuk olabilir. |
PaymentDealer.CheckPaymentDealerAuthentication.InvalidAccount | Böyle bir bayi bulunamadı. |
PaymentDealer.CheckPaymentDealerAuthentication.VirtualPosNotFound | Bu bayi için sanal pos tanımı yapılmamış. |
PaymentDealer.DoApprovePoolPayment.OtherTrxCodeOrVirtualPosOrderIdMustGiven | Veriler eksik gönderildi. OrderId veya OtherTrxCode girilmeli. |
PaymentDealer.DoApprovePoolPayment.DealerPaymentNotFound | Girilen bilgilere ait onaylanacak bir ödeme kaydı bulunamadı. |
PaymentDealer.DoApprovePoolPayment.PaymentAlreadyApproved | Bu ödeme zaten onaylanmış. |
PaymentDealer.DoApprovePoolPayment.PaymentIsNotPoolPayment | Bu ödeme havuz ödemesi değil. |
EX | Beklenmeyen bir hata oluştu |
Başarısız Sonuç Örneği
{
"Data": null,
"ResultCode": "PaymentDealer.CheckPaymentDealerAuthentication.InvalidAccount ",
"ResultMessage": "",
"Exception": null
}