MOKA ÖDEME SERVİSİ KART SAKLAMA VE TEKRARLI İŞLEM BAYİ ENTEGRASYON DOKÜMANI

Transkript

1 MOKA ÖDEME SERVİSİ KART SAKLAMA VE TEKRARLI İŞLEM BAYİ ENTEGRASYON DOKÜMANI V 1.6 MART 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. ÖNEMLİ!!! Servislerimiz PCI-DSS kuralları gereği sadece TLS 1.1 ve TLS 1.2 protokollerinin kullanımına izin vermektedir. Lütfen uygulamanızın bu protokoller üzerinden Moka URL sine POST attığından emin olunuz. Aksi taktirde Bağlantı kapatılacaktır veya Connection Closed şeklinde hatalar alınacaktır. 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 KART SAKLAMA VE TEKRARLI ÖDEME AKIŞI A. Bayilerimiz, Moka üzerinde kendi müşterilerinin kartlarını saklayabilirler ve bu kartlardan 3D veya Non-3D olarak, istedikleri zaman çekim yapabilirler. B. Bunun haricinde, düzenli çekim yapmayı Moka da üstlenebilir. Düzenli-Tekrarlı çekim (Recurring Payment), Moka tarafından sadece Non-3D olarak yapılır. A. Kart Saklamak ve saklı karttan ödeme yapmak için sırasıyla : Önce müşteri eklenir (AddCustomer servisimiz ile) Bu müşteriye kart eklenir (AddCard servisimiz ile). Moka, eklenen kart sonucunda Token döner ve bayi bu Token ı kendinde kaydeder. Müşteriyi ve kartı aynı anda tek bir servis ile de ekleyebilir. (AddCustomerWithCard servisimiz ile) Bayi, dilediği zamana normal ödeme servislerimizi (DoDirectPayment veya DoDirectPaymentThreeD) kullanarak Token üzerinden (kart bilgisi göndermeden) ödeme gönderebilir. B. Tekrarlı ödemeler için sırasıyla : Yukarıdaki gibi, Müşteri ve Kart eklenir. (AddCustomer ve AddCard veya AddCustomerWithCard servislerimiz ile) Bayinin, satışını yapacağı ürünler eklenir. (AddProduct servisimiz ile) Ödeme çekimlerinin ne zamanlar yapılacağını gösterir Zaman Programları eklenir. günlük, haftalık, aylık vs.- (AddSchedule servisimiz ile). Müşteriye satış yapılır. (AddSale servisimiz ile) - Böylelikle hangi müşteriye (Customer), hangi ürün (Product) satıldı, hangi karttan (Card) ne sıklıkta (schedule), ne kadarlık ödeme çekimleri yapılacak bilgisi verilmiş olur. Yapılan satışın ödeme tarihleri geldiğinde, Moka sistemi otomatik olarak bir ödeme çekim adımı oluşturacak (PaymentPlan) ve satışta tanımlanmış karttan çekimi yapacaktır. Günde 2 defa çekim denenecek (öğlen 12 ve akşam 18 de), ve kaç gün boyunca (HowManyTrial) çekim denenmesi istendiği de AddSale servisimiz ile satış oluştururken verilecektir. Bu çekimlerin detayları da PaymentPlanHistory olarak tutulacaktır. Dolayısıyla bir ödeme adımı için, birden fazla History kaydı oluşabilir. Örn : ilk deneme başarısız, sonraki deneme başarılı olduğunda 2 adet History kaydı oluşur. Bayi, dilerse, manuel olarak da araya ödeme planları ekleyebilir. Veya Moka, otomatik olarak ödeme planı eklemesin, bütün planları ben ekleyeceğim diyebilir. (AddPaymentPlan servisimiz ile) Bayi, istediği anda, tek bir satışın ödeme adımlarının listesini (GetPaymentPlanList), bütün satışlarının ödeme adımlarının raporunu (GetPaymentPlanReport) veya ödeme adımlarına ait tarihçelerin listesini (GetPaymentPlanHistoryList) yine servislerimiz aracılığıyla çekebilir. Diğer bir seçenek olarak da, her bir ödeme çekimi denemesi yapıldığında (saat 12 ve 18 de), bayinin Moka ya daha önceden bildirmiş olduğu URL ye (RecurringReturnURL), çekimle ilgili alanlar POST atılabilir. URL ye atılan POST içinde şu alanlar yer alır : HashInfo: DealerCode + Username + Password + PostToken alanları birleştirilip SHA256 ile hash lenir ve HashInfo alanıyla kıyaslanır. Aynıysa, bu POST, Moka dan gelmiş demektir. PostToken: Her bir çekim denemesi için Moka nın ürettiği GUID değerdir. Hash elde ederken kullanılır. (yukarıdaki formül ile) DealerCustomerId: Çekim yapılan müşterinin Moka sisteminde tanımlı olduğu ID dir. CustomerCode: Çekim yapılan müşterinin Bayinin kendi sisteminde tanımlı olduğu koddur. DealerSaleId: Çekimi yapılan satışın Moka sisteminde tanımlı olduğu ID dir. SaleCode: Çekimi yapılan satışın Bayinin kendi sisteminde tanımlı olduğu koddur. Sayfa 3

4 DealerPaymentPlanId: Satışa ilişkin ödeme adımı ID sidir. Ödeme adımları satışta verilen zaman programına göre oluşurlar. (günlük, haftalık veya aylık). Ayrıca dilenirse manuel ödeme adımları da eklenebilir. Bu ödeme adımı için birden fazla çekim denemesi yapılabilir. ilk çekim denemesi başarısız olursa, ikinci deneme yapılır. Satış yapılırken verilen her bir kart için (en fazla 3 adet kart verilebilir), deneme yapılır ve her deneme için POST atılır. DealerPaymentPlanHistoryId: Ödeme adımına istinaden yapılan her bir çekim denemesinin tarihçe ID sidir. Bir ödeme adımı için (DealerPaymentPlanId), birden fazla (DealerPaymentPlanHistoryId) oluşabilir. DealerPaymentId: Çekim denemesi sonucu oluşan Ödeme ID sidir. Moka bayi panelinden bu ID ile ödeme detaylarını görebilirsiniz. Amount: Kartan çekilen tutardır. HistoryStatus: Çekim denemesinin sonucudur. (0 : Başarısız, 1 : Başarılı) OTOMATİK ÖDEME ADIMI OLUŞUMU VE MANUEL ÖDEME ADIMI EKLEME Bayi, satışı yaparken (AddSale), otomatik plan oluştur derse (PlanType:1), o satışa ilişkin bir ödeme günü geldiğinde, Moka sistemi, otomatik olarak bir ödeme adımı (DealerPaymentPlan) oluşturur. Örneğin, X müşterisinden her ayın 5 inde 200 TL çekecek şekilde bir satış yapılabilir. Bu durumda, zaman programını (DealerSchedule) her ayın 5 inde olacak şekilde düzenlenmesi yeterlidir. (Tabi önceden müşteri (AddCustomer) ve ürünün de (AddProduct) tanıtılmış gerekiyor). Bayi satışı yapıp, otomatik ödeme planı oluştur (PlanType:1) dediği anda, o ayın 5 i geldiğinde, sabah, Moka sistemi, otomatik olarak bu satışa ait bir ödeme yapılacak diye bir Ödeme adımı (DealerPaymentPlan) kaydı atar ve gün içinde 2 kez (Saat 12 ve 18 de) bu ödeme adımını gerçekleştirmeye çalışır. Bu ödeme adımına ait tarihçeler (DealerPaymentPlanHistory) oluşmaya başlar. İlk denemede başarısız olsa bile diyelim ki ikinci denemede başarılı oldu. Tarihçede, o ödeme adımı için 2 adet kayıt oluşmuş olur. Hangi aralıkta (günlük, haftalık veya aylık), ne tutarda para çekileceği belliyse, satış eklerken, Otomatik ödeme planı oluşacak diye işaretlemek yeterli olacaktır. Ancak, arada, duruma göre başka bir ödeme daha alayım, tutarı da farklı olsun denirse, o zaman otomatiğin yanında manuel olarak da ödeme adımı eklemek istiyorum diye işaretlenmesi gerekmektedir (PlanType:3). Bu durumda, bayi de bu satış altında, dilediği tarih ve tutarda ödeme isteği emri (ödeme adımı) eklemiş olur. Manuel olarak eklenen ödeme adımının tarihi geldiğinde, bu talep gereği de ödeme karttan çekilir. Otomatik çekimler de bir yandan devam eder. Yani manuel ödeme, bayiye, dilediği tarihte, dilediği tutarda ödeme eklemesine olanak sağlar. (bir çeşit esnek ara ödeme seçeneği gibi düşünülebilir). Bayiler, manuel ödemeyi kullanmak zorunda değiller. Bazı durumlarda ise, bayi, otomatik olarak ödeme adımı oluşmasın, hangi tarihte ne kadarlık çekim yapılacağına sürekli ben karar vereyim diye isteyebilir. Bu tür satışlar için ise PlanType:2 olarak girilir. Ve Moka sistemi bu satışa ilişkin, otomatik olarak ödeme adımı hiçbir zaman oluşturmaz. Ama manuel ödeme adımının tarihi geldiğinde karttan çekim yapılır. Sayfa 4

