Kart Ekleme

Servis Adresi

İstek Parametreleri

DealerCustomerAuthentication

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.

DealerCustomerRequest

Parametre Açıklama
DealerCustomerId (integer) Müşteri eklendiğinde, Moka’ daki Unique Id’ si döner. CustomerCode gönderilirse zorunlu değil.
CustomerCode (string) Bayinin, müşterisine verdiği Unique koddur. DealerCustomerId gönderilirse zorunlu değil (Max 100 chars)
CardHolderFullName (string) Kart sahibinin adı soyadı (Max 100 chars)
CardNumber (string) Kart numarası
ExpMonth (string) Son kullanım tarihi, AY (MM formatında, örn: "03")
ExpYear (string) Son kullanım tarihi, YIL (YYYY formatında, örn: "2018")
CardName (string) Karta verilen isim (örn : “Maximum kartım”) (Max 50 chars)

Örnek İstek (JSON)


{
	"DealerCustomerAuthentication":{
		"DealerCode":"xxx",
		"Username":"xxx",
		"Password":"xxx",
		"CheckKey":"aabbccddeeff"
   },
	"DealerCustomerRequest":{
		"DealerCustomerId":"",
		"CustomerCode":"EYCustomer2",
		"CardHolderFullName":"elif yetimoglu",
		"CardNumber":"1111222233335555",
		"ExpMonth":"01",
		"ExpYear":"2018",
		"CardName":"Bonus kartım"
   }
}

Başarılı İstek Sonucu

Parametre Açıklama
DealerCustomerId (integer) Kartı eklenen müşterinin, Moka’ daki Unique Id’ si döner.
CustomerCode (string) Daha önce, müşteri eklenirken bayinin, müşterisine verdiği Unique kod
Password (string) Müşteri saklı kartından çekim yapmak istediğinde, bayi, müşteri şifresinin de sorulmasını isterse bu alana müşterinin kendi şifresi girilir. (Max 50 chars)
FirstName(string) Müşteri Moka sistemine ilk kez kaydedilecekse, müşterinin adı girilir.
LastName (string) Müşteri Moka sistemine ilk kez kaydedilecekse, müşterinin soyadı girilir.
Gender (integer) Müşteri Moka sistemine ilk kez kaydedilecekse, müşterinin cinsiyeti girilir. 1: erkek 2: kadın
BirthDate (string) Müşteri Moka sistemine ilk kez kaydedilecekse, müşterinin doğum tarihi girilir.
GsmNumber (integer) Müşteri Moka sistemine ilk kez kaydedilecekse, müşterinin cep telefonu girilir.
Email (integer) Müşteri Moka sistemine ilk kez kaydedilecekse, müşterinin email adresi girilir.
Address (integer) Müşteri Moka sistemine ilk kez kaydedilecekse, müşterinin ikamet adresi girilir.
CardListCount (integer) Müşterinin saklanmış kartlarının sayısı. "1"
CardList (Array) Müşterinin saklanmış kartlarının listesi

CardToken (guid) Kartın Token’ ı (Bayi bu bilgi ile karttan çekim yapabilecektir)
CardName (string) Karta verilen isim (örn : “Maximum kartım”) (Max 50 chars)
BankName (string) Kartın bankasının ismi (Issuer Bank)
CardNumberFirstSix (string) Kart numarasının ilk 6 hanesi (BIN numarası)
CardNumberLastFour (string) Kart numarasının son 4 hanesi
CardHolderFullName (string) Kart sahibinin adı soyadı
ExpMonth (string Son kullanım tarihi - AY (MM formatında, örn: "03")
ExpYear (string) Son kullanım tarihi - YIL (YYYY formatında, örn: "2020)/td>

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


{
   "Data":{
      "DealerCustomer":{
         "DealerCustomerId":1034,
         "CustomerCode":"EYCustomer2",
         "Password":"Elif1234",
         "FirstName":"Elif",
         "LastName":"Yetimoğlu",
         "Gender":2,
         "BirthDate":"19850710",
         "GsmNumber":"5301111111",
         "Email":"elif.y@moka.com",
         "Address":"TAŞDELEN"
      },
      "CardListCount":1,
      "CardList":[
         {
            "CardToken":"51937236-82e0-4637-a8f5-2e1ec56ec870",
            "CardName":"Bonus kartım",
            "BankName":"BANKAADI",
            "CardNumberFirstSix":"111122",
            "CardNumberLastFour":"5555",
            "CardHolderFullName":"elif y",
            "ExpMonth":"01",
            "ExpYear":"2018"
         }
      ]
   },
   "ResultCode":"Success",
   "ResultMessage":"",
   "Exception":null
}

Başarısız İstek Sonucu

ResultCodeAçıklama
DealerCustomer.AddCard.InvalidRequestCheckKey hatalı ya da nesne hatalı ya da JSON bozuk olabilir.
DealerCustomer.AddCard.CustomerCodeOrDealerCustomerIdMustBeGivenMüşteri kodu veya bayi müşteri id girilmelidir.
DealerCustomer.AddCard.CardHolderFullNameIsRequiredKart sahibinin adı soyadı gerekli.
DealerCustomer.AddCard.CardNumberIsRequiredKart numarası gerekli.
DealerCustomer.AddCard.CardAlreadyExistsBu kart önceden eklenmiş.
DealerCustomer.AddCard.ExpMonthIsRequiredAy formatında son kullanım tarihi gerekli.
DealerCustomer.AddCard.ExpYearIsRequiredYıl formatında son kullanım tarihi gerekli.
DealerCustomer.AddCard.DealerCustomerNotFoundBayi müşterisi bulunamadı.
DealerCustomer.AddCard.CustomerCodeDoesntMatchDealerCustomerIdMüşteri koduyla bayi müşteri id eşleşmiyor.
EX Beklenmeyen bir hata oluştu

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


{
	"Data": null,
	"ResultCode": "DealerCustomer.AddCard.ExpMonthIsRequired",
	"ResultMessage": "",
	"Exception": null
}