Faturalandırma¶

TEBHOS ödemeleri tek ödeme sağlayıcısı olan Polar üzerinden alır. Bu sayfadaki yollar bir Polar ödeme sayfası veya müşteri portalı oturumu açar ve URL'sini döndürür; tarayıcı satın alımı ardından Polar'ın barındırılan sayfalarında tamamlar. Bir ödeme tamamlandığında Polar TEBHOS'u bilgilendirir ve TEBHOS satın alınanı (TEBHOS Pro, Pro hediyesi, İş Sınıfı, takviyeler veya mağaza öğeleri) tanımlar. Ortaya çıkan hak durumu Premium sayfasında açıklanır.

Buradaki tüm yollar yalnızca kullanıcılara açıktır: bot token'ı 403 ACCESS_DENIED ile reddedilir. TEBHOS kart bilgilerini hiçbir zaman görmez ve saklamaz.

Yönlendirme URL'si nesnesi¶

Her ödeme ve portal yolu, tarayıcıda açılacak tek bir URL ile yanıt verir.

{
  "url": "https://checkout.example.com/polar_c_9f8e7d6c5b4a"
}

Ödeme para birimi¶

Ödeme oturumları Türk lirası (try) veya ABD doları (usd) ile açılır. Para birimi şu sırayla seçilir:

1. İstek gövdesindeki currency alanı, değeri try veya usd olduğunda (büyük/küçük harf duyarsız). Diğer değerler yok sayılır.
2. Aksi hâlde, çağıranın ülkesi Türkiye ise (CF-IPCountry başlığından veya IP konumundan) try.
3. Aksi hâlde ürünün varsayılanı (USD).

TEBHOS ayrıca ödeme sayfasını hesabın e-posta adresi ve ülkesiyle önceden doldurur ve Polar müşterisini TEBHOS kullanıcı kimliğine bağlar.

Abonelik ödemesi oluştur¶

POST /premium/checkout

TEBHOS Pro aboneliği için bir Polar ödeme sayfası açar ve bir yönlendirme URL'si nesnesi döndürür. Ödemeden sonra tarayıcı https://tebhos.com/premium/callback?status=success adresine döner.

JSON gövdesi¶

Gövde isteğe bağlıdır; gövde yoksa aylık plan kullanılır.

Yanıt¶

Örnek¶

curl -X POST "https://tebhos.com/api/v1/premium/checkout" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan":"yearly","currency":"try"}'

Hediye ödemesi oluştur¶

POST /premium/checkout/gift

Bir arkadaş için TEBHOS Pro satın alan bir Polar ödeme sayfası açar. Ödeme tamamlandığında üyelik doğrudan alıcının hesabına uygulanır (bkz. Hediyeler) ve isteğe bağlı mesaj alıcıya iletilir. Tarayıcı https://tebhos.com/premium/callback?status=gift-success adresine döner.

JSON gövdesi¶

Yanıt¶

İş Sınıfı ödemesi oluştur¶

POST /business/checkout

Tek bir sunucu için İş Sınıfı aboneliğine yönelik bir Polar ödeme sayfası açar. Yalnızca sunucu sahibi satın alabilir.

JSON gövdesi¶

Yanıt¶

Hız sınırı¶

business:checkout kovasında kullanıcı başına saatte 10 istek.

Takviye ve mağaza ödemeleri¶

İki yol daha bir ödeme URL'siyle yanıt verebilir:

• Sunucuya takviye yap (POST /servers/{guild_id}/boost) ücretsiz takviyeleri hemen uygular ve ücretli kalan kısım için bir ödeme URL'si döndürür.
• Mağaza öğesi satın al ve mağaza paketi satın al her zaman bir ödeme URL'si döndürür.

Müşteri portalı oluştur¶

POST /premium/billing-portal

