Kart & Taksit

Taksit Sorgulama

Kartın BIN numarasına göre firmanızın aktif bankalarındaki taksit seçeneklerini ve vade farklarını sorgular. Ödeme ekranınızda taksit tablosunu göstermek için kullanın.

POST/api/payment/installment-optionsX-Api-Key

İstek Gövdesi

Alan	Tip		Açıklama
binNumber	string	opt*	Kartın ilk 6–8 hanesi
cardNumber	string	opt*	Tam kart numarası (BIN otomatik çıkarılır)
amount	decimal	opt	Aylık tutar/toplam hesaplaması için

*binNumber veya cardNumber'dan biri gönderilmelidir.

Yanıt

Yanıt; tespit edilen banka, kart tipi ve kart programı (ör. Bonus/World/Maximum) ile birlikte taksit seçeneklerini içerir. Kart bankası firmanızda aktif değilse varsayılan banka oranları döner.

options[]	Açıklama
installmentCount	Taksit sayısı (1 = tek çekim)
commissionRate	Vade farkı oranı (%)
commissionBearer	Customer (vade farkı müşteriye yansır) / Merchant
monthlyAmount	Aylık taksit tutarı
totalAmount	Toplam ödenecek tutar

commissionBearer alanı Customer ise vade farkını müşteri öder (totalAmount artar); Merchant ise vade farkını siz üstlenirsiniz.

Önceki← Kartlar Sonrakiİade Yönetimi →

POST /api/payment/installment-options

curl -X POST https://api.yucepay.com/api/payment/installment-options \
  -H "X-Api-Key: pk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "binNumber": "411111",
    "amount": 1000.00
  }'

var body = new { binNumber = "411111", amount = 1000.00m };
var res = await http.PostAsJsonAsync(
    "https://api.yucepay.com/api/payment/installment-options", body);

<?php
$ch = curl_init('https://api.yucepay.com/api/payment/installment-options');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ['X-Api-Key: pk_live_xxxxxxxxxxxxxxxx','Content-Type: application/json'],
  CURLOPT_POSTFIELDS => json_encode(['binNumber' => '411111', 'amount' => 1000.00]),
]);
$response = curl_exec($ch);

const res = await fetch('https://api.yucepay.com/api/payment/installment-options', {
  method: 'POST',
  headers: { 'X-Api-Key': 'pk_live_xxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({ binNumber: '411111', amount: 1000.00 }),
});
const data = await res.json();

{
  "success": true,
  "binNumber": "411111",
  "bankName": "Örnek Banka",
  "cardType": "Kredi Kartı",
  "cardBrandName": "Bonus",
  "cardProgramName": "World",
  "options": [
    { "installmentCount": 1, "commissionRate": 0.0, "commissionBearer": "Merchant", "totalAmount": 1000.00 },
    { "installmentCount": 3, "commissionRate": 4.5, "commissionBearer": "Customer", "monthlyAmount": 348.33, "totalAmount": 1045.00 },
    { "installmentCount": 6, "commissionRate": 8.0, "commissionBearer": "Customer", "monthlyAmount": 180.00, "totalAmount": 1080.00 }
  ]
}