BIN Sorgulama

BIN sorgulamada kartın bankası, kart ailesi, kart şeması gibi kart özelliklerini sağlar.

İstenen bilgileri elde etmek için, talebinize gerekli parametreleri eklemeniz yeterlidir. API, kapsamlı ayrıntılarla yanıt verecektir.

URL

POST /api/Payment/GetCardBins

Servise gönderilmesi gereken parametreler şu şekildedir:

Parametre	Tip	Uzunluk	Zorunluluk	Açıklama
id	int	4	Hayır	Kartın Id değeri
bin	string	8	Evet	Komisyon sorgulanacak bin numarası
bankCode	string	4	Hayır	Banka kodu

Servisten dönmesi gereken parametreler şu şekildedir:

Parametre	Tip	Uzunluk	Açıklama
isSuccess	boolean	-	İşlem başarılı (true) ; işlem başarısız (false) bilgisi döner
message	string	255	isSuccess: true olması durumunda "İşlem başarılıdır." ; false olması durumunda alınan hata mesajı gelmektedir.
errorCode	int	255	isSuccess: true olması durumunda null ; false olması durumunda alınan hata codu gelmektedir.
requestId	string	64	Sistem tarafından isteğe ait unique ID bilgisidir.
data	array	-	Dizi olarak aşağıdaki parametreler dönmektedir
id	int	4	Kartın Id bilgisi
bankCode	string	4	Banka kodu
bankName	string	64	Kart bankası
cardRangeStart	string	8	Kart bin aralığı başlangıcı
cardRangeEnd	string	8	Kart bin aralığı bitişi
cardNumberLen	string	16	Kart numarası uzunluğu
paymentSystem	string	1	Ödeme sistemi tipi
paymentSystemName	string	64	Ödeme sistemi tipi adı
cardType	string	1	Kart tipi bilgisi. C: Kredi kartı, D: Debit kart, P: Prepaid kart
cardTypeName	string	64	Kart tipi adı (Kredi Kartı, Banka Kartı, vb.)
cardSubType	string	1	Kartın alt tipi
cardSubTypeName	string	64	Kartın alt tipinin adı
brandCode	string	03	Kart aile kodu
brandName	string	16	Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu aile.
urlBankLogo	string	255	Bankanın logosuna ait url bilgisi
urlCardBrandLogo	string	255	Kart markasına ait logonun url bilgisi
urlCardAssociationLogo	string	255	Kartın alt tipine ait logonun url bilgisi

Örnek JSON formatında istek aşağıdaki gibidir:

İstek

{
    "id": 8010,
    "bin" : 65017000,
    "bankCode" : 0015
}

Örnek JSON formatında cevap aşağıdaki gibidir:

Cevap

{
    "isSuccess": true,
    "message": "İşlem başarılıdır.",
    "errorCode": null,
    "requestId": "ef0a3b0b-b051-4417-95ef-863cbcaf9da9",
    "data": [
        {
            "id": 8010,
            "bankCode": "0015",
            "bankName": "Türkiye Vakıflar Bankası T.A.O.",
            "cardRangeStart": "65017000",
            "cardRangeEnd": "65017099",
            "cardNumberLen": "16",
            "paymentSystem": "T",
            "paymentSystemName": "TROY",
            "cardType": "B",
            "cardTypeName": "Kredi Kartı",
            "cardSubType": "A",
            "cardSubTypeName": "Classic",
            "brandCode": "010",
            "brandName": "World",
            "urlBankLogo": "https://cdn.ahlpay.com.tr/vpos/banks/0015.png",
            "urlCardBrandLogo": "https://cdn.ahlpay.com.tr/vpos/brands/010.png",
            "urlCardAssociationLogo": "https://cdn.ahlpay.com.tr/vpos/associations/T.png"
        }
    ]
}