Servis Adresi
/DealerCustomer/AddCustomer
İstek Parametreleri
DealerCustomerAuthentication
Parametre
|
Açıklama
|
DealerCode (string) |
Moka sistemi tarafından verilen bayi kodu |
Username (string) |
Moka sistemi tarafından verilen kullanıcı adı |
Password (string) |
Moka sistemi tarafından verilen şifre |
CheckKey (string) |
Kontrol anahtarı (DealerCode + "MK" + Username + "PD" + Password) bilgileriyle elde edilen anahtar SHA-256 hash algoritmasından geçirilerek bu alanda gönderilecektir
|
DealerCustomerRequest
Parametre
|
Açıklama
|
CustomerCode (string) |
Bayi tarafında müşteriyi tanımlayacak Unique kod/numara (Max 100 chars) |
Password (string) |
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 (string) |
Müşterinin adı (Max 50 chars) |
LastName (string) |
Müşterinin soyadı (Max 50 chars) |
Gender (integer) |
Müşterinin cinsiyeti (1: erkek 2: kadın) |
BirthDate (date) |
Müşterinin doğum tarihi (YYYYMMDD formatında, örn: "19901218") |
GsmNumber (string) |
Müşterinin telefonu (Max 20 chars) |
GsmNumber (string) |
Müşterinin telefonu (Max 20 chars) |
Email (string) |
Müşterinin email’i (Max 100 chars) |
Address (string) |
Müşterinin adresi (Max 200 chars) |
Örnek İstek (JSON)
{
"DealerCustomerAuthentication": {
"DealerCode": "ELİF",
"Username": "Elif",
"Password": " Elif123",
"CheckKey": "aabbccddeeff"
},
"DealerCustomerRequest": {
"CustomerCode": "Customer",
"Password": "Elif1234",
"FirstName": "Elif",
"LastName": "Yetimoğlu",
"Gender": "2",
"BirthDate": "19901218",
"GsmNumber": "5301111111",
"Email": "elif.yetimoglu@moka.com",
"Address": "TAŞDELEN"
}
}
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 dönen işlem
sonucu bulunur. "Data" içinde yer alan bilgiler kontrol edilerek kayıt gerçekleştirebilirsiniz.
Parametre
|
Açıklama
|
DealerCustomerId (integer) |
Müşteri eklendiğinde, Moka’ daki Unique Id’ si döner |
CustomerCode (string) |
Bayinin, müşterisine verdiği Unique kod |
CardList [] |
ilk ekleme sonrası müşterinin kartı olmadığından bu liste boş gelecektir
|
Başarılı Sonuç Örneği
{
"Data": {
"DealerCustomer": {
"DealerCustomerId": 1033,
"CustomerCode": "Customer",
"Password": "Elif1234",
"FirstName": "Elif",
"LastName": "Yetimoğlu",
"Gender": 2,
"BirthDate": "19901218",
"GsmNumber": "5301111111",
"Email": "elif.yetimoglu@moka.com",
"Address": "TAŞDELEN"
},
"CardListCount": 0,
"CardList": []
},
"ResultCode": "Success",
"ResultMessage": "",
"Exception": null
}
Başarısız İstek Sonucu
Gönderilen istek verileri Moka’ da başarılı bir şekilde işlenemediyse, geri dönüş nesnesinin "ResultCode" alanında alttaki tablodaki hata kodlarından birisi bulunur. "Data" nesnesi ise null olarak gelir.
ResultCode
|
Açıklama
|
DealerCustomer.AddCustomer.InvalidRequest |
Hatalı hash bilgisi |
DealerCustomer.AddCustomer.CustomerCodeAlreadyUsing |
Gönderilen müşteri kodu ile kayıt bulunmaktadır. |
DealerCustomer.AddCustomer.InvalidEmailFormat |
Geçersiz E-Posta adresi |
EX |
Beklenmeyen bir hata oluştu |
Başarısız Sonuç Örneği
{
"Data": null,
"ResultCode": "DealerCustomer.AddCustomer.CustomerCodeAlreadyUsing",
"ResultMessage": "",
"Exception": null
}