Kart & Taksit

Kart Saklama

Kartları token olarak saklayın ve sonraki ödemelerde yeniden kullanın. CVV asla saklanmaz (PCI-DSS); kart numarası şifreli tutulur ve yanıtlarda maskelenir.

PCI-DSS: CVV veritabanında kesinlikle saklanmaz. Saklı kartla ödeme alırken banka gerektiriyorsa CVV her seferinde yeniden istenir (forceCvv).

Kart Ekle

POST/api/cardX-Api-Key

Alan	Tip		Açıklama
cardAlias	string	zorunlu	Kartı tanımlayan takma ad
ownerName	string	opt	Kart sahibi adı
cardNumber	string	zorunlu	Şifreli saklanır, yanıtta maskeli döner
expiryMonth / expiryYear	string	zorunlu	Son kullanma (şifreli)
saveCard	bool	opt	Kartı kalıcı sakla
forceCvv	bool	opt	Her ödemede CVV iste

Diğer İşlemler

İşlem	Uç Nokta
Kart sorgula (alias/BIN)	GET /api/card/query
Kart güncelle	PUT /api/card/{id}
Kart sil	DELETE /api/card/{id}

Yanıtlarda cardNumber, expiryMonth ve expiryYear gizlenir; yalnızca maskedCardNumber (ör. 411111****1111) döner.

Önceki← Sigorta Ödemesi SonrakiTaksitler →

POST /api/card

curl -X POST https://api.yucepay.com/api/card \
  -H "X-Api-Key: pk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "cardAlias": "Ahmet - İş Kartı",
    "ownerName": "AHMET YILMAZ",
    "cardNumber": "4111111111111111",
    "expiryMonth": "12",
    "expiryYear": "28",
    "saveCard": true
  }'

var body = new {
    cardAlias = "Ahmet - İş Kartı",
    ownerName = "AHMET YILMAZ",
    cardNumber = "4111111111111111",
    expiryMonth = "12", expiryYear = "28",
    saveCard = true
};
var res = await http.PostAsJsonAsync("https://api.yucepay.com/api/card", body);

<?php
$ch = curl_init('https://api.yucepay.com/api/card');
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([
    'cardAlias' => 'Ahmet - İş Kartı', 'ownerName' => 'AHMET YILMAZ',
    'cardNumber' => '4111111111111111', 'expiryMonth' => '12', 'expiryYear' => '28',
    'saveCard' => true,
  ]),
]);
$response = curl_exec($ch);

const res = await fetch('https://api.yucepay.com/api/card', {
  method: 'POST',
  headers: { 'X-Api-Key': 'pk_live_xxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    cardAlias: 'Ahmet - İş Kartı', ownerName: 'AHMET YILMAZ',
    cardNumber: '4111111111111111', expiryMonth: '12', expiryYear: '28',
    saveCard: true,
  }),
});

{
  "success": true,
  "message": "Kart kaydedildi",
  "data": {
    "id": "d41f...",
    "cardAlias": "Ahmet - İş Kartı",
    "maskedCardNumber": "411111****1111",
    "cardType": "Visa",
    "binNumber": "411111"
  },
  "errorCode": null,
  "timestamp": "2026-08-19T10:34:00Z"
}