Servis Adresi
POST /PaymentDealer/GetBankCardInformation
İ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. |
BankCardInformationRequest
| Parametre |
Açıklama |
| BinNumber string |
Kredi Kart Numarasının ilk 6 hanesi |
Returns
| Parametre |
Açıklama |
| BankName string |
Bin numarasının sahibi banka (Issuer Bank) – Altta listesi mevcut |
| BankCode string |
Bankanın ulusal kodu – Alttaki listede mevcut |
| BinNumber string |
Servise verilen Bin numarası |
| CardName string |
Kartın özel ismi varsa bu alanda yazar |
| CardType string |
MASTER, VISA, MAESTRO, AMEX, TROY olarak döner |
| CreditType string |
CreditCard veya DebitCard olarak döner. |
| CardLogo string |
Kartın program logosu döner. (Bonus logosu, Axess logosu vs.) |
| CardTemplate string |
Kartın görseli döner |
| ProductCategory string |
Kartın Ticari veya Bireysel bilgisi döner |
| GroupName string |
Kartın program ismi döner. (BONUS, AXESS, WORLD, CARDFINANS vs.) |
Örnek İstek (JSON)
{
"PaymentDealerAuthentication":{
"DealerCode":"XXXX",
"Username":"XXXX",
"Password":"XXXX",
"CheckKey":"28ba1f316e661ee7a0477a13aa30613da548c94a8098829af9255b04d7e916e3"
},
"BankCardInformationRequest":{
"BinNumber":" 526911"
}
}
Başarılı İstek Sonucu
Gönderilen istek verileri Ruut’ da başarılı bir şekilde işlenmişse, geri dönüş nesnesinin
"ResultCode" alanında "Success" bilgisi yazar. "Data" alanında ise bankadan dönen işlem
sonucu bulunur. "Data" içinde yer alan "IsSuccessful" (true/false) alanı kontrol edilerek
işlemin durumu kontrol edilir. Bu alanda false dönmesi durumunda aynı nesne içindeki
ResultCode ve ResultMessage alanları kontrol edilerek işlemin sanal pos üzerinde neden
başarısız olduğu görülebilir.
Başarılı Sonuç Örneği
{
"Data":{
"BankName":"FİNANSBANK",
"BankCode":"111",
"BinNumber":"526911",
"CardName":"",
"CardType":"MASTER",
"CreditType":"CreditCard",
"CardLogo":"https://cdn.ruutapp.com/Content/BankLogo/CARDFINANS.png",
"CardTemplate":"https://cdn.ruutapp.com/Content/BankCardTemplate/FINANS-MASTER-CREDIT.png",
"ProductCategory":"Bireysel",
"GroupName":"CARDFINANS"
},
"ResultCode":"Success",
"ResultMessage":"",
"Exception":null
}
Başarısız İstek Sonucu
| ResultCode | Açıklama |
|---|
| Dealer.CheckPaymentDealerAuthentication.InvalidRequest | CheckKey hatalı ya da nesne hatalı ya da JSON bozuk olabilir. |
| Dealer.CheckPaymentDealerAuthentication.InvalidAccount | Böyle bir bayi bulunamadı. |
| PaymentDealer.GetBankCardInformation.DealerNotAllowed | Bu bayinin izni yok. |
| PaymentDealer.GetBankCardInformation.BinNumberNotFound | Bin numarası bulunamadı. |
| EX | Beklenmeyen bir hata oluştu |
Başarısız Sonuç Örneği
{
"Data":null,
"ResultCode":"PaymentDealer.GetBankCardInformation.BinNumberNotFound",
"ResultMessage":"",
"Exception":null
}
ISSUER BANKA LİSTESİ
