BIN Bazlı POS Listeleme

• Endpoint: /vpws/paymentOptions/{binNumber}
• HTTP Method: GET
• Request Content-Type: application/json
• Response Content-Type: application/json
• Yetkilendirme: Geçerli AccessToken zorunludur.
  (Bkz: 2. Kimlik Doğrulama – AccessToken Alınması)

Açıklama

Bu servis, belirtilen BIN numarasına (kartın ilk 6 veya 8 hanesi) göre, bayiye tanımlı ve ilgili para birimiyle uyumlu POS'ları listeler.

Servis çıktısı

• Kart programı/banka eşleşmesine göre filtrelenmiş POS'lar
• Taksit ve komisyon oranları
• Tutar bazlı kurallar (amount parametresi gönderilmişse)
• POS ve partner bilgileri

Not: BIN bazlı çağrılarda, kart programı ve banka uyumsuz POS'lar listede yer almaz.

Route Parametreleri

Parametre	Tip	Zorunlu	Açıklama
binNumber	string	Evet	Kart BIN numarası (6 veya 8 hane, baştaki sıfırlar korunmalıdır)

Query Parametreleri

Parametre	Tip	Zorunlu	Açıklama
currency	string	Evet	ISO 4217 para birimi kodu (örn: TRY, USD, EUR)
amount	number	Hayır	İşlem tutarı. Kampanya/limit kuralları değerlendirmesi için kullanılır

Örnek İstek

Method: GET
Authorization: Bearer {AccessToken}
URL: https://api/vpws/paymentOptions/415565?currency=TRY&amount=1500

Header Bilgileri

Header Adı	Zorunlu	Açıklama
Authorization	Evet	Bearer {AccessToken}
Content-Type	Hayır	application/json

Response (Yanıt) Yapısı

Servis, 3.1'deki yapıyla aynı formatta POS listesi (array) döner. Ancak liste, gönderilen BIN numarasına göre filtrelenmiş olur.

POS Alanları

Alan	Tip	Açıklama
name	string	POS adı
colorCode	string	UI renk kodu
logo	object	Logo bilgileri
commRates	array	Taksit ve komisyon oranları
isVisibleCommRate	boolean	Komisyon oranı UI'da gösterilsin mi
isDefaultPos	boolean	Varsayılan POS mu
posTypeId	int	POS tipi kimliği
partnerId	int	Entegre partner sistem kimliği

Taksit / Komisyon Alanları (commRates[])

Alan	Tip	Açıklama
installment	int	Taksit sayısı
commApplyTypeId	int	Komisyon uygulama tipi
processCommRate	number	Komisyon oranı (%)
plusInstallment	int	Ek taksit
paymentDeferral	int	Erteleme süresi

Örnek cURL

curl --location 'https://pgw.netahsilatdemo.com/vpws/paymentOptions/415565?currency=TRY&amount=1500' \
--header 'Authorization: Bearer {AccessToken}'

Notlar & En İyi Uygulamalar

• BIN numarası 6 veya 8 hane olmalıdır.

• BIN gönderilmezse 400 – P001 hatası döner.

• currency parametresi zorunludur.

• amount parametresi gönderilirse kampanya ve limit kuralları buna göre değerlendirilir.

• BIN ile uyumsuz POS'lar listelenmez.

• commRates boş dönebilir; bu durum POS'un tek çekim desteklediğini gösterebilir.

• İşlem başlatmadan önce BIN bazlı kontrol yapılması önerilir.