İade & Tekrar

Tekrarlı Ödemeler

Abonelik ve tekrarlı tahsilat oluşturun. YucePay saklı kartla belirlediğiniz sıklıkta otomatik tahsilat yapar; başarısız denemeleri yeniden dener.

POST/api/RecurringPaymentX-Api-Key

Tekrarlı tahsilat saklı kart (cardStorageId) gerektirir. Önce Kart Saklama ile kartı token'layın, sonra aboneliği oluşturun.

İstek Gövdesi

Alan	Tip		Açıklama
customerId	guid	zorunlu	Müşteri kimliği
cardStorageId	guid	zorunlu	Saklı kart kimliği
subscriptionName	string	zorunlu	Abonelik adı (1–200)
amount	decimal	zorunlu	Her dönem tahsil edilecek tutar
currency	string	zorunlu	TRY / USD / EUR / GBP
frequency	string	zorunlu	daily, weekly, monthly, quarterly, annually
frequencyInterval	int	opt	Sıklık çarpanı (varsayılan 1)
startDate	datetime	zorunlu	İlk tahsilat tarihi
endDate	datetime	opt	Bitiş tarihi
maxPaymentCount	int	opt	Toplam tahsilat sayısı
totalAmountLimit	decimal	opt	Azami toplam tutar
maxRetryAttempts	int	opt	Başarısız deneme limiti (0–10, vars. 3)
retryIntervalHours	int	opt	Denemeler arası saat (vars. 24)
hasTrialPeriod / trialPeriodDays / trialAmount	bool/int/decimal	opt	Deneme dönemi ayarları

Abonelik Yönetimi

Duraklat	POST /api/RecurringPayment/{id}/pause
Devam ettir	POST /api/RecurringPayment/{id}/resume
İptal et	POST /api/RecurringPayment/{id}/cancel
İşlem geçmişi	GET /api/RecurringPayment/{id}/transactions

Sıklık Değerleri

daily weekly monthly quarterly annually

Önceki← İade Yönetimi SonrakiWebhook Yönetimi →

POST /api/RecurringPayment

curl -X POST https://api.yucepay.com/api/RecurringPayment \
  -H "X-Api-Key: pk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "a1b2c3d4-...",
    "cardStorageId": "d41f-...",
    "subscriptionName": "Premium Üyelik",
    "amount": 99.90,
    "currency": "TRY",
    "frequency": "monthly",
    "frequencyInterval": 1,
    "startDate": "2026-09-01T00:00:00Z",
    "maxRetryAttempts": 3,
    "retryIntervalHours": 24,
    "sendEmailNotification": true
  }'

var body = new {
    customerId = "a1b2c3d4-...",
    cardStorageId = "d41f-...",
    subscriptionName = "Premium Üyelik",
    amount = 99.90m, currency = "TRY",
    frequency = "monthly", frequencyInterval = 1,
    startDate = "2026-09-01T00:00:00Z",
    maxRetryAttempts = 3, retryIntervalHours = 24,
    sendEmailNotification = true
};
var res = await http.PostAsJsonAsync("https://api.yucepay.com/api/RecurringPayment", body);

<?php
$ch = curl_init('https://api.yucepay.com/api/RecurringPayment');
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([
    'customerId' => 'a1b2c3d4-...', 'cardStorageId' => 'd41f-...',
    'subscriptionName' => 'Premium Üyelik', 'amount' => 99.90, 'currency' => 'TRY',
    'frequency' => 'monthly', 'frequencyInterval' => 1,
    'startDate' => '2026-09-01T00:00:00Z',
    'maxRetryAttempts' => 3, 'retryIntervalHours' => 24, 'sendEmailNotification' => true,
  ]),
]);
$response = curl_exec($ch);

const res = await fetch('https://api.yucepay.com/api/RecurringPayment', {
  method: 'POST',
  headers: { 'X-Api-Key': 'pk_live_xxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    customerId: 'a1b2c3d4-...', cardStorageId: 'd41f-...',
    subscriptionName: 'Premium Üyelik', amount: 99.90, currency: 'TRY',
    frequency: 'monthly', frequencyInterval: 1,
    startDate: '2026-09-01T00:00:00Z',
    maxRetryAttempts: 3, retryIntervalHours: 24, sendEmailNotification: true,
  }),
});

{
  "success": true,
  "message": "Abonelik oluşturuldu",
  "data": {
    "id": "f1e2...",
    "subscriptionName": "Premium Üyelik",
    "status": "Active",
    "nextPaymentDate": "2026-09-01T00:00:00Z"
  },
  "errorCode": null,
  "timestamp": "2026-08-19T10:35:00Z"
}