BIN’e Göre Taksit/Komisyon

Endpoint: /pws/paymentOptions/{binNumber}

Route Parametreleri

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

Query Parametreleri

Parametre	Tip	Zorunlu	Açıklama
currency	string	Evet	Para birimi (örn. TRY)
paymentSetId	string (GUID)	Evet	Ödeme seti kimliği
amount	number	Hayır	(Varsa) tutara bağlı kuralların değerlendirilmesi için işlem tutarı

Örnek İstek

Method: GET
Authorization: Bearer {AccessToken}
URL: https://pgw.netahsilatdemo.com/pws/paymentOptions/415565?currency=TRY&paymentSetId=504978bf-bebd-40c5-89aa-b76f3a20341c&amount=1

Response Yapısı

Kök seviyede genel kurallar ve poses listesi bulunur.

Kök Alanlar

Alan	Tip	Açıklama
commApplyTypeId	int	Komisyon uygulama tipi ID
installmentLowerLimit	number	(Varsa) taksit alt limiti
threeDLimit	number	(Varsa) 3D Secure zorunluluk limiti
poses	array	Uygun POS listesi
generalInstallmentLimit	number/null	Genel taksit limiti (varsa)

POS Alanları

Alan	Tip	Açıklama
paymentSetPosId	string (GUID)	Ödeme seti-POS ilişkisi kimliği
tenantPosId	string (GUID)	Tenant POS kimliği
vPosApiId	int	Sanal POS/VPOS API kimliği
threeDStatus	int	3D Secure durumu (sistem tanımına göre)
isCvvUse	boolean	CVV kullanımı gerekli mi
isDefaultPos	boolean	Varsayılan POS mu
name	string	POS adı
logo	object	Logo bilgileri
commRates	array	Taksit/komisyon listesi (aşağıdaki tablo)
posCurrencyDefinitionId	string (GUID)	POS para birimi tanım kimliği
creditCardTypeId	int	Kart tipi ID
creditCardProgramId	int	Kart program ID
isBusinessCard	boolean	Ticari kart mı
savedCreditCardUseCvv	boolean	Kayıtlı kartta CVV istenir mi
hasCampaign	boolean	Kampanya var mı
partnerApiDefinition	int/null	Entegre partner API tanımı (varsa)
binFilterId	string/null	BIN filtre kimliği (varsa)
maxMaturityDayCount	int	Maksimum vade günü
posTypeId	int	POS tipi ID
nonBinPos	boolean	BIN’e özgü olmayan POS (genel)

Taksit/Komisyon Alanları

Alan	Tip	Açıklama
id	string (GUID)	Oran kaydı kimliği
processCommRate	number	Komisyon oranı (yüzde)
installment	int	Taksit sayısı
paymentDeferral	int	Erteleme (gün/ay vb. sistem tanımına göre)
plusInstallment	int	Ek taksit
isRequiredCampaign	boolean	Kampanya zorunlu mu

Örnek Response