5 Her Servis İçin Bayi Tanıma Parametreleri (Authentication) Bayiyi tanımlama için kullanılan alanlardır. Hepsi zorunludur. DealerCustomerAuthentication veya DealerSaleAuthentication nesnesi her servisin başında gönderilir. DealerCustomerAuthentication DealerCode * : Moka tarafından bayiye özel verilen kod Username * : Moka tarafından bayiye özel verilen API kullanıcı adı Password * : Moka tarafından bayiye özel verilen API şifresi CheckKey * : 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) DealerSaleAuthentication DealerCode * : Moka tarafından bayiye özel verilen kod Username * : Moka tarafından bayiye özel verilen API kullanıcı adı Password * : Moka tarafından bayiye özel verilen API şifresi CheckKey * : 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) DealerCustomer.CheckDealerCustomerAuthentication.InvalidRequest DealerSale.CheckDealerCustomerAuthentication.InvalidRequest A. KART SAKLAMA İÇİN GEREKLİ SERVİSLER 1. MÜŞTERİ SERVİSLERİ (CUSTOMER) AddCustomer : Müşteri Ekleme (URL : DealerCustomerAuthentication DealerCustomerRequest CustomerCode : Bayi tarafında müşteriyi tanımlayacak Unique kod/numara (Max 100 chars) Password : Müşteri saklı kartıntan çekim yapmak istediğinde, bayi, müşteri şifresinin de sorulmasını isterse bu alana müşterinin kendi şifresi girilir. (Max 50 chars) FirstName : Müşterinin adı (Max 50 chars) LastName : Müşterinin soyadı (Max 50 chars) Gender : Müşterinin cinsiyeti (1: erkek 2: kadın) BirthDate : Müşterinin doğum tarihi (YYYYMMDD formatında, örn: ) GsmNumber : Müşterinin telefonu (Max 20 chars) Müşterinin i (Max 100 chars) Address : Müşterinin adresi (Max 200 chars) DealerCustomer DealerCustomerId : Müşteri eklendiğinde, Moka daki Unique Id si döner CustomerCode : Bayinin, müşterisine verdiği Unique kod Password FirstName LastName Gender BirthDate GsmNumber Sayfa 5

6 Address CardListCount CardList [] CardToken CardNumberFirstSix CardNumberLastFour CardHolderFullName ExpMonth ExpYear CardName BankName : ilk ekleme sonrası müşterinin kartı olmadığından bu liste boş gelecektir (guid) DealerCustomer.AddCustomer.InvalidRequest DealerCustomer.AddCustomer.CustomerCodeAlreadyUsing DealerCustomer.AddCustomer.Invalid Format {"DealerCustomerAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":" Elif123", "CheckKey":"aabbccddeeff"},"DealerCustomerRequest":{"CustomerCode":"Customer","Password":"Elif1234", "FirstName":"Elif","LastName":"Yetimoğlu","Gender":"2","BirthDate":" ","GsmNumber":" ", " ":"elif.yetimoglu@moka.com","Address":"TAŞDELEN"}} {"Data":{"DealerCustomer":{"DealerCustomerId":1033,"CustomerCode":"Customer","Password":"Elif1234", "FirstName":"Elif","LastName":"Yetimoğlu","Gender":2,"BirthDate":" ","GsmNumber":" ", " ":"elif.yetimoglu@moka.com","Address":"TAŞDELEN"},"CardListCount":0,"CardList":[]},"ResultCode":"Success", "ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerCustomer.AddCustomer.CustomerCodeAlreadyUsing","ResultMessage":"", "Exception":null} UpdateCustomer : Müşteri Güncelleme(URL: DealerCustomerAuthentication DealerCustomerRequest DealerCustomerId * : CustomerCode gönderilirse zorunlu değil CustomerCode * : DealerCustomerId gönderilirse zorunlu değil Password : Zorunlu değil, gönderilmezse güncellenmez FirstName : Zorunlu değil, gönderilmezse güncellenmez LastName : Zorunlu değil, gönderilmezse güncellenmez Gender : Zorunlu değil, gönderilmezse güncellenmez BirthDate : Zorunlu değil, gönderilmezse güncellenmez GsmNumber : Zorunlu değil, gönderilmezse güncellenmez Zorunlu değil, gönderilmezse güncellenmez Address : Zorunlu değil, gönderilmezse güncellenmez DealerCustomer DealerCustomerId CustomerCode Password FirstName LastName Gender Sayfa 6

7 BirthDate GsmNumber Address CardListCount CardList [] CardToken (guid) : Kartın Token ı (Bayi bu bilgi ile karttan çekim yapabilecektir) CardNumberFirstSix : Kartın ilk 6 hanesi (BIN numarası) CardNumberLastFour : Kartın son 4 hanesi CardHolderFullName : Kart sahibinin adı soyadı ExpMonth : Son kullanım tarihi, AY (MM formatında, örn: 03 ) ExpYear : Son kullanım tarihi, YIL (YYYY formatında, örn: 2018 ) CardName : Karta verilen isim (örn : Bonus kartım ) (Max 50 chars) BankName : Kartın sahibi bankanın ismi DealerCustomer.UpdateCustomer.InvalidRequest DealerCustomer.UpdateCustomer.CustomerCodeOrDealerCustomerIdMustBeGiven DealerCustomer.UpdateCustomer.Invalid Format DealerCustomer.UpdateCustomer.DealerCustomerNotFound DealerCustomer.UpdateCustomer.CustomerCodeDoesntMatchDealerCustomerId {"DealerCustomerAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccdd eeff"},"dealercustomerrequest":{"dealercustomerid":"","customercode":"customer","password":"elif1234","firstna me":"elif","lastname":"yetimoğlu","gender":"2","birthdate":" ","gsmnumber":" "," ":"elif.ye timoglu@moka.com"}} {"Data":{"DealerCustomer":{"DealerCustomerId":1033,"CustomerCode":"Customer","Password":"Elif1234", "FirstName":"Elif","LastName":"Yetimoğlu","Gender":2,"BirthDate":" ","GsmNumber":" ", " ":"elif.yetimoglu@moka.com","Address":"TAŞDELEN"},"CardListCount":0,"CardList":[]},"ResultCode":"Success", "ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerCustomer.UpdateCustomer.CustomerCodeOrDealerCustomerIdMustBeGiven","Result Message":"","Exception":null} GetCustomerList : Bayi Müşterileri (URL : GetCustomerList) DealerCustomerAuthentication DealerCustomerListCount DealerCustomerList[] DealerCustomerId CustomerCode Password FirstName LastName Gender BirthDate GsmNumber Address : Müşteri listesindeki kayıt sayısı : Müşteri listesi Sayfa 7

