Komisyon Listeleme ve Tutar Hesaplama
Bu servis, belirli bir tutar için banka ve kart programlarına göre komisyon ve ödeme detaylarını hesaplar.
Komisyon Listeleme Servisi İstek Modeli
| Method | Endpoint | Body |
|---|---|---|
| GET | /external/vpos/v1/commissions?amount=12402.10 | - |
Query Parametreleri
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| amount | number | Hayır | Ödeme tutarı, en fazla 2 ondalık. Gönderilmezse yalnızca oranlar döner, tutar alanları 0 olur. |
Cevap Parametreleri
| Alan | Tip | Açıklama |
|---|---|---|
| bankName | string | Banka adı |
| cardProgramName | string | Kart program adı |
| bankImage | string | Banka logosu URL'si |
| cardProgramImage | string | Kart program logosu URL'si |
| installments[] | array | Taksit bilgileri listesi |
Taksit Bilgileri Parametreleri
| Alan | Tip | Açıklama |
|---|---|---|
| installment | number | Taksit sayısı |
| merchantCommission | number | Üye işyeri komisyon oranı |
| customerCommission | number | Müşteri komisyon oranı |
| commissionOption | string | Komisyon seçeneği (MERCHANT/CUSTOMER) |
| amountPerInstallment | number | Her taksit için ödeme tutarı |
| totalAmount | number | Toplam ödeme tutarı |
| netAmount | number | Üye işyerine yatacak net tutar |
Örnek Cevap JSON
Komisyon ve tutar hesaplama örnek cevabı
12345678910111213141516171819202122232425262728
Her banka ve kart programı için farklı komisyon ve ödeme detayları hesaplanır.
Tutar Hesaplama
amount gönderildiğinde her taksit için tutarlar şöyle hesaplanır (2 ondalığa yuvarlanır):
- commissionOption = CUSTOMER: komisyonu kart sahibi öder. totalAmount = amount + amount × customerCommission / 100, netAmount = amount.
- commissionOption = MERCHANT: komisyonu üye işyeri öder. totalAmount = amount, netAmount = amount − amount × merchantCommission / 100.
- amountPerInstallment = totalAmount / installment.
CUSTOMER seçeneğinde vade farkını ödeme kuruluşu ekler ve kart sahibinden totalAmount çekilir. Ödeme isteğinde amount olarak her zaman komisyonsuz tutarı gönderin; totalAmount'u gönderirseniz vade farkı iki kez eklenir. Müşteriye ödemeden önce totalAmount'u gösterin. Ödeme sayfası (checkout) bunu kendisi gösterir.
