Bayi Bilgilerini Güncelleme

Servis Adresi

İstek Parametreleri

PaymentDealerAuthentication

Parametre Açıklama
DealerCode string Ruut sistemi tarafından verilen bayi kodu
Username string Ruut sistemi tarafından verilen Api kullanıcı adı
Password string Ruut 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.

UpdateDealerRequest

Parametre Açıklama
SubDealerCode string Güncellenmek istenen alt bayinin Ruut sistemindeki kodu
DealerType integer Bayinin tipi
1 :Gerçek Kişi(Vergi Levhası olmayan),
2 :Tüzel Kişi (Ltd.A.Ş),
3: Tüzel Kişi (Şahıs Firması) (Zorunlu)
TRIdentityNumber string Tc Kimlik Numarası (11 hane).
IndividualName string Ad Soyad (max 50 chars).
TaxNumber string Vergi Numarası (10 hane).
CompanyName string Firma Adı (max 100 chars).
ContactName string Yetkili Adı (max 50 chars).
Email string Bayi email adresi (max 100 chars).
PhoneNumber string Bayi telefon numarası (5351112233 formatında).
CityCode integer Bayinin bulunduğu şehrin plaka kodu.
CountryCode integer Bayinin bulunduğu ülkenin kodu, 212:Türkiye, 232:Kıbrıs, değer verilmezse default 212 atanır.
Address string Bayinin açık adresi (Mah.,Cad.,Sok.,Daire bilgileri). (max 200 chars)
IBanFullName string Paranın yatırılacağı hesap sahibinin adı soyadı.
IBan string Paranın yatırılacağı banka hesap numarasıdır. (TR yazılmadan 24 Hane olacak şekilde gönderilmesi gerekmektedir. ÖRN: 112233445566778899001122)
BlockedDayNumber integer Bayinin parasının ne kadar süre sonra yatıralacağının bilgisidir.Örneğin bu alana 1 değeri verilirse ve ödeme Pazartesi yapılmışsa para bayinin hesabına Çarşamba günü yatacaktır. Aynı senaryo için değer 4 verilirse (Çarşamba:1, Perşembe:2, Cuma:3, Cumartesi:4) para hesaba iş günü yatırılacağından dolayı Pazartesi yatırılmış olur. Bu alanın defaultu 0’dır, ertesi gün yatacak demektir.
PaymentDaysOfWeek string Haftanın hangi günlerinde bu bayiye ödeme yapilacak?(0: Bu değer gönderilince alan sıfırlanacak, 1: Pazartesi, 2: Salı, 3: Çarşamba, 4: Perşembe, 5: Cuma, ‘1,2,3,4,5 değerleri aralarına virgül konarak aynı anda gönderilebilir.’
RuutPosProposalTemplateLimitId integer Ruut’ nın size vereceği bir ID dir. Bayinin limitlerini tanımlanmasını sağlar.
RuutPosProposalRateId integer Ruut’ nın size vereceği bir ID dir. Bayinin komisyon oranlarının tanımlanmasını sağlar.
NOT: TRIdentityNumber ve IBan parametrelerinin doğruluğu yapılmaktadır.Geçerli Iban ve TC kimlik numarası göndermeniz gerekmektedir.

Returns

Parametre Açıklama
DealerId integer Bayinin Ruut sistemindeki ID si
DealerCode string Güncellenmek istenen alt bayinin Ruut sistemindeki kodu
DealerName string Bayinin adı
DealerType integer Bayinin tipi
1 :Gerçek Kişi(Vergi Levhası olmayan),
2 :Tüzel Kişi (Ltd.A.Ş),
3: Tüzel Kişi (Şahıs Firması) (Zorunlu)
Title string Bayinin ünvanı
ContactName string Bayinin yetkili kişi ismi
PhoneNumber string Bayinin veya yetkili kişinin telefonu
Email string Bayinin veya yetkili kişinin email adresi
TRIdentityNumber string Tc Kimlik Numarası (11 hane)
IsThreeDRequired bool Bu bayi için 3D ödeme zorunlu mu ? (True, False)
TaxNumber string Vergi Numarası (10 hane)
PaymentDaysOfWeek string Haftanin hangi günlerinde bu bayiye ödeme yapılacak? (0: Bu değer gönderilince alan sıfırlanacak. 1: Pazartesi, 2: Salı, 3: Çarşamba, 4: Perşembe, 5: Cuma, ‘1,2,3,4,5 değerleri aralarına virgül konarak aynı anda gönderilebilir.’)
BlockedDayNumber integer Bayinin parasının ne kadar süre sonra yatıralacağının bilgisidir. Örneğin bu alana 1 değeri verilirse ve ödeme Pazartesi yapılmışsa para bayinin hesabına Çarşamba günü yatacaktır. Aynı senaryo için değer 4 verilirse (Çarşamba:1, Perşembe:2, Cuma:3, Cumartesi:4) para hesaba iş günü yatırılacağından dolayı Pazartesi yatırılmış olur.
Address string Açık adres alanı
CountryCode integer Bayinin bulunduğu ülkenin kodu
CityCode decimal Bayinin bulunduğu şehrin plaka kodu
Iban string Paranın yatırılacağı banka hesap numarası
IbanFullName string Paranın yatırılacağı hesap sahibinin adı ve soyadı
DailyTrxAmountLimit decimal Günlük ödeme yapma tutar limiti (TL cinsinden)
DailyTrxNumberLimit integer Günlük ödeme yapma adet limiti
DailyTrxAmountLimitNon3D decimal Günlük Non-3D ödeme yapma tutar limiti (TL) – 3D zorunluysa
DailyTrxNumberLimitNon3D integer Günlük Non-3D ödeme yapma adet limiti – 3D zorunluysa
EachTrxAmountLimit decimal Her bir ödeme işlemi tutar limiti (TL cinsinden)
EachTrxAmountLimitNon3D decimal Her bir Non-3D ödeme işlemi tutar limiti (TL) – 3D zorunluysa
DailyCardAmountLimit decimal Günlük aynı karttan ödeme yapma tutar limiti (TL cinsinden)
DailyCardNumberLimit integer Günlük aynı karttan ödeme yapma adet limiti
DailyCardNumberAlertLimit integer Günlük aynı karttan ödeme yapma adet limiti (sadece alarm oluşur)
MonthlyTrxAmountLimit decimal Aylık ödeme yapma tutar limiti (TL cinsinden)
MonthlyTrxNumberLimit integer Aylık ödeme yapma adet limiti
MonthlyTrxAmountLimitNon3D decimal Aylık Non-3D ödeme yapma tutar limiti (TL) – 3D zorunluysa
MonthlyTrxNumberLimitNon3D integer Aylık Non-3D ödeme yapma adet limiti – 3D zorunluysa
MinTransferAmount decimal Bayi ekstresinin ödenmesi için gerekli minimum tutar.
IsRefundCommissionWillBePaid bit Bayiye iade komisyonları ödenecek mi? 0: Hayır 1: Evet
GroupName string Kartın program ismi döner. (BONUS, AXESS, WORLD vs.)
Bank string Banka isimleri
CommissionStartDate (dacetime) Bayiye uygulanılacak komisyon oranının başlangıç tarihi
CommissionRate decimal Bayiden alınacak yüzdesel komisyon oranı
CommissionAmount decimal Bayiden alınacak sabit komisyon tutarı
CommissionRateFC decimal Bayiden yabancı para çekimi için alınacak yüzdesel komisyon oranı
CommissionAmountFC decimal Bayiden yabancı para çekimi için alınacak sabit komisyon tutarı
CommissionRateDebit decimal Bayiden banka kartları için alınacak yüzdesel komisyon oranı
CommissionAmountDebit decimal Bayiden banka kartları için alınacak sabit komisyon tutarı
CommissionRateInternational decimal Bayiden yurt dışı (tanımsız binler) kartları için alınacak yüzdesel komisyon oranı
CommissionAmountInternational decimal Bayiden yurt dışı kartları(tanımsız binler) için alınacak sabit komisyon tutarı
CommissionRate2 decimal Taksit sayısı 2 olduğunda bayiden alınacak yüzdesel komisyon oranı
CommissionRate3 decimal Taksit sayısı 3 olduğunda bayiden alınacak yüzdesel komisyon oranı
CommissionRate4 decimal Taksit sayısı 4 olduğunda bayiden alınacak yüzdesel komisyon oranı
CommissionRate5 decimal Taksit sayısı 5 olduğunda bayiden alınacak yüzdesel komisyon oranı
CommissionRate6 decimal Taksit sayısı 6 olduğunda bayiden alınacak yüzdesel komisyon oranı
CommissionRate7 decimal Taksit sayısı 7 olduğunda bayiden alınacak yüzdesel komisyon oranı
CommissionRate8 decimal Taksit sayısı 8 olduğunda bayiden alınacak yüzdesel komisyon oranı
CommissionRate9 decimal Taksit sayısı 9 olduğunda bayiden alınacak yüzdesel komisyon oranı
CommissionRate10 decimal Taksit sayısı 10 olduğunda bayiden alınacak yüzdesel komisyon oranı
CommissionRate11 decimal Taksit sayısı 11 olduğunda bayiden alınacak yüzdesel komisyon oranı
CommissionRate12 decimal Taksit sayısı 12 olduğunda bayiden alınacak yüzdesel komisyon oranı

Örnek İstek (JSON) 


{
   "DealerAuthentication":{
      "DealerCode":"xxx",
      "Username":"xxx",
      "Password":"xxx",
      "CheckKey":"28ba1f316e661ee7a0477a13aa30613da548c94a8098829af9255b04d7e916e3"
   },
   "UpdateDealerRequest":{
      "SubDealerCode":"2447",
      "DealerType":1,
      "TRIdentityNumber":"68012069620",
      "IndividualName":"Zeynep Hashan",
      "TaxNumber":"1111111111",
      "CompanyName":"Ruut Ödeme Kuruluşu",
      "ContactName":"Zeynep Hashan",
      "Email":"zeynep.hashan@ruutapp.com",
      "PhoneNumber":"5455415555",
      "CityCode":"34",
      "CountryCode":"212",
      "Address":"Çekmeköy",
      "IBanFullName":"IbanName",
      "IBan":"480006214645589777765216",
      "BlockedDayNumber":"0",
      "RuutPosProposalTemplateLimitId":"14",
      "RuutPosProposalTemplateRateId":"1",
      "PaymentDaysOfWeek":"3,5"
   }
}

Başarılı İstek Sonucu

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


   "Data":{
      "DealerId":2447,
      "DealerCode":"2447",
      "DealerName":"Zeynep Hashan",
      "DealerType":1,
      "Title":"Zeynep Hashan",
      "ContactName":"Zeynep Hashan",
      "PhoneNumber":"5455415555",
      "Email":"zeynep.hashan@ruutapp.com",
      "TRIdentityNumber":"68012069620",
      "TaxNumber":"1111111111",
      "PaymentDaysOfWeek":"3,5",
      "BlockedDayNumber":0,
      "Address":"Çekmeköy",
      "CountryCode":212,
      "CityCode":34,
      "IBan":"TR480006214645589777765216",
      "IBanFullName":"IbanName",
      "DailyTrxAmountLimit":1500.00,
      "DailyTrxNumberLimit":15,
      "DailyTrxAmountLimitNon3D":5.00,
      "DailyTrxNumberLimitNon3D":100,
      "EachTrxAmountLimit":2.00,
      "EachTrxAmountLimitNon3D":20.00,
      "DailyCardAmountLimit":5.00,
      "DailyCardNumberLimit":10,
      "DailyCardNumberAlertLimit":10,
      "MonthlyTrxAmountLimit":5000.00,
      "MonthlyTrxNumberLimit":50,
      "MonthlyTrxAmountLimitNon3D":6.00,
      "MonthlyTrxNumberLimitNon3D":100,
      "MinTransferAmount":0.00,
      "IsThreeDRequired":true,
      "IsRefundCommissionWillBePaid":true,
      "CommissionList":[
         {
            "GroupName":"AXESS",
            "Bank":"4 - ",
            "CommissionStartDate":"2019-10-28T11:28:30.197",
            "CommissionRate":2.30,
            "CommissionAmount":0.00,
            "CommissionRateFC":0.00,
            "CommissionAmountFC":0.00,
            "CommissionRate2":4.47,
            "CommissionRate3":5.13,
            "CommissionRate4":5.78,
            "CommissionRate5":6.44,
            "CommissionRate6":7.09,
            "CommissionRate7":7.75,
            "CommissionRate8":8.41,
            "CommissionRate9":9.06,
            "CommissionRate10":-1.00,
            "CommissionRate11":-1.00,
            "CommissionRate12":-1.00,
            "CommissionRateDebit":-1.00,
            "CommissionAmountDebit":0.00,
            "CommissionRateInternational":-1.00,
            "CommissionAmountInternational":0.00
         },
         {
            "GroupName":"MAXIMUM",
            "Bank":"122 - ",
            "CommissionStartDate":"2019-10-28T11:28:30.197",
            "CommissionRate":2.30,
            "CommissionAmount":0.00,
            "CommissionRateFC":0.00,
            "CommissionAmountFC":0.00,
            "CommissionRate2":4.50,
            "CommissionRate3":5.00,
            "CommissionRate4":5.50,
            "CommissionRate5":6.50,
            "CommissionRate6":7.00,
            "CommissionRate7":7.50,
            "CommissionRate8":8.50,
            "CommissionRate9":9.50,
            "CommissionRate10":-1.00,
            "CommissionRate11":-1.00,
            "CommissionRate12":-1.00,
            "CommissionRateDebit":-1.00,
            "CommissionAmountDebit":0.00,
            "CommissionRateInternational":-1.00,
            "CommissionAmountInternational":0.00
         },
         {
            "GroupName":"CARDFINANS",
            "Bank":"98 - ",
            "CommissionStartDate":"2019-10-28T11:28:30.197",
            "CommissionRate":2.30,
            "CommissionAmount":0.00,
            "CommissionRateFC":0.00,
            "CommissionAmountFC":0.00,
            "CommissionRate2":4.35,
            "CommissionRate3":5.00,
            "CommissionRate4":5.95,
            "CommissionRate5":6.90,
            "CommissionRate6":7.85,
            "CommissionRate7":8.75,
            "CommissionRate8":9.70,
            "CommissionRate9":10.65,
            "CommissionRate10":-1.00,
            "CommissionRate11":-1.00,
            "CommissionRate12":-1.00,
            "CommissionRateDebit":-1.00,
            "CommissionAmountDebit":0.00,
            "CommissionRateInternational":-1.00,
            "CommissionAmountInternational":0.00
         },
         {
            "GroupName":"BONUS",
            "Bank":"168 - ",
            "CommissionStartDate":"2019-10-28T11:28:30.197",
            "CommissionRate":2.30,
            "CommissionAmount":0.00,
            "CommissionRateFC":0.00,
            "CommissionAmountFC":0.00,
            "CommissionRate2":5.00,
            "CommissionRate3":5.75,
            "CommissionRate4":6.25,
            "CommissionRate5":6.75,
            "CommissionRate6":7.25,
            "CommissionRate7":7.75,
            "CommissionRate8":8.25,
            "CommissionRate9":9.00,
            "CommissionRate10":-1.00,
            "CommissionRate11":-1.00,
            "CommissionRate12":-1.00,
            "CommissionRateDebit":-1.00,
            "CommissionAmountDebit":0.00,
            "CommissionRateInternational":-1.00,
            "CommissionAmountInternational":0.00
         },
         {
            "GroupName":"WORLD",
            "Bank":"215 - ",
            "CommissionStartDate":"2019-10-28T11:28:30.197",
            "CommissionRate":2.30,
            "CommissionAmount":0.00,
            "CommissionRateFC":0.00,
            "CommissionAmountFC":0.00,
            "CommissionRate2":5.00,
            "CommissionRate3":5.55,
            "CommissionRate4":6.50,
            "CommissionRate5":7.00,
            "CommissionRate6":7.50,
            "CommissionRate7":8.00,
            "CommissionRate8":8.50,
            "CommissionRate9":9.00,
            "CommissionRate10":-1.00,
            "CommissionRate11":-1.00,
            "CommissionRate12":-1.00,
            "CommissionRateDebit":-1.00,
            "CommissionAmountDebit":0.00,
            "CommissionRateInternational":-1.00,
            "CommissionAmountInternational":0.00
         },
         {
            "GroupName":"",
            "Bank":"0 - Genel",
            "CommissionStartDate":"2019-10-28T11:28:30.163",
            "CommissionRate":2.30,
            "CommissionAmount":0.00,
            "CommissionRateFC":0.00,
            "CommissionAmountFC":0.00,
            "CommissionRate2":-1.00,
            "CommissionRate3":-1.00,
            "CommissionRate4":-1.00,
            "CommissionRate5":-1.00,
            "CommissionRate6":-1.00,
            "CommissionRate7":-1.00,
            "CommissionRate8":-1.00,
            "CommissionRate9":-1.00,
            "CommissionRate10":-1.00,
            "CommissionRate11":-1.00,
            "CommissionRate12":-1.00,
            "CommissionRateDebit":-1.00,
            "CommissionAmountDebit":0.00,
            "CommissionRateInternational":-1.00,
            "CommissionAmountInternational":0.00
         }
      ]
   },
   "ResultCode":"Success",
   "ResultMessage":"",
   "Exception":null
}