8 DealerCustomer.GetCustomer.InvalidRequest DealerCustomer.GetCustomerList.PermissionDenied DealerCustomer.GetCustomerList.DealerCustomerNotFound {"DealerCustomerAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"elif123","CheckKey":"aabbccddeeff"}} {"Data":{"DealerCustomerListCount":1,"DealerCustomerList":[{"DealerCustomerId":1033,"CustomerCode":"Customer"," Password":"Elif1234","FirstName":"Elif","LastName":"Yetimoğlu","Gender":2,"BirthDate":" ","GsmNumber":"5 "ResultMessage":"", "Exception":null} {"Data":null,"ResultCode":"DealerCustomer. GetCustomerList.DealerCustomerNotFound", "ResultMessage":"", "Exception":null} GetCustomer : Tek Müşteri Görme (URL : DealerCustomerAuthentication DealerCustomerRequest DealerCustomerId * : CustomerCode gönderilirse zorunlu değil CustomerCode * : DealerCustomerId gönderilirse zorunlu değil DealerCustomer DealerCustomerId CustomerCode Password FirstName LastName Gender BirthDate GsmNumber Address CardListCount CardList [] CardToken (guid) : Kartın Token ı (Bayi bu bilgi ile karttan çekim yapabilecektir) CardNumberFirstSix : Kartın ilk 6 hanesi (BIN numarası) CardNumberLastFour : Kartın son 4 hanesi CardHolderFullName : Kart sahibinin adı soyadı ExpMonth : Son kullanım tarihi, AY (MM formatında, örn: 03 ) ExpYear : Son kullanım tarihi, YIL (YYYY formatında, örn: 2018 ) CardName : Karta verilen isim (örn : Bonus kartım ) (Max 50 chars) BankName : Kartın sahibi bankanın ismi DealerCustomer.GetCustomer.InvalidRequest DealerCustomer.GetCustomer.CustomerCodeOrDealerCustomerIdMustBeGiven DealerCustomer.GetCustomer.DealerCustomerNotFound DealerCustomer.GetCustomer.CustomerCodeDoesntMatchDealerCustomerId {"DealerCustomerAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"elif123", "CheckKey":"aabbccddeeff"},"DealerCustomerRequest":{"DealerCustomerId":"","CustomerCode":"Customer"}} Sayfa 8

9 {"Data":{"DealerCustomer":{"DealerCustomerId":1033,"CustomerCode":"Customer","Password":"Elif1234", "FirstName":"Elif","LastName":"Yetimoğlu","Gender":2,"BirthDate":" ","GsmNumber":" ", "ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerCustomer.GetCustomer.CustomerCodeOrDealerCustomerIdMustBeGiven", "ResultMessage":"","Exception":null} RemoveCustomer : Müşteri Silme (URL : DealerCustomerAuthentication DealerCustomerRequest DealerCustomerId * : CustomerCode gönderilirse zorunlu değil CustomerCode * : DealerCustomerId gönderilirse zorunlu değil Boolean DealerCustomer.RemoveCustomer.InvalidRequest DealerCustomer.RemoveCustomer.CustomerCodeOrDealerCustomerIdMustBeGiven DealerCustomer.RemoveCustomer.DealerCustomerNotFound DealerCustomer.RemoveCustomer.CustomerCodeDoesntMatchDealerCustomerId {"DealerCustomerAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123", "CheckKey":"aabbccddeeff"},"DealerCustomerRequest":{"DealerCustomerId":"","CustomerCode":"Customer"}} {"Data":{},"ResultCode":"Success","ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerCustomer.RemoveCustomer.CustomerCodeOrDealerCustomerIdMustBeGiven", "ResultMessage":"","Exception":null} Müşteri ve Kart Ekleme (URL : DealerCustomerAuthentication DealerCustomerRequest CustomerCode Password FirstName LastName Gender BirthDate GsmNumber Address CardHolderFullName * : Kart sahibinin adı soyadı (Max 100 chars) CardNumber * : Kart numarası ExpMonth * : Son kullanım tarihi, AY (MM formatında, örn: 03 ) ExpYear * : Son kullanım tarihi, YIL (YYYY formatında, örn: 2018 ) CardName : Karta verilen isim (örn : Bonus kartım ) (Max 50 chars) Sayfa 9

10 DealerCustomer DealerCustomerId CustomerCode Password FirstName LastName Gender BirthDate GsmNumber Address CardListCount CardList [] : Müşteri ve tek bir kart aynı anda eklendiği için listede tek kart döner CardToken (guid) : Kartın Token ı (Bayi bu bilgi ile karttan çekim yapabilecektir) CardNumberFirstSix : Kartın ilk 6 hanesi (BIN numarası) CardNumberLastFour : Kartın son 4 hanesi CardHolderFullName : Kart sahibinin adı soyadı ExpMonth : Son kullanım tarihi, AY (MM formatında, örn: 03 ) ExpYear : Son kullanım tarihi, YIL (YYYY formatında, örn: 2018 ) CardName : Karta verilen isim (örn : Bonus kartım ) BankName : Kartın sahibi bankanın ismi DealerCustomer.AddCustomerWithCard.InvalidRequest DealerCustomer.AddCustomerWithCard.CardHolderFullNameIsRequired DealerCustomer.AddCustomerWithCard.CardNumberIsRequired DealerCustomer.AddCustomerWithCard.ExpMonthIsRequired DealerCustomer.AddCustomerWithCard.ExpYearIsRequired DealerCustomer.AddCustomerWithCard.CustomerCodeAlreadyUsing {"DealerCustomerAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif1234", "CheckKey":"aabbccddeeff"},"DealerCustomerRequest":{"CustomerCode":"Customer","Password":"Elif1234", "FirstName":"Elif","LastName":"Yetimoğlu","Gender":"2","BirthDate":" ","GsmNumber":" ", " ":"elif.yetimoglu@moka.com","Address":"TAŞDELEN","CardHolderFullName":"elif yetimoglu", "CardNumber":" ","ExpMonth":"01", "ExpYear":"2018","CardName":"Bonus kartım"}} {"Data":{"DealerCustomer":{"DealerCustomerId":1034,"CustomerCode":"Customer","Password":"Elif1234", "FirstName":"Elif","LastName":"Yetimoğlu","Gender":2,"BirthDate":" ","GsmNumber":" ", " ":"elif.yetimoglu@moka.com","Address":"TAŞDELEN"},"CardListCount":1,"CardList":[{"CardToken":"9de41bb0- e82f-4670-b36b-d71ff27a3111","cardnumberfirstsix":"111122","cardnumberlastfour":"5555", "CardHolderFullName":"elif yetimoglu","expmonth":"01","expyear":"2018","cardname":"bonus kartım", "BankName":"BANKAADI }]}, "ResultCode":"Success", "ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerCustomer.AddCustomerWithCard.InvalidDate","ResultMessage":"","Exception":null} 2. KART SERVİSLERİ (CARD) AddCard : Kart Ekleme (URL : DealerCustomerAuthentication Sayfa 10

11 DealerCustomerRequest DealerCustomerId * : CustomerCode gönderilirse zorunlu değil CustomerCode * : DealerCustomerId gönderilirse zorunlu değil (Max 100 chars) CardHolderFullName * : Kart sahibinin adı soyadı (Max 100 chars) CardNumber * : Kart numarası ExpMonth * : Son kullanım tarihi, AY (MM formatında, örn: 03 ) ExpYear * : Son kullanım tarihi, YIL (YYYY formatında, örn: 2018 ) CardName : Karta verilen isim (örn : Bonus kartım ) (Max 50 chars) DealerCustomer DealerCustomerId CustomerCode Password FirstName LastName Gender BirthDate GsmNumber Address CardListCount CardList [] : Bu listede (1 adet) sadece eklenen kartın bilgileri döner CardToken (guid) : Kartın Token ı (Bayi bu bilgi ile karttan çekim yapabilecektir) CardNumberFirstSix : Kartın ilk 6 hanesi (BIN numarası) CardNumberLastFour : Kartın son 4 hanesi CardHolderFullName : Kart sahibinin adı soyadı ExpMonth : Son kullanım tarihi, AY (MM formatında, örn: 03 ) ExpYear : Son kullanım tarihi, YIL (YYYY formatında, örn: 2018 ) CardName : Karta verilen isim (örn : Bonus kartım ) BankName : Kartın sahibi bankanın ismi DealerCustomer.AddCard.InvalidRequest DealerCustomer.AddCard.CustomerCodeOrDealerCustomerIdMustBeGiven DealerCustomer.AddCard.CardHolderFullNameIsRequired DealerCustomer.AddCard.CardNumberIsRequired DealerCustomer.AddCard.CardAlreadyExists DealerCustomer.AddCard.ExpMonthIsRequired DealerCustomer.AddCard.ExpYearIsRequired DealerCustomer.AddCard.DealerCustomerNotFound DealerCustomer.AddCard.CustomerCodeDoesntMatchDealerCustomerId {"DealerCustomerAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccdd eeff"},"dealercustomerrequest":{"dealercustomerrequest":{"dealercustomerid":"","customercode":"eycustomer2"," CardHolderFullName":"elif yetimoglu","cardnumber":" ","expmonth":"01","expyear":"2018", "CardName":"Bonus kartım"}} {"Data":{"DealerCustomer":{"DealerCustomerId":1034,"CustomerCode":"Customer","Password":"Elif1234","FirstName" :"Elif","LastName":"Yetimoğlu","Gender":2,"BirthDate":" ","GsmNumber":" ", " ":"elif.yetimoglu@moka.com","Address":"TAŞDELEN"},"CardListCount":1,"CardList":[{"CardToken":" e a8f5-2e1ec56ec870","CardNumberFirstSix":"112233","CardNumberLastFour":"7788", "CardHolderFullName":"elif yetimoglu","expmonth":"01","expyear":"2018","cardname":"bonus kartım", "BankName":"BANKAADI }]}, "ResultCode":"Success", "ResultMessage":"","Exception":null} Sayfa 11

12 {"Data":null,"ResultCode":"DealerCustomer.AddCard.ExpMonthIsRequired","ResultMessage":"","Exception":null} UpdateCard : Kart Güncelleme (URL : DealerCustomerAuthentication DealerCustomerRequest CardToken (guid) * : Kart eklendiğinde Moka tarafından bayiye dönen Token CardName * : Karta verilen isim (örn : Bonus kartım ) (Max 50 chars) DealerCustomer DealerCustomerId CustomerCode Password FirstName LastName Gender BirthDate GsmNumber Address CardListCount CardList [] : Tek bir kart güncellendiği için listede tek kart döner CardToken (guid) : Kartın Token ı (Bayi bu bilgi ile karttan çekim yapabilecektir) CardNumberFirstSix : Kartın ilk 6 hanesi (BIN numarası) CardNumberLastFour : Kartın son 4 hanesi CardHolderFullName : Kart sahibinin adı soyadı ExpMonth : Son kullanım tarihi, AY (MM formatında, örn: 03 ) ExpYear : Son kullanım tarihi, YIL (YYYY formatında, örn: 2018 ) CardName : Karta verilen isim (örn : Bonus kartım ) BankName : Kartın sahibi bankanın ismi DealerCustomer.GetCard.InvalidRequest DealerCustomer.GetCard.CardTokenIsRequired DealerCustomer.GetCard.CardNotFound {"DealerCustomerAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccdd eeff"},"dealercustomerrequest":{"cardtoken":"{ e a8f5-2e1ec56ec870}","cardname":"bonus kartım"}} {"Data":{"DealerCustomer":{"DealerCustomerId":1034,"CustomerCode":"Customer","Password":"Elif1234","FirstName" :"Elif","LastName":"Yetimoğlu","Gender":2,"BirthDate":" ","GsmNumber":" "," ":"elif.yetimogl u@moka.com","address":"taşdelen"},"cardlistcount":1,"cardlist":[{"cardtoken":" e a8f5-2e1ec56ec870","cardnumberfirstsix":"112233","cardnumberlastfour":"7788","cardholderfullname":"elif yetimoglu","expmonth":"01","expyear":"2018","cardname":"bonus kartım","bankname":"bankaadi }]}, "ResultCode":"Success", "ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerCustomer.GetCard.CardTokenIsRequired","ResultMessage":"","Exception":null} GetCard : Tek Kart Görme (URL : DealerCustomerAuthentication Sayfa 12

13 DealerCustomerRequest CardToken (guid) * : Kart eklendiğinde Moka tarafından bayiye dönen Token DealerCustomer DealerCustomerId CustomerCode Password FirstName LastName Gender BirthDate GsmNumber Address CardListCount CardList [] : Tek bir kart istendiği için listede tek kart döner CardToken (guid) : Kartın Token ı (Bayi bu bilgi ile karttan çekim yapabilecektir) CardNumberFirstSix : Kartın ilk 6 hanesi (BIN numarası) CardNumberLastFour : Kartın son 4 hanesi CardHolderFullName : Kart sahibinin adı soyadı ExpMonth : Son kullanım tarihi, AY (MM formatında, örn: 03 ) ExpYear : Son kullanım tarihi, YIL (YYYY formatında, örn: 2018 ) CardName : Karta verilen isim (örn : Bonus kartım ) BankName : Kartın sahibi bankanın ismi DealerCustomer.GetCard.InvalidRequest DealerCustomer.GetCard.CardTokenIsRequired DealerCustomer.GetCard.CardNotFound {"DealerCustomerAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccdd eeff"},"dealercustomerrequest":{"cardtoken":"{ e a8f5-2e1ec56ec870}"}} {"Data":{"DealerCustomer":{"DealerCustomerId":1034,"CustomerCode":"Customer","Password":"Elif1234","FirstName" :"Elif","LastName":"Yetimoğlu","Gender":2,"BirthDate":" ","GsmNumber":" "," ":"elif.yetimogl u@moka.com","address":"taşdelen"},"cardlistcount":1,"cardlist":[{"cardtoken":" e a8f5-2e1ec56ec870","cardnumberfirstsix":"112233","cardnumberlastfour":"7788","cardholderfullname":"elif yetimoglu","expmonth":"01","expyear":"2018","cardname":"bonus kartım","bankname":"bankaadi }]}, "ResultCode":"Success", "ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerCustomer.GetCard.CardTokenIsRequired","ResultMessage":"","Exception":null} GetCardList : Müşterinin Kartlarını Görme (URL : DealerCustomerAuthentication DealerCustomerRequest DealerCustomerId * : CustomerCode gönderilirse zorunlu değil CustomerCode * : DealerCustomerId gönderilirse zorunlu değil DealerCustomer DealerCustomerId CustomerCode Sayfa 13

14 Password FirstName LastName Gender BirthDate GsmNumber Address CardListCount CardList [] : Müşterinin kaç adet kartı varsa, hepsi bu listede döner CardToken (guid) : Kartın Token ı (Bayi bu bilgi ile karttan çekim yapabilecektir) CardNumberFirstSix : Kartın ilk 6 hanesi (BIN numarası) CardNumberLastFour : Kartın son 4 hanesi CardHolderFullName : Kart sahibinin adı soyadı ExpMonth : Son kullanım tarihi, AY (MM formatında, örn: 03 ) ExpYear : Son kullanım tarihi, YIL (YYYY formatında, örn: 2018 ) CardName : Karta verilen isim (örn : Bonus kartım ) BankName : Kartın sahibi bankanın ismi DealerCustomer.GetCardList.InvalidRequest DealerCustomer.GetCardList.CustomerCodeOrDealerCustomerIdMustBeGiven DealerCustomer.GetCardList.DealerCustomerNotFound DealerCustomer.GetCardList.CustomerCodeDoesntMatchDealerCustomerId {"DealerCustomerAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"ELİF123","CheckKey":"aabbccdd eeff"},"dealercustomerrequest":{"dealercustomerid":"","customercode":"customer"}} {"Data":{"DealerCustomer":{"DealerCustomerId":1034,"CustomerCode":"Customer","Password":"Elif1234","FirstName" :"Elif","LastName":"Yetimoğlu","Gender":2,"BirthDate":" ","GsmNumber":" "," ":"elif.yetimogl u@moka.com","address":"taşdelen"},"cardlistcount":1,"cardlist":[{"cardtoken":"9de41bb0-e82f-4670-b36bd71ff27a3111","cardnumberfirstsix":"111122","cardnumberlastfour":"5555","cardholderfullname":"elif yetimoglu","expmonth":"01","expyear":"2018","cardname":"bonus kartım","bankname":"bankaadi }]}, "ResultCode":"Success", "ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerCustomer.GetCardList.CustomerCodeOrDealerCustomerIdMustBeGiven", "ResultMessage":"","Exception":null} RemoveCard : Kart Silme (URL : DealerCustomerAuthentication DealerCustomerRequest CardToken (guid) : Kart eklendiğinde Moka tarafından bayiye dönen Token Boolean DealerCustomer.RemoveCard.InvalidRequest DealerCustomer.RemoveCard.CardTokenIsRequired DealerCustomer.RemoveCard.CardNotFound Sayfa 14

15 {"DealerCustomerAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccdd eeff"},"dealercustomerrequest":{"cardtoken":"{ e a8f5-2e1ec56ec870}"}} {"Data":true,"ResultCode":"Success","ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerCustomer.RemoveCard.CardTokenIsRequired","ResultMessage":"","Exception":null} B. TEKRARLI ÖDEMELER İÇİN GEREKLİ SERVİSLER 1. ÜRÜN SERVİSLERİ (PRODUCT) AddProduct : Ürün Ekleme (URL : DealerSaleAuthentication DealerSaleRequest ProductName * : Ürünün adı (Max 100 chars) ProductCode : Ürünün bayi tarafındaki özel kodudur. Boş gönderilirse guid oluşturulur DealerProductId : Moka tarafındaki ürünün Unique ID sidir ProductName ProductCode : Bayi, özel bir kod göndermemişse bu alanda guid döner DealerSale.AddProduct.InvalidRequest DealerSale.AddProduct.ProductNameIsRequired DealerSale.AddProduct.ProductCodeAlreadyUsing DealerSale.AddProduct.ProductNameAlreadyExists {"DealerSaleAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123", "CheckKey":"aabbccddeeff"}," DealerSaleRequest":{"ProductCode":"Product01","ProductName":"Product"}} {"Data":{"DealerProductId":1009,"ProductName":"Product","ProductCode":"Product01"},"ResultCode":"Success", "ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerSale.AddProduct.ProductNameIsRequired","ResultMessage":"","Exception":null} DeleteProduct : Ürün Silme (URL : DealerSaleAuthentication DealerSaleRequest DealerProductId * : ProductCode gönderilirse zorunlu değil ProductCode * : DealerProductId gönderilirse zorunlu değil Boolean Sayfa 15

16 DealerSale.DeleteProduct.InvalidRequest DealerSale.DeleteProduct.ProductCodeOrDealerProductIdMustBeGiven DealerSale.DeleteProduct.ProductNotFound DealerSale.DeleteProduct.ProductCodeDoesntMathDealerProductId "DealerSaleAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccddeeff"}, "DealerSaleRequest":{"DealerProductId":"Product","ProductCode":"Product01"}} {"Data":true,"ResultCode":"Success","ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerSale.DeleteProduct.ProductCodeOrDealerProductIdMustBeGiven","ResultMessage":"","Exception":null} GetProductList : Bayinin Ürün Listesini Görme (URL: DealerSaleAuthentication ProductListCount ProductList [] DealerProductId ProductName ProductCode : Ürün listesindeki kayıt sayısı : Bayinin ürün listesi DealerSale.GetProductList.InvalidRequest DealerSale.GetProductList.NoDataFound {"DealerSaleAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccddeeff"}} {"Data":{ ProductListCount :1,ProductList[{ DealerProductId":5,"ProductName":"Deneme","ProductCode":"Dene001"}] },"ResultCode":"Success", "ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerSale.GetProductList.NoDataFound","ResultMessage":"","Exception":null} 2. ZAMAN PROGRAMI SERVİSLERİ (SCHEDULE) AddSchedule : Zaman Programı Ekleme (URL : DealerSaleAuthentication, DealerSaleRequest ScheduleName * : Zaman programının adı (örn: Ayda bir yapılan ödeme ) (Max 100) DailyWeeklyMonthly EveryX * : 1: Günlük çekim, 2: Haftalık çekim, 3: Aylık çekim * : Kaç günde, haftada veya ayda bir ödeme yapılacak (değeri 1 ise her gün, hafta veya ay anlamına gelir, değeri 2 ise, 2 günde bir, 2 haftada bir veya 2 ayda bir anlamına gelir) (max : 30) DaysOfWeek * : DailyWeeklyMonthly = 2 ise zorunlu (1: Pazartesi, 2: Salı... 7: Pazar, haftanın günleri virgül ile ayrılarak verilebilir. örn: 1,3 pazartesi ve Sayfa 16

17 çarşamba günleri) DaysOfMonth * : DailyWeeklyMonthly = 3 ise zorunlu (ayın günleri virgül ile ayrılarak verilebilir. örn: 1,15 yani ayın 1. ve 15. günü çekim yapılacak) DealerSaleScheduleId : Moka tarafında, zaman programının Unique ID sidir ScheduleName DailyWeeklyMonthly EveryX DaysOfWeek DaysOfMonth DealerSale.AddSchedule.InvalidRequest DealerSale.AddSchedule.ScheduleNameIsRequired DealerSale.AddSchedule.DailyWeeklyMonthlyIsRequired DealerSale.AddSchedule.EveryXIsRequired DealerSale.AddSchedule.DaysOfWeekIsRequired DealerSale.AddSchedule.DaysOfMonthIsRequired DealerSale.AddSchedule.ScheduleNameAlreadyExists DealerSale.AddSchedule.DaysOfWeekFormatError DealerSale.AddSchedule.DaysOfMonthFormatError {"DealerSaleAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccddeeff"}, "DealerSaleRequest":{"ScheduleName":"newschedule","DailyWeeklyMonthly":"3","EveryX":"1","DaysOfWeek":"", "DaysOfMonth":"5"}} {"Data":{"DealerSaleScheduleId":1005,"ScheduleName":"newschedule","DailyWeeklyMonthly":3,"EveryX":1, "DaysOfWeek":"","DaysOfMonth":"05"},"ResultCode":"Success","ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerSale.AddSchedule.ScheduleNameIsRequired","ResultMessage":"","Exception":null} Zaman Programı Günceleme (URL : DealerSaleAuthentication, DealerSaleRequest DealerSaleScheduleId * : Zaman programı eklendiğinde Moka dan dönen ID ScheduleName : Zorunlu değil, gönderilmezse güncellenmez DailyWeeklyMonthly : Zorunlu (1: Günlük, 2: Haftalık, 3: Aylık) EveryX : Zorunlu (max : 30) DaysOfWeek : DailyWeeklyMonthly = 2 gönderilirse bu alanın gönderilmesi de zorunlu) NOT: Aylık program verilirse, Haftanın günleri gönderilemez. DaysOfMonth : DailyWeeklyMonthly = 3 gönderilirse bu alanın gönderilmesi de zorunlu) NOT: Haftalık program verilirse, Ayın günleri gönderilemez. DealerSaleScheduleId ScheduleName DailyWeeklyMonthly EveryX DaysOfWeek DaysOfMonth Sayfa 17

18 DealerSale.UpdateSchedule.InvalidRequest DealerSale.UpdateSchedule.DealerSaleScheduleIdIsRequired DealerSale.UpdateSchedule.ScheduleNotFound DealerSale.UpdateSchedule.DaysOfWeekIsRequired DealerSale.UpdateSchedule.DaysOfMonthIsRequired DealerSale.UpdateSchedule.DaysOfWeekFormatError DealerSale.UpdateSchedule.DaysOfMonthFormatError {"DealerSaleAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccddeeff"}, "DealerSaleRequest":{"DealerSaleScheduleId":"1005","ScheduleName":"newschedule","DailyWeeklyMonthly":"2", "EveryX":"1","DaysOfWeek":"1,2,3","DaysOfMonth":""}} {"Data":{"DealerSaleScheduleId":1005,"ScheduleName":"newschedule","DailyWeeklyMonthly":2,"EveryX":1, "DaysOfWeek":"01,02,03","DaysOfMonth":""},"ResultCode":"Success","ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerSale.UpdateSchedule.DealerSaleScheduleIdIsRequired","ResultMessage":"", "Exception":null} GetSchedule : Zaman Programı Görme (URL : DealerSaleAuthentication DealerSaleRequest DealerSaleScheduleId * : Zaman programı eklendiğinde Moka dan dönen ID DealerSaleScheduleId ScheduleName DailyWeeklyMonthly EveryX DaysOfWeek DaysOfMonth DealerSale. GetSchedule.InvalidRequest DealerSale. GetSchedule.NoDataFound {"DealerSaleAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccddeeff"}, "DealerSaleRequest":{"DealerSaleScheduleId":"1005"} {"Data":{"DealerSaleScheduleId":1005,"ScheduleName":"newschedule","DailyWeeklyMonthly":2,"EveryX":1, "DaysOfWeek":"1,2,3","DaysOfMonth":""},"ResultCode":"Success","ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerSale.GetSchedule.ScheduleNotFound","ResultMessage":"","Exception":null} Bayi Zaman Programı Listesi Görme (URL : DealerSaleAuthentication SaleScheduleListCount SaleScheduleList [] Sayfa 18

19 DealerSaleScheduleId ScheduleName DailyWeeklyMonthly EveryX DaysOfWeek DaysOfMonth DealerSale.GetScheduleList.InvalidRequest DealerSale.GetScheduleList.NoDataFound {"DealerSaleAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccddeeff"}} {"Data":{"SaleScheduleListCount":1,"SaleScheduleList":[{"DealerSaleScheduleId":1005,"ScheduleName":"newschedule", "DailyWeeklyMonthly":2,"EveryX":1,"DaysOfWeek":"1,2,3","DaysOfMonth":""}]},"ResultCode":"Success", "ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerSale.GetScheduleList.NoDataFound","ResultMessage":"","Exception":null} DeleteSchedule : Zaman Programı Silme (URL : DealerSaleAuthentication, DealerSaleRequest DealerSaleScheduleId * : Zaman programı eklendiğinde Moka dan dönen ID bool DealerSale.DeleteSchedule.InvalidRequest DealerSale.DeleteSchedule.DealerSaleScheduleIdIsRequired DealerSale.DeleteSchedule.ScheduleNotFound DealersSale.DeleteSchedule.ScheduleIsUsing {"DealerSaleAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccddeeff"}, "DealerSaleRequest":{"DealerSaleScheduleId":"1004"}} {"Data":true,"ResultCode":"Success","ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerSale.DeleteSchedule.DealerSaleScheduleIdIsRequired","ResultMessage":"", "Exception":null} 3. SATIŞ SERVİSLERİ (SALE) AddSale : Satış Ekleme (URL : DealerSaleAuthentication, DealerSaleRequest Sayfa 19

20 CustomerCode * : DealerCustomerId gönderilirse zorunlu değil DealerCustomerId * : CustomerCode gönderilirse zorunlu değil ProductCode * : DealerProductId gönderilirse zorunlu değil DealerProductId * : ProductCode gönderilirse zorunlu değil SaleCode : Zorunlu değil, gönderilmezse yeni guid oluşturulur (Max 100 chars) Amount (decimal) * : Her ödemede tahsil edilecek tutar. (Not: toplam satış tutarı değildir!) (örn: formatında yazılır.) Currency : Zorunlu değil, gönderilmezse TL kabul edilir (TL, USD, EUR) InstallmentNumber : Zorunlu değil, gönderilmezse tek çekim kabul edilir (1..12) DealerSaleScheduleId * : Zaman programının ID si (PlanType : 2 verilecekse, bu alana değer girilse de sistem sıfıra çeker, bu yüzden hiç gönderilmese de olur) SaleDate * : Satışın yapıldığı tarih (YYYYMMDD formatında, örn: ) BeginDate * : Bu satışa ait ödemeler hangi tarihten itibaren başlayacak. (YYYYMMDD formatında, örn: ) EndDate : Bu satışa ait ödemeler hangi tarihte son bulacak. Eğer bir bitiş tarihi verilmezse (boş string gönderilirse veya bu alan hiç gönderilmezse), satış silinene kadar veya EndDate güncellenene kadar düzenli çekimler devam eder. (YYYYMMDD formatında, örn: ) HowManyTrial : Zorunlu değil, gönderilmezse 1 kabul edilir. (Karttan çekim yapıldığında başarısız olunursa kaç gün daha çekim denenecek. max 10 gün) Description : Zorunlu değil, açıklama detay alanı (Max 200 chars) PlanType : Zorunlu değil, gönderilmezse 1 kabul edilir (1: Ödeme adımları, verilen zaman programına göre otomatik oluşturulur, 2: Ödeme adımları manuel oluşturulmak zorunda, 3: Ödeme adımları hem manuel hem de otomatik oluşturulabilir.) Ödeme adımı manuel oluşturulacaksa, bu servis DealerSaleScheduleId : 0 a çeker. DealerCustomerTypeId : Saklı karttan değil de, müşteriye ödeme isteği göndererek ödeme yaptırılacaksa bu alana müşteri tipi ID si girilir. Bayiye özel Müşteri tipi Moka tarafından oluşturulur ve ödeme isteği gönderecek bayiye bu Id önceden iletilir. DefaultCard1Token (guid) * : Zorunlu. Ödeme hangi karttan yapılacak. DefaultCard2Token (guid) : İlk karttan ödeme yapılamazsa, hangi kart denenecek DefaultCard3Token (guid) : İlk 2 kart çalışmazsa, son olarak hangi kart denenecek DealerSaleId : Moka tarafında, satışın Unique ID sidir SaleCode : Bayi tarafında, satışın kodudur DealerCustomerId : Moka tarafında, müşterinin Unique ID sidir CustomerCode : Bayi tarafında, müşterinin kodudur DealerProductId : Moka tarafında, ürünün Unique ID sidir ProductCode : Bayi tarafında, ürünün kodudur Amount (decimal) Currency InstallmentNumber DealerSaleScheduleId SaleDate BeginDate EndDate HowManyTrial Description PlanType DealerCustomerTypeId DefaultCard1Token (guid) DefaultCard2Token (guid) DefaultCard3Token (guid) Sayfa 20

21 DealerSale.AddSale.InvalidRequest DealerSale.AddSale.CustomerCodeOrDealerCustomerIdMustBeGiven DealerSale.AddSale.ProductCodeOrDealerProductIdMustBeGiven DealerSale.AddSale.SaleDateIsRequired DealerSale.AddSale.AmountIsRequired DealerSale.AddSale.DealerSaleScheduleIdIsRequired DealerSale.AddSale.BeginDateIsRequired DealerSale.AddSale.EndDateIsRequired DealerSale.AddSale.DefaultCard1TokenIsRequired DealerSale.AddSale.DealerProductNotFund DealerSale.AddSale.ProductCodeDoesntMatchDealerProductId DealerSale.AddSale.DealerCustomerNotFound DealerSale.AddSale.CustomerCodeDoesntMatchDealerCustomerId DealerSale.AddSale.SaleDateAlreadyPassed DealerSale.AddSale.BeginDateAlreadyPassed DealerSale.AddSale.EndDateAlreadyPassed DealerSale.AddSale.BeginSaleEndDateException DealerSale.AddSale.DealerSaleScheduleNotFound DealerSale.AddSale.InvalidCardToken DealerSale.AddSale.InvalidDefaultCard2Token DealerSale.AddSale.InvalidDefaultCard3Token DealerSale.AddSale.InvalidDealerCustomerTypeId DealerSale.AddSale.InvalidCurrencyCode {"DealerSaleAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccddeeff"}, "DealerSaleRequest":{"CustomerCode":"Customer","DealerCustomerId":"","ProductCode":"Product01", "DealerProductId":"","SaleCode":"satis","Amount":"0.01","Currency":"TL","InstallmentNumber":"1","DealerSaleSchedul eid":"1005","begindate":" ","enddate":" ","howmanytrial":"1","description":"","plantype":"1", "DealerCustomerTypeId":"","DefaultCard1Token":"{9DE41BB0-E82F-4670-B36B-D71FF27A3111}", "DefaultCard2Token":"", "DefaultCard3Token":"","SaleDate":" "}} {"Data":{"DealerSaleId":1003,"SaleCode":"satis","DealerCustomerId":1034,"CustomerCode":"Customer","DealerProduct Id":1009,"ProductCode":"Product01","Amount":0.01,"Currency":"TL","InstallmentNumber":1,"DealerSaleScheduleId": 1005,"SaleDate":" ","BeginDate":" ","EndDate":" ","HowManyTrial":1,"Description":"", "PlanType":1,"DealerCustomerTypeId":0,"DefaultCard1Token":"9de41bb0-e82f-4670-b36b-d71ff27a3111", "DefaultCard2Token":"","DefaultCard3Token":""},"ResultCode":"Success","ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerSale.AddSale.DefaultCard1TokenIsRequired","ResultMessage":"","Exception":null} UpdateSale : Satış Güncelleme (URL : DealerSaleAuthentication DealerSaleRequest DealerSaleId * : SaleCode gönderilirse zorunlu değil SaleCode * : DealerSaleId gönderilirse zorunlu değil (Max 100 chars) Amount (decimal) : Zorunlu değil, gönderilmezse güncellenmez Currency : Zorunlu değil, gönderilmezse güncellenmez InstallmentNumber : Zorunlu değil, gönderilmezse güncellenmez DealerSaleScheduleId : Zorunlu değil, gönderilmezse güncellenmez (PlanType:1 veya 3 ise bu alana değer girilmişse güncellenir, PlanType:2 ise sistem 0 a çeker) BeginDate : Zorunlu değil, gönderilmezse güncellenmez EndDate : Zorunlu değil, gönderilmezse güncellenmez, Boş string gönderilirse bitiş tarihi olmayan bir satışa dönüşür. HowManyTrial : Zorunlu değil, gönderilmezse güncellenmez Sayfa 21

22 Description : Zorunlu değil, gönderilmezse güncellenmez PlanType : Zorunlu değil, gönderilmezse güncellenmez. Ödeme adımı manuel oluşturulacak diye güncellenirse (PlanType:2), bu servis DealerSaleScheduleId : 0 a çeker. DealerCustomerTypeId : Zorunlu değil, gönderilmezse güncellenmez DefaultCard1Token (guid) : Zorunlu değil, gönderilmezse güncellenmez DefaultCard2Token (guid) : Zorunlu değil, gönderilmezse güncellenmez DefaultCard3Token (guid) : Zorunlu değil, gönderilmezse güncellenmez DealerSaleId : Moka tarafında, satışın Unique ID sidir SaleCode : Bayi tarafında, satışın kodudur DealerCustomerId : Moka tarafında, müşterinin Unique ID sidir CustomerCode : Bayi tarafında, müşterinin kodudur DealerProductId : Moka tarafında, ürünün Unique ID sidir ProductCode : Bayi tarafında, ürünün kodudur Amount (decimal) Currency InstallmentNumber DealerSaleScheduleId SaleDate BeginDate EndDate HowManyTrial Description PlanType DealerCustomerTypeId DefaultCard1Token (guid) DefaultCard2Token (guid) DefaultCard3Token (guid) DealerSale.UpdateSale.InvalidRequest DealerSale.UpdateSale.SaleCodeOrDealerSaleIdMustBeGiven DealerSale.UpdateSale.DealerSaleNotFound DealerSale.UpdateSale.SaleCodeDoesntMatchDealerSaleId DealerSale.UpdateSale.EndDatePassed DealerSale.UpdateSale.BeginDatePassed DealerSale.UpdateSale.InvalidCurrencyCode DealerSale.AddSale.InvalidDealerCustomerTypeId DealerSale.UpdateSale.RequestedBeginDatePassed {"DealerSaleAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccddeeff"}, "DealerSaleRequest":{"DealerSaleId":"","SaleCode":"satis","Amount":"1","Currency":"TL","InstallmentNumber":"1", "DealerSaleScheduleId":"1005","BeginDate":" ","EndDate":" ","HowManyTrial":"1","Description":"", "PlanType":"3","DealerCustomerTypeId":"","DefaultCard1Token":"{9DE41BB0-E82F-4670-B36B-D71FF27A3111}", "DefaultCard2Token":"","DefaultCard3Token":""}} {"Data":{"DealerSaleId":1003,"SaleCode":"satis","DealerCustomerId":1034,"CustomerCode":"Customer","DealerProduct Id":1009,"ProductCode":"Product01","Amount":1.0,"Currency":"TL","InstallmentNumber":1,"DealerSaleScheduleId": 1005,"SaleDate":" ","BeginDate":" ","EndDate":" ","HowManyTrial":1,"Description":"", "PlanType":3,"DealerCustomerTypeId":0,"DefaultCard1Token":"9de41bb0-e82f-4670-b36b-d71ff27a3111", "DefaultCard2Token":"","DefaultCard3Token":""},"ResultCode":"Success","ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerSale.UpdateSale.RequestedBeginDatePassed","ResultMessage":"","Exception":null} Sayfa 22

23 GetSaleList : Bayi Satışlarını Görme (URL : DealerSaleAuthentication DealerSaleListCount DealerSaleList[] DealerSaleId SaleCode DealerCustomerId CustomerCode DealerProductId ProductCode Amount Currency InstallmentNumber DealerSaleScheduleId SaleDate BeginDate EndDate HowManyTrial Description PlanType DealerCustomerTypeId DefaultCard1Token DefaultCard2Token DefaultCard3Token : Satış listesindeki kayıt sayısı : Satış listesi (decimal) (guid) (guid) (guid) DealerSale.GetSale.InvalidRequest DealerSale.GetSaleList.PermissionDenied DealerSale.GetSaleList.DealerSaleNotFund {"DealerSaleAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccddeeff"}} {"Data":{ DealerSaleListCount :1, DealerSaleList:[{"DealerSaleId":1003,"SaleCode":"satis","DealerCustomerId":1034,"CustomerCode":"Customer","Dealer ProductId":1009,"ProductCode":"Product01","Amount":1.00,"Currency":"TL","InstallmentNumber":1,"DealerSaleSched uleid":1005,"saledate":" ","begindate":" ","enddate":" ","howmanytrial":1,"description":" ", "PlanType":1,"DealerCustomerTypeId":0,"DefaultCard1Token":"9de41bb0-e82f-4670-b36b-d71ff27a3111", "DefaultCard2Token":"","DefaultCard3Token":""}]},"ResultCode":"Success","ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerSale. GetSaleList.DealerSaleNotFound","ResultMessage":"","Exception":null} GetSale : Tek Satışı Görme (URL : DealerSaleAuthentication DealerSaleRequest: DealerSaleId * : SaleCode gönderilirse zorunlu değil SaleCode * : DealerSaleId gönderilirse zorunlu değil Sayfa 23

24 DealerSaleId : Moka tarafında, satışın Unique ID sidir SaleCode : Bayi tarafında, satışın kodudur DealerCustomerId : Moka tarafında, müşterinin Unique ID sidir CustomerCode : Bayi tarafında, müşterinin kodudur DealerProductId : Moka tarafında, ürünün Unique ID sidir ProductCode : Bayi tarafında, ürünün kodudur Amount (decimal) Currency InstallmentNumber DealerSaleScheduleId SaleDate BeginDate EndDate HowManyTrial Description PlanType DealerCustomerTypeId DefaultCard1Token (guid) DefaultCard2Token (guid) DefaultCard3Token (guid) DealerSale.GetSale.InvalidRequest DealerSale.GetSale.DealerSaleNotFund DealerSale.GetSale.SaleCodeOrDealerSaleIdMustBeGiven DealerSale.GetSale.SaleCodeDoesntMatchDealerSaleId {"DealerSaleAuthentication":{"DealerCode":"ELİF","Username":"Elif","Password":"Elif123","CheckKey":"aabbccddeeff"}, "DealerSaleRequest":{"DealerSaleId":"","SaleCode":"satis"}} {"Data":{"DealerSaleId":1003,"SaleCode":"satis","DealerCustomerId":1034,"CustomerCode":"Customer","DealerProduct Id":1009,"ProductCode":"Product01","Amount":1.00,"Currency":"TL","InstallmentNumber":1,"DealerSaleScheduleId": 1005,"SaleDate":" ","BeginDate":" ","EndDate":" ","HowManyTrial":1,"Description":"", "PlanType":1,"DealerCustomerTypeId":0,"DefaultCard1Token":"9de41bb0-e82f-4670-b36b-d71ff27a3111", "DefaultCard2Token":"","DefaultCard3Token":""},"ResultCode":"Success","ResultMessage":"","Exception":null} {"Data":null,"ResultCode":"DealerSale.GetSale.DealerSaleNotFound","ResultMessage":"","Exception":null} DeleteSale : Satış Silme (URL : DealerSaleAuthentication DealerSaleRequest: DealerSaleId * : SaleCode gönderilirse zorunlu değil SaleCode * : DealerSaleId gönderilirse zorunlu değil Boolean DealerSale.DeleteSale.InvalidRequest DealerSale.DeleteDealer.DealerSaleNotFund DealerSale.DeleteDealer.SaleCodeDoesntMatchDealerSaleId DealerSale.DeleteSale.SaleCodeOrDealerSaleIdMustBeGiven Sayfa 24