Genel Bilgiler
Bakiyem.com ile ödeme alma, ödeme isteği gönderme, kart saklama servisleri ve tekrarlayan ödeme servisleri ile ödemelerinizi alabilirsiniz. Örnek projeler sayesinde Bakiyem.com servislerine çok daha kolay bir şekilde entegre olabilirsiniz.
Başlarken
Test Ortamı Adresi
https://service.testmoka.com
Gerçek Ortam Adresi
https://service.moka.com
Önemli Bilgiler
Servislerin Çağrılması
Moka servisleri JSON – POST yöntemiyle çalışmaktadır. Aşağıda her bir servis için verilen servis adresleri test ya da prod domain’lerin sonuna eklenerek oluşan URL’e, yine aşağıda her bir servis için detaylı bir şekilde örnekleriyle verilen parametreler JSON nesnesi olarak POST edilir.
Servislerden Yanıt Alınması
Moka servisleri yanıt olarak ApiResponse nesnesi döner. Bu nesnenin “ResultCode” ve “Data” alanları okunarak akışlar yönetilebilir.
ApiResponse
Data | Gönderdiğiniz istek Moka’ ya doğru bir şekilde iletilmiş, kullanıcı bilgileri doğru bir şekilde girilmiş ve girilen bilgiler Moka tarafında herhangi bir uyarıya veya hataya yol açmamışsa, Data alanı dolu gelecektir. Data alanı içinde size dönen verileri kullanarak işlem sonucunu yorumlayabilirsiniz. |
ResultCode | Gönderilen veriler Moka tarafında bir uyarıya veya hataya yol açmışsa, Data alanı null olarak gelecektir ve ResultCode alanında Moka hata kodu yer alacaktır. |
ResultMessage | Hataya ilişkin özel bir açıklama var ise bu alan dolu olacaktır. |
Exception | Beklenmedik bir hata oluştuğunda ResultCode alanında EX yazacaktır ve Exception alanında alınan hatanın açıklaması yer alacaktır. |
CheckKey Oluşturma
Kontrol anahtarı (DealerCode + "MK" + Username + "PD" + Password) bilgileriyle elde edilen anahtar SHA-256 hash algoritmasından geçirilerek bu alanda gönderilecektir