Service Address
/DealerCustomer/GetCustomer
Request Parameters
DealerCustomerAuthentication
Parameter |
Explanation |
DealerCode(string) |
Dealer code issued by the Moka system |
Username (string) |
Api username given by Moka system |
Password (string) |
Api password given by Moka system |
CheckKey (string) |
The control key (DealerCode + "MK" + Username + "PD" + Password) is created by passing this information, combined as a String, through the SHA-256 hash algorithm.
Click here to go to the trial screen. |
DealerCustomerRequest
Parameter |
Explanation |
DealerCustomerId (integer) |
It is the Customer's Unique Id in Moka. Not required if CustomerCode is sent. This customer's information will be displayed. |
CustomerCode (string) |
Unique code given by the dealer to its customer. Not required if DealerCustomerId is sent. This customer's information will be seen. |
Sample Request (JSON)
{
"DealerCustomerAuthentication": {
"DealerCode": "xxx",
"Username": "xxx",
"Password": "xxx",
"CheckKey": "aabbccddeeff"
},
"DealerCustomerRequest": {
"DealerCustomerId": "",
"CustomerCode": "Customer"
}
}
Successful Request Result
If the sent request data has been processed successfully in Moka, "Success" information is written in the "ResultCode" field of the return object . The "Data" field contains the result of the returned operation. You can continue your flows by checking the information in "Data" .
Parameter |
Explanation |
DealerCustomerId (integer) |
It is the Customer's Unique Id in Moka. |
CustomerCode (string) |
Unique code given by the dealer to its customer. |
Password (string) (optional) |
When the customer wants to withdraw from his stored card, if the dealer wants the customer's password to be asked, the customer's own password is entered in this field.
|
FirstName (optional) (string) |
If the customer is to be registered in the Moka system for the first time, the customer's name is entered. |
LastName (string) (optional) |
If the customer is to be registered in the Moka system for the first time, the customer's surname is entered. |
Gender (integer) (optional) |
If the customer is to be registered in the Moka system for the first time, the gender of the customer is entered. 1: male 2: female |
BirthDate (date) (optional) |
If the customer is to be registered in the Moka system for the first time, the date of birth of the customer is entered. |
GsmNumber (string) (optional) |
If the customer is to be registered in the Moka system for the first time, the customer's mobile phone is entered. |
Email (string) (optional) |
If the customer is to be registered in the Moka system for the first time, the customer's email address is entered. |
Address (string) (optional) |
If the customer is to be registered in the Moka system for the first time, the customer's residential address is entered. |
CardListCount (integer) |
The number of the customer's stored cards. "0" |
CardList (Array) |
With this service, the customer's cards are not returned. |
Successful Result Example
{
"Data": {
"DealerCustomer": {
"DealerCustomerId": 1033,
"CustomerCode": "Customer",
"Password": "Elif1234",
"FirstName": "Elif",
"LastName": "Y",
"Gender": 2,
"BirthDate": "19850710",
"GsmNumber": "5301111111",
"Email": "elif.y@moka.com",
"Address": "TAŞDELEN"
},
"CardListCount": 0,
"CardList": []
},
"ResultCode": "Success",
"ResultMessage": "",
"Exception": null
}
Failed Request Result
If the sent request data could not be processed in Moka streams, the "ResultCode" field of the return object contains one of the error codes in the table below.
When an unexpected software error occurs, EX is written in the "ResultCode" field and the error message (Exception) is displayed in the "ResultMessage" field
In both cases, the "Data" object arrives as null.
ResultCode |
Explanation |
DealerCustomer.GetCustomer.InvalidRequest | The CheckKey may be bad, or the object may be bad, or the JSON may be corrupt |
DealerCustomer.GetCustomer.CustomerCodeOrDealerCustomerIdMustBeGiven | Customer code or dealer customer id must be entered.. |
DealerCustomer.GetCustomer.DealerCustomerNotFound | No dealer customer found. |
DealerCustomer.GetCustomer.CustomerCodeDoesntMatchDealerCustomerId | The customer code and the dealer customer ID do not match. |
EX | An unexpected error has occurred |
Example of Failed Result
{
"Data": null,
"ResultCode": "DealerCustomer.GetCustomer.CustomerCodeOrDealerCustomerIdMustBeGiven",
"ResultMessage": "",
"Exception": null
}