Kullanıcının ödeme yöntemlerini yönettiği ve faturalarını indirdiği Polar müşteri portalı için bir yönlendirme URL'si nesnesi döndürür. Yalnızca Polar aboneliği olan hesaplar kullanabilir; Premium durumumu al yanıtındaki has_billing_account, istemciye bunu sunup sunmayacağını bildirir.

Yanıt¶

Hız sınırı¶

premium:portal kovasında kullanıcı başına saatte 20 istek.

İş Sınıfı müşteri portalı oluştur¶

POST /business/guilds/{guild_id}/billing-portal

Bir sunucunun İş Sınıfı aboneliği için Müşteri portalı oluştur ile aynıdır. Yalnızca sahip kullanabilir; sahip olmayan biri veya İş Sınıfı aboneliği olmayan bir sunucu 404 NOT_FOUND alır.

Hız sınırı¶

business:portal kovasında kullanıcı başına saatte 20 istek.

İşlemleri listele¶

GET /premium/transactions

Çağıranın Polar sipariş geçmişini sayfa başına 10 kayıt olarak döndürür. Polar aboneliği olmayan bir hesap hata yerine boş bir liste alır.

Sorgu parametreleri¶

Yanıt¶

İşlem nesnesi¶

{
  "items": [
    {
      "id": "9b2f6c1e-2d6a-4f0e-9a51-0c9d1e2f3a4b",
      "amount": 8999,
      "amount_paid": 8999,
      "refunded_amount": 0,
      "currency": "TRY",
      "status": "paid",
      "type": "subscription_create",
      "description": "TEBHOS Pro",
      "created_at": "2026-09-01T10:00:00Z",
      "period_start": null,
      "period_end": null
    }
  ],
  "total_pages": 1,
  "current_page": 1
}

Aboneliği iptal et¶

POST /premium/cancel-subscription

Çağıranın Polar aboneliğini geçerli faturalandırma döneminin sonunda bitecek şekilde planlar ve 204 döndürür. Premium, premiumUntil tarihine kadar etkin kalır. İptal zaten planlanmışken yeniden çağırmak, Polar ile iletişim kurmadan başarılı olur. İade yapılmaz.

Yanıt¶

Hız sınırı¶

premium:cancel-subscription kovasında kullanıcı başına dakikada 5 istek.

Premium'u iptal et¶

POST /premium/cancel

TEBHOS istemcisinin kullandığı daha kapsamlı bir iptal işlemi. 204 yerine güncellenmiş Premium durum nesnesini (premiumWillCancel true olarak) döndürür ve Polar aboneliğinden gelmeyen Premium için de çalışır:

• Polar aboneliği varsa Aboneliği iptal et gibi davranır.
• Bir hediyeden veya personel tanımlamasından gelen süreli Premium varsa, üyeliği premiumUntil tarihinde bitecek şekilde işaretler.
• Bitiş tarihi olmayan ömür boyu Premium varsa, Premium hemen kaldırılır.

Hız sınırı¶

premium:cancel kovasında kullanıcı başına saatte 10 istek.

Aboneliği yeniden etkinleştir¶

POST /premium/reactivate-subscription

Çağıranın Polar aboneliğinde planlanmış bir iptali geri alır ve 204 döndürür. Planlanmış bir iptal yoksa değişiklik yapmadan 204 döndürür.

Hız sınırı¶

premium:reactivate-subscription kovasında kullanıcı başına dakikada 5 istek.

İş Sınıfını iptal et ve yeniden etkinleştir¶

POST /business/guilds/{guild_id}/cancel

POST /business/guilds/{guild_id}/reactivate

Bir sunucunun İş Sınıfı aboneliğinin dönem sonu iptalini planlar veya geri alır. Yalnızca sahip kullanabilir. Her ikisi de {"ok": true, "will_cancel": <bool>} döndürür.

Hız sınırı¶

Her ikisi business:cancel kovasında kullanıcı başına saatte 10 isteği paylaşır.

TEBHOS'ta desteklenmeyenler¶