{  
    "commApplyTypeId": 10,  
    "installmentLowerLimit": 0.00,  
    "threeDLimit": 0.00,  
    "poses": [  
        {  
            "paymentSetPosId": "ab1c9260-00f5-4739-b5d3-3f1d902a2a14",  
            "tenantPosId": "384badef-11ec-ee11-98f2-005056b0d2e5",  
            "vPosApiId": 4200,  
            "threeDStatus": 1,  
            "isCvvUse": true,  
            "isDefaultPos": true,  
            "name": "QnbFinansBank Yeni",  
            "logo": {  
                "id": "00000000-0000-0000-0000-000000000000",  
                "colorCode": "#d0d0d0",  
                "isDefault": true,  
                "logoSmall": "~/Content/themes/base/images/apilogo/diger/kart.png",  
                "logoMedium": null,  
                "logoBig": null,  
                "installmentCellColor": "#e9e9e9"  
            },  
            "commRates": [  
                {  
                    "id": "a6774569-cda9-f011-98fc-005056b0d2e5",  
                    "processCommRate": 0.00,  
                    "installment": 1,  
                    "paymentDeferral": 0,  
                    "plusInstallment": 0,  
                    "isRequiredCampaign": false  
                }  
            ],  
            "posCurrencyDefinitionId": "8e6cc739-83e0-4af5-accf-a55476e758c6",  
            "creditCardTypeId": 20,  
            "creditCardProgramId": 40,  
            "isBusinessCard": false,  
            "savedCreditCardUseCvv": false,  
            "hasCampaign": false,  
            "partnerApiDefinition": null,  
            "binFilterId": null,  
            "maxMaturityDayCount": 0,  
            "posTypeId": 10,  
            "nonBinPos": true  
        },  
        {  
            "paymentSetPosId": "43ff0d6e-5649-4150-a164-e1f52465ff65",  
            "tenantPosId": "91cabf3e-ff9e-ee11-98ef-005056b0d2e5",  
            "vPosApiId": 12030,  
            "threeDStatus": 3,  
            "isCvvUse": true,  
            "isDefaultPos": false,  
            "name": "Param CardFinans 10738 ",  
            "logo": {  
                "id": "0195c327-4425-ed11-98e1-005056b0d2e5",  
                "colorCode": "#ffffff",  
                "isDefault": true,  
                "logoSmall": "~/Content/themes/base/images/apilogo/finansbank/cardfinans.png",  
                "logoMedium": null,  
                "logoBig": null,  
                "installmentCellColor": "#dcc0d8"  
            },  
            "commRates": [  
                {  
                    "id": "c92b5dd2-e7af-f011-98fc-005056b0d2e5",  
                    "processCommRate": 1.7500,  
                    "installment": 1,  
                    "paymentDeferral": 0,  
                    "plusInstallment": 0,  
                    "isRequiredCampaign": true  
                },  
                {  
                    "id": "e12b5dd2-e7af-f011-98fc-005056b0d2e5",  
                    "processCommRate": 5.0000,  
                    "installment": 3,  
                    "paymentDeferral": 0,  
                    "plusInstallment": 0,  
                    "isRequiredCampaign": true  
                }  
            ],  
            "posCurrencyDefinitionId": "8e6cc739-83e0-4af5-accf-a55476e758c6",  
            "creditCardTypeId": 20,  
            "creditCardProgramId": 40,  
            "isBusinessCard": false,  
            "savedCreditCardUseCvv": false,  
            "hasCampaign": true,  
            "partnerApiDefinition": 400,  
            "binFilterId": null,  
            "maxMaturityDayCount": 0,  
            "posTypeId": 20,  
            "nonBinPos": true  
        }  
    ],  
    "generalInstallmentLimit": null  
}

Örnek cURL

curl --location 'https://pgw.netahsilatdemo.com/pws/paymentOptions/41556501111?currency=TRY&paymentSetId=504978bf-bebd-40c5-89aa-b76f3a20341c&amount=1' \  
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzY29wZSI6WyJwd3N2MS5hcGkiLCJlcnB2MS5hcGkiLCJjYXR2MS5hcGkiLCJ2ZW5kb3J2MS5hcGkiXSwiYWN0b3J0Ijoic2VydmljZSIsInJvbGUiOiJzZXJ2aWNlIiwiVW5pcXVlIjoiZmU2OGQ5ZjEtMjYyNy00NTdlLThkMmUtNDJkNGMyM2JhZTlhIiwiVGVuYW50SWQiOiI2NzA2ODNjMS0yZmUwLTQ4NDYtODdiMi02Y2JhOWI3OTNhYjIiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL2V4cGlyYXRpb24iOiI2Mzg5Njk2OTI3Mjg4NTEwMjYiLCJuYmYiOjE3NjExOTk2NzIsImV4cCI6MTc2MTM3MjQ3MiwiaWF0IjoxNzYxMTk5NjcyLCJpc3MiOiJzc28uYXBpIiwiYXVkIjoiZWNvenVtLnNzbyJ9.HXpxywhXCFfGclnFEBpOTOCdihT7ftMPyWtQEv2_Oak'

Notlar & En İyi Uygulamalar

• BIN kullanımı: /pws/paymentOptions/{binNumber} çağrısında BIN, kart program/banka eşleşmesine göre POS’ları filtreler.
• Tutar bazlı kurallar: amount gönderildiğinde kampanya/limit kuralları (varsa) buna göre değerlendirilebilir.
• Görsel alanlar: colorCode, logo, installmentCellColor gibi alanlar UI amaçlıdır; iş mantığına etki etmez.
• Komisyon gösterimi: isVisibleCommRate=false ise oranlar UI’da gizlenebilir; API yine de oranları dönebilir.
• Ödeme seti senkronu: paymentSetId ile POS/komisyonlar ödeme setindeki tanımlara göre döner; kapalı POS’lar/ayarsız taksitler listede görünmeyebilir.