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) CustomerCode gönderilirse zorunlu değil
CustomerCode (string) 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 : “Bonus kartım”) (Max 50 chars)

Örnek İstek (JSON)


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

Başarılı İstek Sonucu

Parametre Açıklama
DealerCustomer Bloğu
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, FirstName, LastName, Gender,
BirthDate, GsmNumber, Email, Address
Müşterinin diğer bilgileri
CardListCount Müşterinin saklanmış kartlarının sayısı
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 : “Bonus 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: "2018")

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.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
EX Beklenmeyen bir hata oluştu

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


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