Geliştirici sözleşmesi

Yol haritası

Platform satış, alan adı kaydı ve ödemeyi yönetir. Şablon uygulaman, veritabanın ve panelin sende kalır.

1. Başvuru ve onay

1. /is-ortakligi üzerinden başvur.
2. Onay sonrası /ortak panelinden ürün ekle.
3. Ürünü incelemeye gönder; platform ödeme varyantını bağlayıp yayına alır.

2. Kurulum bildirimi

Satış sonrası platform, ayarladığın adrese imzalı bir POST gönderir. Sen müşteri kaydını oluşturur, alan adını kendi barındırmana eklersin.

POST /senin-kurulum-adresin
Headers:
  Content-Type: application/json
  X-Tunahanipek-Timestamp: <unix_saniye>
  X-Tunahanipek-Signature: <hmac_sha256_hex>
  X-Tunahanipek-Event-Id: <benzersiz_id>

Body:
{
  "event": "tenant.provisioned",
  "event_id": "...",
  "tenant_id": "...",
  "slug": "firma",
  "primary_host": "firma.ornek.com.tr",
  "catalog_product_id": "...",
  "owner_email": "musteri@ornek.com",
  "partner_id": "..."
}

İmza: HMAC-SHA256(gizli_anahtar, "timestamp.body") — hex. Zaman damgası ±5 dakika. Aynı event_id için işlemi bir kez uygula. Başarılı yanıt: HTTP 200; isteğe bağlı {"panel_url":"https://..."}.

3. DNS

Platform, müşteri alt alan adını senin verdiğin CNAME hedefine yönlendirir (varsayılan Vercel DNS). Alan adını kendi projenine sen eklersin.

4. Komisyon

Müşteri ödemesi − ödeme sağlayıcı kesintileri = net. Net × platform komisyonu = platform payı. Kalan bakiyene yazılır; IBAN ile ödenir.

5. Kontrol listesi

• Çoklu müşteri (Host → kayıt) desteği
• Kurulum bildirimi + imza doğrulama
• Canlı önizleme adresi
• Panel / ayarlar / IBAN
• İdempotent event_id işleme

Repo içi ayrıntı: docs/partner-byo-contract.md