# WHMCS Entegrasyonu

Onoxsoft Panel, WHMCS ile native server module üzerinden entegrasyon sağlar. Hesap oluşturma, askıya alma, sonlandırma ve paket değiştirme işlemleri WHMCS'den otomatik tetiklenir.

## WHMCS Server Module Kurulumu

1. [GitHub Releases](https://github.com/onoxsoft/panel/releases)'dan `whmcs-onox-module.zip` indirin
2. WHMCS sunucunuzda `modules/servers/onox/` dizinine çıkartın
3. WHMCS Admin > **Setup > Products/Services > Servers > Add New Server**

### Sunucu Ayarları

| Alan | Değer |
|------|-------|
| Name | Onoxsoft Production |
| Hostname | panel.yourdomain.com |
| Username | (boş bırakın) |
| Password | (boş bırakın) |
| Access Hash | Onoxsoft API token'ınız |
| Secure | ✅ Etkin (HTTPS) |
| Module | Onoxsoft |

## Ürün Yapılandırması

WHMCS ürünü için **Module Settings** sekmesi:

| WHMCS Alanı | Onoxsoft Karşılığı |
|-------------|----------------|
| Package Name | `silver` (paket slug) |
| PHP Version | `8.3` |
| Welcome Email | WHMCS e-posta şablonu |

## Desteklenen Modül Fonksiyonları

| Fonksiyon | Açıklama |
|-----------|----------|
| `CreateAccount` | Yeni hosting hesabı oluşturur |
| `SuspendAccount` | Hesabı askıya alır |
| `UnsuspendAccount` | Askıyı kaldırır |
| `TerminateAccount` | Hesabı siler |
| `ChangePackage` | Paket yükseltme/düşürme |
| `ChangePassword` | Kontrol paneli şifresini değiştirir |
| `LoginLink` | SSO ile panele tek tıkla giriş |
| `ClientArea` | WHMCS müşteri alanında mini panel |
| `TestConnection` | API bağlantısını test eder |

## SSO (Single Sign-On)

Müşteri WHMCS'deki **Login to Control Panel** butonuna tıklayınca otomatik olarak Onoxsoft Panel'e giriş yapılır.

Onoxsoft SSO API:

```bash
POST /api/v1/sso/token
Authorization: Bearer onox_live_xxxxx
Content-Type: application/json

{
    "username": "musteri_hesabi",
    "redirect": "/customer/dashboard"
}
```

Yanıt:
```json
{
    "success": true,
    "data": {
        "sso_url": "https://panel.yourdomain.com/sso/abc123xyz?expires=1748808060"
    }
}
```

## Test Bağlantısı

WHMCS Admin > Servers > Onoxsoft → **Test Connection** — `Connection Successful` mesajı görünmeli.

---

*Bu sayfa geliştirilmekte. WHMCS addon entegrasyonu ve fatura sync kılavuzları eklenecek.*
