MOKA ÖDEME SERVİSİ BAYİ İŞLEMLERİ ENTEGRASYON DOKÜMANI

Ebat: px

Şu sayfadan göstermeyi başlat:

Download "MOKA ÖDEME SERVİSİ BAYİ İŞLEMLERİ ENTEGRASYON DOKÜMANI"

Gül Gökçen
5 yıl önce
İzleme sayısı:

1 MOKA ÖDEME SERVİSİ BAYİ İŞLEMLERİ ENTEGRASYON DOKÜMANI V 2.1 MAYIS 2018 Abdullah APAYDIN - Elif YETİMOĞLU Sayfa 1

2 Test Domain: Prod Domain: 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 ResultCode ResultMessage Exception : 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 ve ResultCode alanı Success olarak gelecektir. Data alanı içinde size dönen verileri kullanarak işlem sonucunu yorumlayabilirsiniz. : 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. : Hataya ilişkin özel bir açıklama var ise bu alan dolu olacaktır. : 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. Sayfa 2

3 Her Servis İçin Bayi Tanıma Parametreleri (Authentication) Bayiyi tanımlama için kullanılan alanlardır. Hepsi zorunludur. nesnesi her servisin başında gönderilir. DealerCode (string) * : Moka tarafından bayiye özel verilen kod Username (string) * : Moka tarafından bayiye özel verilen API kullanıcı adı Password (string) * : Moka tarafından bayiye özel verilen API şifresi CheckKey (string) * : Kontrol anahtarı (DealerCode + MK + Username + PD + Password) bilgilerinin String Concatenate edildikten sonra elde edilen String in SHA-256 hash algoritmasından geçirilmesiyle bu alan oluşturulur) Dealer.Check.InvalidRequest Dealer.Check.InvalidAccount 1. Bayi Ekleme (URL : Params: DealerRequest DealerType (integer) : 2: Tüzel Kişi (Ltd.A.Ş), 3 : Tüzel Kişi (Şahıs Firması) TRIdentityNumber (string) : Tc Kimlik Numarası (11 hane), Gerçek kişi için zorunlu IndividualName (string) : Ad Soyad (max 50 chars), Gerçek kişi için zorunlu TaxNumber (string) : Vergi Numarası (10 hane), Tüzel kişi için zorunlu CompanyName (string) : Firma Adı (max 100 chars), Tüzel kişi için zorunlu ContactName (date) : Yetkili Adı (max 50 chars), Tüzel kişi için zorunlu (string) : Bayi adresi (max 100 chars), zorunlu PhoneNumber (string) : Bayi telefon numarası, zorunlu ( formatında) NaceCode (string) : Bayinin vergi levhasında yazan ana faaliyet kodu (6 haneli opsiyonel alan) MokaPosProposalTemplateLimitId (string) : Moka nın size vereceği bir ID dir. Bayinin limitlerinin tanımlanmasını sağlar. MokaPosProposalTemplateRateId (string) : Moka nın size vereceği bir ID dir. Bayinin komisyon oranlarının tanımlanmasını sağlar. Returns: Servisten dönen bu 3 bilgi, Bu bayi adına API den ödeme göndermek için Authentication amaçlı kullanılır. DealerCode (string) : Bayi API kodu Username (string) : Bayi API kullanıcı adı (15 chars) Password (string) : Bayi API şifresi (20 chars) Dealer.Check.InvalidRequest Dealer.CreateDealer.InvalidAccount Dealer.CreateDealer.InvalidDealerType Dealer.CreateDealer.TRIdentityNumberIsRequired Dealer.CreateDealer.InvalidTRIdentityNumber Dealer.CreateDealer.IndividualNameIsRequired Dealer.CreateDealer.TaxNumberIsRequired Dealer.CreateDealer.InvalidTaxNumber Dealer.CreateDealer.CompanyNameIsRequired Dealer.CreateDealer.ContactNameIsRequired Dealer.CreateDealer. IsRequired Dealer.CreateDealer.DealerTypeIsRequired Dealer.CreateDealer.Invalid Format Sayfa 3

4 Dealer.CreateDealer.PhoneNumberIsRequired Dealer.CreateDealer.InvalidNaceCode Dealer.CreateDealer.NaceCodeNotFound Dealer.CreateDealer.MokaPosProposalTemplateLimitIdIsRequired Dealer.CreateDealer.MokaPosProposalTemplateRateIdIsRequired Dealer.CreateDealer.CreateDealerNotAllowed Dealer.CreateDealer.InvalidMokaPosProposalTemplateRateId Dealer.CreateDealer.InvalidMokaPosProposalTemplateLimitId Dealer.CreateDealer.InvalidTemplates Örnek İstek: {"":{"DealerCode":"123","Username":"TestUser","Password":"XXXYSKFM246YGS","CheckKey":"7c 13252ac972c58bc8961aab762382d1120a96755df461b26ff1e25c001c8e8c"},"DealerRequest":{"DealerType":1, "TRIdentityNumber":" ","IndividualName":"Abdullah Apaydin","TaxNumber":"","CompanyName":"", "3","MokaPosProposalTemplateRateId":"1"}} Örnek Başarılı Cevap: {"Data":{"DealerCode":"1475","Username":"09d677f9-355d-4","Password":"55677f2a-68bd-4dbe-8"}, "ResultCode":"Success","ResultMessage":"","Exception":null} Örnek Başarısız Cevap: {"Data":null,"ResultCode":"Dealer.CreateDealer. IsRequired ","ResultMessage":"","Exception":null} 2. Bayi Bilgileri Görme (URL : Params: DealerRequest SubDealerCode (string) : Başarılı olarak çalıştırılmış CreateDealer servisinden dönen sonuç içerisinde size verilen DealerCode alanıdır. Bu kod, alt bayinize ait Moka bayi kodudur. Returns: Servisten alt bayiniz ile ilgili şu bilgiler dönmektedir. DealerId (integer) : Bayinin Moka sistemindeki ID si DealerCode (string) : Bayinin Moka sistemindeki Kodu (API işlemlerinde kullanılır) UserName (string) : Bayinin API kullanıcı adı Password (string) : Bayinin API şifresi DealerName (string) : Bayinin adı DealerType (integer) : Bayinin tipi (1: Gerçek Kişi, 2: Tüzel LTD,AŞ, 3: Şahıs Firması) Title (string) : Bayinin ünvanı ContactName (string) : Bayinin yetkili kişi ismi PhoneNumber (string) : Bayinin veya yetkili kişinin telefonu (string) : Bayinin veya yetkili kişinin adresi IdentityNumber (string) : Yetkili kişinin TC nosu WebSiteURL (string) : Bayinin web adresi NaceCode (string) : Bayinin vergi levhasında yazan ana faaliyet kodu (6 hane) IsThreeDRequired (bool) : Bu bayi için 3D ödeme zorunlu mu? (True, False) DailyTrxAmountLimit (decimal) : Günlük ödeme yapma tutar limiti (TL cinsinden) DailyTrxNumberLimit (integer) : Günlük ödeme yapma adet limiti DailyTrxAmountLimitNon3D (decimal) : Günlük Non-3D ödeme yapma tutar limiti (TL) 3D zorunluysa DailyTrxNumberLimitNon3D (integer) : Günlük Non-3D ödeme yapma adet limiti 3D zorunluysa EachTrxAmountLimit (decimal) : Her bir ödeme işlemi tutar limiti (TL cinsinden) Sayfa 4

5 EachTrxAmountLimitNon3D (decimal) : Her bir Non-3D ödeme işlemi tutar limiti (TL) 3D zorunluysa DailyCardAmountLimit (decimal) : Günlük aynı karttan ödeme yapma tutar limiti (TL cinsinden) DailyCardNumberLimit (integer) : Günlük aynı karttan ödeme yapma adet limiti DailyCardNumberAlertLimit (integer) : Günlük aynı karttan ödeme yapma adet limiti (sadece alarm oluşur) MonthlyTrxAmountLimit (decimal) : Aylık ödeme yapma tutar limiti (TL cinsinden) MonthlyTrxNumberLimit (integer) : Aylık ödeme yapma adet limiti MonthlyTrxAmountLimitNon3D(decimal) : Aylık Non-3D ödeme yapma tutar limiti (TL) 3D zorunluysa MonthlyTrxNumberLimitNon3D(integer) : Aylık Non-3D ödeme yapma adet limiti 3D zorunluysa Dealer.Check.InvalidRequest Dealer.GetDealer.InvalidAccount Dealer.GetDealer.SubDealerCodeRequired Dealer.GetDealer.SubDealerNotFound Dealer.GetDealer.GetDealerNotAllowed Örnek İstek: {"":{"DealerCode":"123","Username":"TestUser","Password":"XXXYSKFM246YGS","CheckKey":"7c 13252ac972c58bc8961aab762382d1120a96755df461b26ff1e25c001c8e8c"},"DealerRequest":{"SubDealerCode": 1787 }} Örnek Başarılı Cevap: {"Data":{"DealerId":1787,"DealerCode":"1787","DealerName":"dfas","UserName":"aaa","Password":"024ff534","Dealer Type":1,"Title":"dfas","ContactName":"dfas","PhoneNumber":" "," ":"adas@moka.com","IdentityNu mber":" ","websiteurl":" rxnumberlimit":10,"dailytrxamountlimitnon3d":0.00,"dailytrxnumberlimitnon3d":0,"eachtrxamountlimit": ,"eachtrxamountlimitnon3d":0.00,"dailycardamountlimit": ,"dailycardnumberlimit":3,"dailycardnumberaler tlimit":3,"monthlytrxamountlimit": ,"monthlytrxnumberlimit":50,"monthlytrxamountlimitnon3d":0.00,"mo nthlytrxnumberlimitnon3d":0},"resultcode":"success","resultmessage":"","exception":null} Örnek Başarısız Cevap: {"Data":null,"ResultCode":"Dealer.GetDealer.SubDealerNotFound","ResultMessage":"","Exception":null} Sayfa 5

Benzer belgeler

MOKA ÖDEME SERVİSİ ÖDEME İSTEĞİ GÖNDERME BAYİ ENTEGRASYON DOKÜMANI

MOKA ÖDEME SERVİSİ ÖDEME İSTEĞİ GÖNDERME BAYİ ENTEGRASYON DOKÜMANI V 1.0 MAYIS 2018 Abdullah APAYDIN - Elif YETİMOĞLU Sayfa 1 Test Domain: https://service.testmoka.com Prod Domain: https://service.moka.com