Başarısız İstek Sonucu

ResultCodeAçıklama
Dealer.CheckDealerAuthentication.InvalidRequest CheckKey hatalı ya da nesne hatalı ya da JSON bozuk olabilir.
Dealer.UpdateDealer.MissingRequest Eksik istek bilgisi
Dealer.UpdateDealer.InvalidAccount Böyle bir bayi bulunamadı, Bayi kodu, bayi kullanıcı adı ve/veya şifresi yanlış girilmiş.
Dealer.UpdateDealer.SubDealerCodeRequired Alt bayi kodu gerekli
Dealer.UpdateDealer.DealerNotAllowed Bayinin izni yok.
Dealer.GetDealer.SubDealerNotFound Alt bayi bulunamadı.
Dealer.UpdateDealer.SubDealerCannotBeUpdated Alt bayi güncellenemiyor.
Dealer.UpdateDealer.IndividualNameIsRequired Bireysel isim gerekli.
Dealer.UpdateDealer.TRIdentityNumberIsRequired TC kimlik numarası gerekli
Dealer.UpdateDealer.InvalidTRIdentityNumber TC kimlik numarası geçersiz
Dealer.UpdateDealer.TaxNumberIsRequired Vergi numarası gerekli
Dealer.UpdateDealer.InvalidTaxNumber Vergi numarası geçersiz
Dealer.UpdateDealer.CompanyNameIsRequired Firma adı gerekli
Dealer.UpdateDealer.ContactNameIsRequired Yetkili kişinin adı gerekli
Dealer.UpdateDealer.InvalidDealerType Bayi tipi geçersiz
Dealer.UpdateDealer.InconsistentDealerType Tutarsız bayi tipi
Dealer.UpdateDealer.InvalidCompanyNameLength Geçersiz firma adı uzunluğu
Dealer.UpdateDealer.InvalidIndividualNameLength Geçersiz bireysel isim uzunluğu
Dealer.UpdateDealer.InvalidRuutPosProposalTemplateRateId Geçersiz Ruut pos teklif şablonu oranı id
Dealer.UpdateDealer.InvalidRuutPosProposalTemplateLimitId Geçersiz Ruut pos teklif şablonu limiti id
Dealer.UpdateDealer.InvalidTemplates Şablonlar geçersiz
Dealer.UpdateDealer.InvalidEmailFormat Email formatı geçersiz
Dealer.UpdateDealer.InvalidBlockedDayNumber Geçersiz blokeli gün numarası
Dealer.UpdateDealer.InvalidCityCodeOrCountryCode Geçersiz şehir kodu veya ülke kodu
Dealer.UpdateDealer.AddressIsNoMoreThan200Characters Adres bilgisi 200 karakterden fazla olmamalıdır.
Dealer.UpdateDealer.InvalidIBanFullNameLength Geçersiz Iban Fullname uzunluğu
Dealer.UpdateDealer.IBanIsFalse Iban numarası yanlış
Dealer.UpdateDealer.InvalidPaymentDaysOfWeek Haftanın ödeme günleri geçersiz
Dealer.UpdateDealer.InvalidPhoneNumber Geçersiz telefon numarası
Dealer.UpdateDealer.OperationWasInterrupted Operasyon kesintiye uğradı.
EX Beklenmeyen bir hata oluştu.

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


{
   "Data":null,
   "ResultCode":" Dealer.UpdateDealer.IBanIsFalse",
   "ResultMessage":"",
   "Exception":null
}