Taksit Listeleme
POST
/partner/1.0/pos/installment/listGerekli scope:
payment:inquiryBelirtilen BIN için POS komisyon yapılandırmanıza göre uygun taksit seçeneklerini listeler.
Örnek
curl -X POST https://<host>/partner/1.0/pos/installment/list \
-H "X-Api-Key: ..." \
-H "X-Timestamp: ..." \
-H "X-Signature: ..." \
-H "Content-Type: application/json" \
-d '{
"binNumber": "512754"
}'İstek Body
| Alan | Tip | Açıklama |
|---|---|---|
binNumberzorunlu | string | Kart BIN'i (ilk 6 hane). |
type | enum | Opsiyonel POS tipi filtresi. Boş ya da DEFAULT gönderilirse sanal POS (VIRTUAL) seçenekleri döner. Varsayılan: DEFAULTDEFAULTVIRTUALPHYSICALSOFTWALLETLOYALTY |
subType | enum | Opsiyonel POS alt-tipi filtresi. Kart POS'unda yalnız DEFAULT anlamlıdır. Varsayılan: DEFAULTDEFAULTBASICSTREAMINGCHARITYFOODFUEL |
amount | decimal | Şu an etkisizdir — sunucu bu alanı hesaba katmaz. Tutara göre nihai rakam için Komisyon Önizleme kullanın. |
Yanıt
| Alan | Anlamı |
|---|---|
| (dizi) | Yanıt sayfalama zarfı değil, düz dizidir; her eleman bir taksit seçeneğidir. |
installment / label | Taksit sayısı ve görünen adı. |
merchantCommissionRate / merchantForeignCommissionRate | Yerli ve yabancı kart için komisyon oranı (yüzde). |
applyType | Komisyonun kime yansıdığı: TO_CUSTOMER, TO_MERCHANT, SPLIT_EQUAL. |
currency / valor / status | Para birimi, valör (gün) ve satırın durumu. |
Örnek yanıt (content)
[
{
"label": "Tek Çekim",
"installment": 1,
"merchantCommissionRate": 2.49,
"merchantForeignCommissionRate": 2.99,
"currency": "TRY",
"valor": 1,
"applyType": "TO_CUSTOMER",
"status": "ENABLE"
},
{
"label": "3 Taksit",
"installment": 3,
"merchantCommissionRate": 3.79,
"merchantForeignCommissionRate": 4.29,
"currency": "TRY",
"valor": 1,
"applyType": "TO_CUSTOMER",
"status": "ENABLE"
}
]Hatalar
| Mesaj anahtarı | HTTP | Neden |
|---|---|---|
binnumber.required | 400 | binNumber boş gönderildi. |
İsteği Dene
İsteği Dene
Önizleme modu — değerler kod örneklerini günceller, gerçek istek atılmaz.