Admin Faturalandırma API'si

Abonelikleri yönetmek, geliri görüntülemek, iadeleri işlemek ve kuponları yönetmek için yalnızca yöneticilere açık uç noktalar. Instance admin kimlik doğrulaması gerektirir.

Abonelikler

Tüm Abonelikleri Listele

GET /api/admin/subscriptions/?offset=0&per_page=20

Abonelik Detayı Al

GET /api/admin/subscriptions/{subId}/

Gelir

Gelir Özeti

GET /api/admin/revenue/

Yanıt:

{
  "active_subscriptions": 42,
  "trial_subscriptions": 5,
  "mrr": 4195000,
  "revenue_30d": 8390000,
  "revenue_7d": 2097500,
  "currency": "TRY"
}

Tüm parasal değerler kuruş cinsindendir (1 TRY = 100 kuruş). Görüntülemek için 100'e bölün.

Ödemeler

Tüm Ödemeleri Listele

GET /api/admin/payments/?offset=0&per_page=20

Bir Ödemeyi İade Et

POST /api/admin/payments/{paymentId}/refund/

İstek Gövdesi:

{
  "amount": 0
}

amount: 0 = tam iade. Aksi takdirde tutarı kuruş cinsinden belirtin.

Faturalar

Tüm Faturaları Listele

GET /api/admin/invoices/?offset=0&per_page=20

Fatura Detayı Al

GET /api/admin/invoices/{invoiceId}/

Kuponlar

Aktif Kuponları Listele

GET /api/admin/coupons/

Kupon Oluştur

POST /api/admin/coupons/

İstek Gövdesi:

{
  "code": "WELCOME20",
  "discount_type": "percent",
  "discount_value": 20,
  "max_redemptions": 100,
  "valid_from": "2026-04-01T00:00:00Z",
  "valid_until": "2026-12-31T23:59:59Z"
}

Alan	Tür	Açıklama
discount_type	string	percent (0-100) veya fixed (kuruş)
discount_value	integer	İndirim tutarı
max_redemptions	integer	0 = sınırsız
applies_to_plans	string[]	Boş = tüm planlar

Kuponu Sil

DELETE /api/admin/coupons/{couponId}/

Yapılandırma

Faturalandırma Yapılandırması

GET /api/admin/subscription-config/

Ödeme sağlayıcı durumunu (PayTR, Stripe, Iyzico), deneme yapılandırmasını, tahsilat (dunning) yapılandırmasını ve fatura ayarlarını döner.