> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zonely.gen.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# Tebex Store

> Tebex Store kurulumu: proje açma, offline platform seçimi, API anahtarları, webhook ve paket oluşturma.

![Tebex Store logosu](https://mintcdn.com/zonely-a8cd49e7/i3mjCogPxbz3Aug9/images/doc-icons/odemeler--tebex-store.png?fit=max\&auto=format\&n=i3mjCogPxbz3Aug9\&q=85\&s=3161409cbc72fbe6a8ef30f0117f0fab)

Bu sayfa, Tebex Store üzerinden kredi satmak için gereken adımları basit bir şekilde anlatır. Tebex Store eklentisi, sitenizdeki yerel kredi yükleme ekranının yerini alarak ürün ve bakiye satışlarını doğrudan Tebex altyapısına bağlar.

> [!NOTE]
>
> **Önemli:** Tebex Store modülü aktif edildiğinde, yönetim panelindeki klasik kredi paketleri ekranı devre dışı kalır ve yerini Tebex Store alır. Kredi ürünleri artık yerel paketlerden değil, doğrudan Tebex tarafındaki paketlerden yönetilir.

## Kredi nasıl hesaplanır?

Sistemimiz kredi miktarını **paket adındaki sayıdan** alır:

* **100 Kredi** paketi = **100 kredi**
* **250 Kredi**, **500 Kredi** gibi paket adlarında kredi miktarı net belirtilmelidir.
* Paket adında sayı yoksa, ürünün satış fiyatı yedek olarak kullanılabilir. En garanti yol, paket adına net bir sayı yazmaktır.

***

## 1. Zonely'de Tebex Store modülünü aktif edin

Yönetim panelinden:
**Ayarlar → Eklentiler → Tebex Store**

Tebex Store modülünü aktif edin ve ayarlar ekranına geçiş sağlayın.

***

## 2. Tebex.io üzerinde proje oluşturun

1. [Tebex Creator Panel](https://creator.tebex.io)'e giriş yapın ve **Create a Project** (Yeni Proje) başlatın.
2. **Project Name** alanına sunucu adınızı yazın.
3. **Currency** alanından varsayılan para birimini (örn. USD) seçin.
4. **Your Project** bölümünden **I operate a game server** seçeneğini işaretleyin.
5. Kullanıcı sözleşmesini onaylayarak devam edin.

[![Project Name, Currency, Your Project (I operate a game server)](https://mintcdn.com/zonely-a8cd49e7/8s1ntpbF9dxcCKzV/images/panel/tebex-store-20261028/tebex-01-create-project.png?fit=max\&auto=format\&n=8s1ntpbF9dxcCKzV\&q=85\&s=0370628ba99de2b57201d45a1872691b)](https://docs.zonely.gen.tr/images/panel/tebex-store-20261028/tebex-01-create-project.png)

> [card] 1. Project Name
>
> Sunucu adınızı yazın.

> [card] 2. Currency
>
> Raporlama ve satış para birimini belirleyin.

> [card] 3. Your Project
>
> 'I operate a game server' seçeneğini işaretleyin.

***

## 3. Oyun ve platform seçimi (Önemli: Offline Mod)

Oyun listesinden **Minecraft**'ı seçin.

[![Minecraft Seçimi](https://mintcdn.com/zonely-a8cd49e7/8s1ntpbF9dxcCKzV/images/panel/tebex-store-20261028/tebex-02-server-selection.png?fit=max\&auto=format\&n=8s1ntpbF9dxcCKzV\&q=85\&s=e59e36ee916a99a6b5266fb060ebb77a)](https://docs.zonely.gen.tr/images/panel/tebex-store-20261028/tebex-02-server-selection.png)

> [card] 1. Minecraft Seçimi
>
> Oyun sunucusu listesinden Minecraft kutucuğuna tıklayın.

### Platform seçimi: Minecraft Offline

> [!WARNING]
>
> **Kritik Adım:** Sunucu platformu ekranında mutlaka **Minecraft Offline** seçilmelidir!
> Standart "Minecraft: Java Edition" seçilirse Tebex oyuncunun kullanıcı adını Mojang/Microsoft satın alınmış orijinal kopyası üzerinden doğrulamaya çalışır. Oyuncularınızın premium hesap zorunluluğu yoksa veya siteye oyun içi farklı bir isimle kayıt olmuşlarsa, Tebex kullanıcı adını doğrulayamaz ve ödeme başarısız olur.
> **Minecraft Offline** seçildiğinde orijinal kopya doğrulaması kalkar; her türlü kullanıcı adı ve çapraz platform (Bedrock/Geyser) girişleri sorunsuz kabul edilir.

[![Minecraft Offline Platformu, Continue Düğmesi](https://mintcdn.com/zonely-a8cd49e7/8s1ntpbF9dxcCKzV/images/panel/tebex-store-20261028/tebex-03-minecraft-offline.png?fit=max\&auto=format\&n=8s1ntpbF9dxcCKzV\&q=85\&s=78adc3da514e3f967154101cf6f9dbd6)](https://docs.zonely.gen.tr/images/panel/tebex-store-20261028/tebex-03-minecraft-offline.png)

> [card] 1. Minecraft Offline Platformu
>
> Platform listesinden mutlaka Minecraft Offline seçeneğini işaretleyin.

> [card] 2. Continue Düğmesi
>
> Seçimi onaylayıp sonraki adıma geçmek için Continue butonuna tıklayın.

***

## 4. Public Token, Secret Key ve Webhook URL

Tebex Creator Panel sol menüsünden **Integrations** sekmesini açın.

[![API Keys Menüsü, Webhooks Menüsü](https://mintcdn.com/zonely-a8cd49e7/8s1ntpbF9dxcCKzV/images/panel/tebex-store-20261028/tebex-04-integrations-menu.png?fit=max\&auto=format\&n=8s1ntpbF9dxcCKzV\&q=85\&s=e30197ff097c2844983f45be3de01da9)](https://docs.zonely.gen.tr/images/panel/tebex-store-20261028/tebex-04-integrations-menu.png)

> [card] 1. API Keys Menüsü
>
> API anahtarları bölümünü açın.

> [card] 2. Webhooks Menüsü
>
> Sipariş bildirim uç noktalarını yönetin.

### API anahtarlarını kopyalama

1. **Integrations → API Keys** bölümüne girin.
2. **Public Token** değerini kopyalayın ve Zonely yönetim panelindeki **Public Token** alanına yapıştırın.
3. Private Key alanında anahtar yoksa **Generate** butonuna basarak yeni bir anahtar üretin ve Zonely'deki **TEBEX Secret Key** alanına yapıştırın.

[![Private Key Üretimi (Generate), Public Token Değeri](https://mintcdn.com/zonely-a8cd49e7/A56MQuyvMF57G2la/images/panel/tebex-store-20261028/tebex-05-api-keys.png?fit=max\&auto=format\&n=A56MQuyvMF57G2la\&q=85\&s=1b33a991b5460d4e02621f1b4d5ac4f0)](https://docs.zonely.gen.tr/images/panel/tebex-store-20261028/tebex-05-api-keys.png)

> [card] 1. Private Key Üretimi (Generate)
>
> Generate butonuna tıklayarak yeni anahtar üretin ve Zonely TEBEX Secret Key alanına girin.

> [card] 2. Public Token Değeri
>
> Public Token değerini kopyalayıp Zonely Public Token alanına yapıştırın.

### Webhook URL tanımlama

1. Tebex panelinde **Integrations → Webhooks → Endpoints → Add Endpoint** butonuna tıklayın.
2. Tüm olayları seçin.
3. **Endpoint URL** bölümüne aşağıdaki bildirim adresini yazın:

```
https://siteniz.com/process/tebex_store
```

4. Kaydedin. Entegrasyon uyumunun doğrulandığını kontrol etmek için webhook bölümüne tekrar girin.

> [!WARNING]
>
> **Önemli:** Webhook doğrulanmadan sipariş bildirimi gelmez. Tebex önce test webhook'u göndererek sitenizin yanıtını doğrular.

***

## 5. Kredi paketini oluşturun

1. Tebex panelinde **Packages** bölümüne girin.
2. **Add New → Package** seçeneğini tıklayın.
3. Paket adını kredi miktarıyla birlikte yazın:
   * `100 Kredi`
   * `250 Kredi`
   * `500 Kredi`
4. Fiyat, açıklama, kategori ve görsel bilgilerini doldurun.
5. **Create** ile kaydedin.

> [!TIP]
>
> Paket adına kredi miktarını net bir sayı olarak yazmanız gerekir (`100 Kredi` gibi). Sistem bu sayıyı otomatik olarak okuyup kullanıcı hesabına kredi olarak ekler.

***

## 6. Deliverable hatası alırsanız

Paket oluştururken bazen **deliverable** uyarısı verebilir. Bu uyarı üstteki webhook URL'sinin henüz doğrulanmadığını gösterir.

Böyle bir uyarı alırsanız:

1. Önce **API Keys** ve **Webhook validation** adımlarını tamamlayın.
2. Webhook doğrulaması başarılı olduktan sonra paketi tekrar kaydedin.
3. Kredi yükleme paketleri için Tebex tarafında oyun içi komut (deliverable) eklemenize gerek yoktur; sistem webhooks üzerinden krediyi otomatik yükler.

***

## 7. Canlı (Live) satışa geçiş ve Tebex onay adımları

Tebex projenizi oluşturduktan sonra yönetim panelinin üst kısmında bir onboarding uyarı bildirimi yer alır:

![Tebex Onboarding Bildirimi](https://mintcdn.com/zonely-a8cd49e7/A56MQuyvMF57G2la/images/panel/tebex-store-20261028/tebex-06-onboarding-banner.png?fit=max\&auto=format\&n=A56MQuyvMF57G2la\&q=85\&s=99b01dfc85e447966d3f0d8073619710)

> **Continue onboarding:** *You can only checkout using test payment methods until your project is setup & approved by our Content and Safety team.*
> Mağazanız Tebex Content and Safety ekibi tarafından incelenip onaylanana kadar yalnızca test ödeme yöntemleri aktiftir. Gerçek oyuncu ödemelerini alabilmek (Live moda geçmek) için **Before you can go live** adımlarının tamamlanması gerekir.

[![Configure product delivery (Webhook - Tamamlandı), Create a package (Kredi Paketi - Tamamlandı), Confirm customer support contact (Destek E-postası), Link Wallet (Cüzdan / Tahsilat Hesabı), Create your storefront (Mağaza Vitrini)](https://mintcdn.com/zonely-a8cd49e7/A56MQuyvMF57G2la/images/panel/tebex-store-20261028/tebex-07-before-you-can-go-live.png?fit=max\&auto=format\&n=A56MQuyvMF57G2la\&q=85\&s=08d6b78cf3edac36e790686322dacceb)](https://docs.zonely.gen.tr/images/panel/tebex-store-20261028/tebex-07-before-you-can-go-live.png)

> [card] 1. Configure delivery (Tamamlandı)
>
> **Zaten Yapıldı:** 4. adımda `https://siteniz.com/process/tebex_store` webhook bağlantısı eklenerek teslimat ayarı tamamlanmıştır.

> [card] 2. Create package (Tamamlandı)
>
> **Zaten Yapıldı:** 5. adımda sitenizle uyumlu kredi paketleri (`100 Kredi` vb.) oluşturulmuştur.

> [card] 3. Support Contact (Gerekiyor)
>
> **Go to Checkout Settings** bağlantısına tıklayın ve oyuncularınızın size ulaşabileceği resmî destek e-posta adresinizi doğrulayın.

> [card] 4. Link Wallet (Gerekiyor)
>
> **Link Wallet** butonuna basarak satış gelirlerinizin aktarılacağı banka veya ödeme cüzdanı yönteminizi bağlayın.

> [card] 5. Create Storefront (Gerekiyor)
>
> **Go to Storefront** ile mağaza vitrin görünümünüzü başlatın veya kaydedin.

> [!NOTE]
>
> **Onay Süreci:** Destek e-postası, cüzdan ve vitrin adımlarını tamamladığınızda projeniz Tebex Content and Safety ekibinin onay kuyruğuna alınır. İnceleme onaylandığında üstteki test modu uyarısı kalkar ve Tebex Store doğrudan gerçek ödemelerle canlı (Live) olarak çalışmaya başlar.

Kurulum tamamlandı. Artık Tebex Store ile kredi satışı yapabilir ve siparişlerin otomatik tamamlanmasını sağlayabilirsiniz.

[Tebex Checkout](https://docs.zonely.gen.tr/payments/tebex-checkout.md) · [Ödeme yöntemleri genel bakış](https://docs.zonely.gen.tr/payments/overview.md) · [Siparişler](https://docs.zonely.gen.tr/guides/orders.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.