> ## 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.

# Paddle

> Paddle Billing hesabınızı bağlayın; ürün, ödeme penceresi ve webhook ayarlarını hazırlayın.

![Paddle logosu](https://mintcdn.com/zonely-a8cd49e7/RhT7oGMq-hyCnspk/images/payments/merchant-providers-20261028/paddle.png?fit=max\&auto=format\&n=RhT7oGMq-hyCnspk\&q=85\&s=21ab32157f5b7d4233669ae9cfe4d085)

Paddle Billing ile tek seferlik ödeme alabilirsiniz. Ödeme penceresi Paddle tarafından açılır ve müşterinin satış faturasını Paddle düzenler. Canlı kullanım için hesabınızı, site adresinizi ve sattığınız ürünleri Paddle’a onaylatın.

> [!NOTE]
>
> `transaction_checkout_not_enabled` hatası, Paddle hesabınızda Checkout özelliğinin henüz açılmadığını gösterir. Paddle panelinden hesap doğrulama durumunu kontrol edin ve canlı onboarding adımlarını tamamlayın.

## MoR (Merchant of Record) Modeli ve Güvencesi

Paddle Billing, dünyanın önde gelen kurumsal **Kayıtlı Satıcı (Merchant of Record - MoR)** altyapılarından biridir:

* **Resmi Satıcı Paddle.com'dur:** Oyuncunuz kredi veya ürün aldığında, satış faturasını doğrudan Paddle.com Market Ltd. düzenler. Alıcının ülkesine göre KDV (VAT) ve Sales Tax kesintilerini kendi tüzel kişiliği üzerinden ilgili ülkenin maliyesine iletir.
* **Bireysel Geliştiriciler İçin Kolaylık:** Sunucu sahibinin her satış için tek tek e-fatura kesmesi veya şirket kurması gerekmez.
* **Yerel Mali Risklerden Korunma:** Şirketsiz ödeme imkanı sunduğunu belirten **diğer yerli MoR sağlayıcıları**, Türk vergi sistemine (VUK) ve MASAK takibine doğrudan tabidir. Sürekli oyun gelirleri kanunen "süreklilik arz eden ticari kazanç" sayıldığından, yerli bir aracı firmadan gider pusulası veya IBAN transferiyle düzenli para almak, ileride Maliye tarafından geriye dönük vergi ziyaı cezası, faiz ve KDV tarhiyatı çıkarılması riskini taşır. Paddle ise kurumsal MoR yapısıyla geliri uluslararası hizmet ve yazılım transferi statüsünde tutarak yerel denetim risklerinin önüne geçer.

## Kayıttaki alanlar

| Zonely alanı | Girilecek bilgi |
| - | - |
| **API Key** | Canlı hesabınızın `pdl_live_apikey_` ile başlayan sunucu API anahtarı. |
| **Product ID** | Ürünün `pro_` ile başlayan kimliği. Price ID kullanılmaz. |
| **Webhook Secret** | Paddle bildirim bağlantısının `pdl_ntfset_` ile başlayan Secret key değeri. |
| **Client-side Token** | Canlı hesabınıza ait `live_` ile başlayan tarayıcı anahtarı. |
| **Environment** | Gerçek tahsilat için **Live** seçin. |

[![API Key, Product ID, Webhook Secret, Client-side Token, Environment](https://mintcdn.com/zonely-a8cd49e7/vqU0BjGNyRJAfyxV/images/panel/payments-connections-site-guide-20261027/pay-paddle.png?fit=max\&auto=format\&n=vqU0BjGNyRJAfyxV\&q=85\&s=23cdfc25010e695e3090090715c3f7e4)](https://docs.zonely.gen.tr/images/panel/payments-connections-site-guide-20261027/pay-paddle.png)

> [card] 1. API Key
>
> Canlı hesabınızın pdl\_live\_apikey\_ anahtarını girin.

> [card] 2. Product ID
>
> Ürünün pro\_ ile başlayan kimliğini girin.

> [card] 3. Webhook Secret
>
> Paddle bildirim bağlantısının pdl\_ntfset\_ Secret key değerini girin.

> [card] 4. Client-side Token
>
> Canlı hesabınıza ait live\_ ile başlayan Client-side Token'ı girin.

> [card] 5. Environment
>
> Gerçek tahsilat için Live seçin.

> [!NOTE]
>
> Paddle üzerinde canlı (live) ve test (sandbox) ortamlarının ürünleri, bildirim adresleri ve API anahtarları tamamen birbirinden bağımsızdır. Gerçek tahsilat yapabilmek için tüm adımların canlı Paddle yönetim panelinde tamamlandığından ve Zonely panelinde **Live** ortamının seçildiğinden emin olun.

## 1. Varsayılan Ödeme Bağlantısını (Default Payment Link) Tanımlama

Paddle ödeme penceresinin sitenizle eşleşebilmesi için varsayılan alan adını tanımlayın:

1. Paddle sol menüsünden **Checkout** başlığını açıp **Checkout configuration** sayfasına geçin.

[![Checkout → Checkout configuration Menüsü](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-01a-checkout-config.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=8aaafa45d53b24c51f2cfb4147c7ee0c)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-01a-checkout-config.png)

> [card] 1. Checkout configuration
>
> Sol menüden Checkout configuration sayfasını açın.

2. **Settings** sekmesinde yer alan **Default payment link** alanına sitenizin bildirim adresini girip **Save** ile kaydedin:
   ```txt theme={"theme":"css-variables"}
   https://siteniz.com/process/paddle
   ```

[![Default payment link (https://siteniz.com/process/paddle) ve Save Butonu](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-01b-default-payment-link.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=140f2717d8e3f0bc4a6ac42121a29cd7)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-01b-default-payment-link.png)

> [card] 1. Default payment link
>
> `https://siteniz.com/process/paddle` adresini kaydedin.

## 2. Canlı API Anahtarı ve Client-side Token Alma

Sitenizin Paddle API'si ile haberleşebilmesi ve ödeme penceresini açabilmesi için anahtar ve token değerlerinizi hazırlayın:

1. Paddle sol menüsünün en altındaki **Settings** bölümünü açın ve **DEVELOPER TOOLS** altındaki **Authentication** sekmesine tıklayın.

[![DEVELOPER TOOLS → Authentication Menüsü](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-02-authentication-menu.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=cd018fa05240bfe273d2ed62002df8d5)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-02-authentication-menu.png)

> [card] 1. Authentication
>
> Settings altında Developer Tools → Authentication sayfasına geçin.

2. Sayfada **New API key** butonuna tıklayın.
3. Açılan formda anahtarınıza bir isim verin (örn. `Zonely`).
4. **Expires at** alanında anahtarın süresiz aktif kalabilmesi için **Never expires** seçeneğini seçin.

[![Name (Zonely), Expires at (Never expires)](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-03-new-api-key.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=59ee971ac32a1d1bb414b4362b9ed786)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-03-new-api-key.png)

> [card] 1. Anahtar Adı
>
> Anahtarınıza Zonely adını verin.

> [card] 2. Never expires
>
> Süresiz geçerlilik için Never expires seçin.

5. **Permissions** bölümünde **All** grubunu bulun. Sitenizin ödeme başlatabilmesi ve siparişleri doğrulayabilmesi için **Read** ve **Write** izinlerinin her ikisini de işaretleyin ve anahtarı kaydedin.

[![Permissions (All), Yetkiler (Read and write)](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-04-permissions-all.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=7a3edd2d99d401208a3a5dcee4483aba)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-04-permissions-all.png)

> [card] 1. Yetki Grubu: All
>
> All yetki satırını seçin.

> [card] 2. Read & Write
>
> Read ve Write kutucuklarının ikisini de işaretleyerek kaydedin.

6. Ekrana gelen pencereden canlı API anahtarını (`pdl_live_apikey_...`) kopyalayın ve Zonely yönetim panelinizdeki **API Key** alanına yapıştırın.

[![Canlı API Anahtarını Kopyala (pdl\_live\_apikey\_...)](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-05-copy-api-key.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=7bb3efb48bc8ae0247e02eb54b6d07ef)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-05-copy-api-key.png)

> [card] 1. API Key Kopyala
>
> `pdl_live_apikey_` ile başlayan anahtarı kopyalayarak panele yapıştırın.

7. **Authentication** sayfasında üst sekmelerden **Client-side tokens** sekmesine tıklayın.

[![Client-side tokens Sekmesi](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-06-client-side-token.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=aa88f749f8f02431ccbc4eb36657e344)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-06-client-side-token.png)

> [card] 1. Client-side tokens
>
> Üst sekmelerden Client-side tokens alanına geçin.

8. Listedeki aktif tokenin sağındaki üç nokta (`...`) menüsünü açıp **Copy token** butonuna tıklayın. Kopyaladığınız `live_` ile başlayan tarayıcı anahtarını Zonely yönetim panelinizdeki **Client-side Token** alanına yapıştırın.

[![Copy token Seçeneği ile Canlı Tokeni Kopyalama](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-06b-copy-token.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=f10c244172a14a9370117f9a315ac6ba)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-06b-copy-token.png)

> [card] 1. Copy token
>
> Üç nokta menüsünden Copy token seçeneğiyle canlı tokeni kopyalayın.

## 3. Ürün Oluşturma ve Product ID Değerini Alma

Paddle altyapısında ödeme başlatabilmek için bir ürün oluşturulmalı ve bu ürünün kimliği (**Product ID**) alınmalıdır:

1. Sol menüdeki **Catalog** başlığı altından **Products** sekmesine tıklayın.

[![Catalog Menüsü ve Products Sekmesi](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-07-catalog-products.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=fa256e2b31d2224198385f9e8d5626be)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-07-catalog-products.png)

> [card] 1. Products Menüsü
>
> Sol menüden Catalog → Products sayfasına geçin.

2. Sağ üst köşedeki **+ New product** butonuna tıklayın.
3. Açılan formda ürün bilgilerini doldurun:
   * **Product name:** Ürün adını girin (örn. `Kredi`).
   * **Tax category:** Dijital ürünler için `Standard digital goods` kategorisini seçin.

[![Product name (Kredi), Tax category (Standard digital goods)](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-08-new-product.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=91f2c7b0d3ccc26e9685d8ecdb3a02d5)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-08-new-product.png)

> [card] 1. Product name
>
> Ürün adını `Kredi` olarak girin.

> [card] 2. Tax category
>
> `Standard digital goods` kategorisini seçin.

4. **Save** butonuna basarak ürünü kaydedin.

[![Ürünü Kaydetmek İçin Save Butonu](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-08b-save-product.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=23ab87725950a4dff77206d1f2739f16)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-08b-save-product.png)

> [card] 1. Save
>
> Ürünü kaydetmek için Save butonuna tıklayın.

5. Oluşturulan ürünün detay sayfasında başlığın hemen altında yer alan `pro_` ile başlayan **Product ID** değerini kopyalayın ve Zonely yönetim panelindeki **Product ID** kutusuna yapıştırın.

[![Product ID (pro\_...) Kopyalama](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-09-product-id.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=9a6f5647a3b67e782c0333972dbc53f8)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-09-product-id.png)

> [card] 1. Product ID Kopyala
>
> `pro_` ile başlayan ürün kimliğini kopyalayın.

## 4. Webhook Bildirimlerini Yapılandırma

Ödemelerin sitenize anlık olarak aktarılması için Paddle panelinde webhook kaydı açın:

1. Paddle sol menüsünde yer alan **Events** başlığı altındaki **Notifications** sekmesine tıklayın.

[![Events Menüsü ve Notifications Sekmesi](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-10-notifications-menu.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=9e74965ab72d3eb62d766ade9a13bf51)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-10-notifications-menu.png)

> [card] 1. Notifications
>
> Events menüsü altından Notifications sekmesini açın.

2. Açılan sayfada **New destination** butonuna tıklayın.
3. Bildirim ayarlarını doldurun:
   * **Notification type:** **Webhook** seçeneğini işaretleyin.
   * **URL:** Sitenizin bildirim adresini girin:
     ```txt theme={"theme":"css-variables"}
     https://siteniz.com/process/paddle
     ```
   * **Description:** Bu hedef için bir tanım yazın (örn. `Server`).

[![Notification type (Webhook), Endpoint URL (https://siteniz.com/process/paddle), Description](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-11-new-destination.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=831bcf87d192c7bfff1a092a27dded10)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-11-new-destination.png)

> [card] 1. Bildirim Türü
>
> Webhook seçeneğini işaretleyin.

> [card] 2. Endpoint URL
>
> `https://siteniz.com/process/paddle` adresini yazın.

> [card] 3. Description
>
> Sunucunuz için bir açıklama girin.

4. **Usage type** menüsünden **Platform** seçin.
5. **Events** bölümünde sitenizin ödeme tamamlanma ve hesap hareketlerini eksiksiz yakalayabilmesi için **All** kutucuğunu işaretleyin ve hedefi kaydedin.

[![Usage type (Platform), Events (All)](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-12-events-all.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=c84d38e41f63aa0b95ca692386bf242c)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-12-events-all.png)

> [card] 1. Usage type
>
> Platform seçeneğini belirleyin.

> [card] 2. All
>
> Tüm bildirim olaylarını almak için All kutucuğunu işaretleyin.

6. Oluşturulan webhook hedefine tıklayıp **Edit** seçeneğine girin.
7. Açılan pencerede `pdl_ntfset_` ile başlayan **Secret key** değerini kopyalayın ve Zonely yönetim panelindeki **Webhook Secret** kutusuna yapıştırın.

[![Secret key (pdl\_ntfset\_...)](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-13-secret-key.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=a91bd0cb43a1b3e6245047a87f413f16)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-13-secret-key.png)

> [card] 1. Secret key
>
> `pdl_ntfset_` ile başlayan anahtarı kopyalayarak Webhook Secret alanına yapıştırın.

## Ödeme bildirimini bağlayın

Ödeme kaydını **Düzenle** ile açıp **Callback URL** adresinin tamamını kopyalayın. Paddle’da oluşturduğunuz bildirim bağlantısının URL alanını bu tam adresle güncelleyin. Bağlantının **Secret key** değeri Zonely’de **Webhook Secret** alanında kayıtlı olmalıdır.

> [!TIP]
>
> **API Key** ile **Client-side Token** farklıdır. Tarayıcı anahtarı alanına sunucu API anahtarını yazmayın. Yönetim panelindeki **Bağlantıyı Test Et** butonu ürün ve API erişimini doğrular.

Bu bağlantı tek seferlik tahsilat içindir. Ödeme tutarı siparişe göre ve vergi dahil hazırlanır. Tamamlanan ödemeleri **Mağaza → Ödemeler** bölümünden takip edebilirsiniz.

[Ödemeler](https://docs.zonely.gen.tr/guides/payments.md)


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