Geliştirici paketi: alt hesaplar

Geliştirici paketi, müşterileriniz adına ayrı hesaplar (alt hesap) açıp bu hesaplarda fatura kesmenizi sağlar. Her alt hesabın kendi müşterileri, ürünleri, fatura hesapları, satış kanalları ve API anahtarı olur. Fatura ve yapay zeka hakları ise tek bir yerde, sizin (ana hesabın) planınızda toplanır.

Yalnızca Geliştirici paketlerinde

Bu bölümdeki uçlar yalnızca Geliştirici paketindeki ana hesabın API anahtarıyla çalışır. Diğer paketlerde 403 döner:

{
  "message": "Bu özellik yalnızca Geliştirici paketlerinde hesap yöneticilerine açıktır.",
  "errors": { "api_error": ["Bu özellik yalnızca Geliştirici paketlerinde hesap yöneticilerine açıktır."] }
}

Ana hesap ve alt hesap

	Ana hesap	Alt hesap
Ne işe yarar	Alt hesapları açar, yönetir, kontör dağıtır. Fatura kesmez.	Müşteriniz adına fatura, irsaliye ve sipariş işlemlerini yürütür.
Paket	Satın aldığınız Geliştirici paketi.	Otomatik atanan Geliştirici Alt Hesabı paketi. Kendi fatura/yapay zeka hakkı yoktur.
Fatura ve yapay zeka hakkı	Tüm alt hesapların kullanımı buradan düşer.	Her fatura, gelen fatura/irsaliye aktarımı ve yapay zeka kullanımı ana hesabın hakkından düşer.
Paket süresi	Paketin bitiş tarihi tüm alt hesaplar için geçerlidir.	Ana hesabın paketi biterse alt hesaplar da fatura kesemez.
Limitler	Paketinizdeki limitler.	Fatura hesabı sayısı sınırsızdır; satış kanalı ve mobil cihaz alt hesap başına en fazla 10'dur.

Alt hesap sayısında bir sınır yoktur. Alt hesaplar silinemez.

Profil ucu alt hesapta çağrıldığında plan alanında ana hesabın planı ve kalan hakları döner.

Panelde ana hesap

Panelde ana hesap ayrı bir Geliştirici Paneli olarak açılır: Alt Hesaplar, Kontör, API, plan ve ödeme sekmeleri vardır. Fatura listeleri ve gelen/giden ekranları ana hesapta yoktur; bu ekranlara alt hesabın satırındaki Hesaba Geç ile alt hesaba geçerek ulaşırsınız. Ana hesaptaki tüm yöneticiler alt hesaplara otomatik erişir.

Alt hesap adına istek göndermek

Her alt hesap açılırken kendi API anahtarı üretilir. Anahtarı alt hesap oluşturma yanıtındaki veya alt hesap listesindeki api_key alanından alırsınız. Alt hesap adına yapılacak tüm istekler (fatura, irsaliye, sipariş, müşteri, ürün, fatura hesabı, satış kanalı, yardımcılar) bu anahtarla gönderilir:

POST /api/invoices
Accept: application/json
Authorization: Bearer ALT_HESAP_API_KEY
Content-Type: application/json

İstek hangi anahtarla gelirse o hesapta çalışır; haklar her durumda ana hesaptan düşer. Birden çok alt hesabı yönetiyorsanız her alt hesabın id ve api_key değerini kendi sisteminizde eşleştirerek saklayın. Anahtarı müşterinizin kendi sistemine (örn. e-ticaret eklentisine) de tanımlayabilirsiniz.

Alt hesabın anahtarını yenilemek için panelde alt hesaba geçip API sayfasını kullanın. Eski anahtar hemen geçersiz olur.

Ana hesap uçları ana hesabın anahtarıyla çağrılır

Alt hesap ve kontör uçları ana hesaba aittir ve yalnızca ana hesabın anahtarıyla çalışır. Alt hesabın anahtarıyla çağrılırsa 403 döner: "Alt hesaplar yalnızca ana geliştirici hesabından yönetilebilir." Ana hesabın anahtarıyla gönderilen fatura istekleri ise alt hesapta değil ana hesapta çalışır; faturaları her zaman alt hesabın anahtarıyla gönderin.

Tipik akış

1. Ana hesabın anahtarıyla POST /api/sub-accounts çağırıp müşteriniz için alt hesap açın; yanıttaki id ve api_key değerlerini saklayın.
2. Alt hesabın anahtarıyla POST /api/integrations/invoice çağırıp alt hesaba fatura hesabı ekleyin. Fatura hesabı yönetimi uçları alt hesaplarda da açıktır.
3. Faturaları alt hesabın anahtarıyla POST /api/invoices üzerinden kesin.
4. Alt hesap e-Faturam kullanıyorsa ana hesabın anahtarıyla kontör havuzunuzdan alt hesaba kontör yükleyin.

e-Faturam başvurusu

Alt hesabın e-Faturam başvurusu API'den yapılamaz. Panelde alt hesaba geçip başvuruyu oradan tamamlayın; onaylandığında alt hesaba kontör yükleyebilirsiniz.